Compose MSNA Indicators • humind

humind provides functions to compose common humanitarian composite indicators related to IMPACT Multi-Sector Needs Assessments (MSNAs), including:

MSNI framework indicators: sectoral composites, MSNI metrics, and all required recoding
Food security indicators: rCSI, LCSI, HHS, FCS
WASH indicator recoding to JMP classifications

The package follows the Step – Composition approach of the IMPACT R framework.

Installation

Install the latest tagged release from GitHub:

# install.packages("devtools")
devtools::install_github("impact-initiatives-hppu/humind@v2026.4.0")

Verify the version:

packageVersion("humind")
# v2026.4.0

📚 MSNI Guidance Note 2026

The MSNI Guidance Note is available on the IMPACT Intranet here, which provides essential background on the MSNI framework and sector-specific guidance. Each sector includes a “Humind Data Workflow” describing required steps and the relevant humind functions.

⚠️ Read the Guidance Note thoroughly—especially the Data Workflow sections—before implementing analyses with humind.

📖 Programmatic Changes & Breaking Changes

See the full changelog for per-release programmatic (indicator/framework) changes and breaking changes:

On GitHub: NEWS.md
On the documentation website: Changelog

📌 Issues and Feedback

Choose the appropriate template when opening an issue:

🐛 Bug report – Reproducible errors or unexpected behavior.
🧮 Indicator Logic Change – Add, update, or fix logic for indicators, scoring, or categorization.
✨ Feature request – Suggest new features or enhancements.
📖 Documentation request – Report incorrect, missing, or unclear documentation.

Not sure where it fits?
Open a blank issue with as much detail as possible.

⚠️ Known Issues

GitHub Credentials Error When Installing with devtools

When installing with devtools::install_github(), you may encounter:

> devtools::install_github("impact-initiatives-hppu/humind@v2026.4.0")
...
Error : Failed to install 'unknown package' from GitHub:
  HTTP error 401.
  Bad credentials

This is typically caused by outdated or incorrect GitHub credentials stored in R. Public repositories do not require credentials. To resolve:

library(gitcreds)
gitcreds_delete()

Then retry the installation.

License

humind is released under the MIT License.