📊 HIViz

An R package for interactive visualization and exploration of key HIV/AIDS indicators, including prevalence, incidence, mortality, and treatment coverage, via a Shiny dashboard.

CRAN Monthly downloads Total downloads License

📁 Required Dataset Structure

The input dataset must include the following columns with exact names:

• country: (e.g., Iran, Spain)
• year: Numeric year (e.g., 2010, 2021)
• sex: Gender classification (e.g., Male, Female)
• age_group: Age brackets (e.g., 15–24, 25–34)
• hiv_prevalence: Estimated HIV prevalence (%)
• hiv_incidence: Number of new HIV cases
• aids_deaths: AIDS-related deaths
• plhiv: People living with HIV
• art_coverage: ART (antiretroviral therapy) coverage rate
• testing_coverage: HIV testing coverage (%)
• causes: Categorical variable describing cause of transmission (e.g., unprotected sex, drug use, mother-to-child)

All column names must be spelled exactly as listed. The causes column should contain clear, human-readable labels for transmission modes.

Installation

The development version of the ‘HIViz’ package is available for installation. You can install it from Github using:

 # install.packages("remotes")
remotes::install_github("AtefehRashidi/HIViz")

Installation

You can install the development version of HIViz from GitHub with:

 # install pak if not installed:
 install.packages("pak")
 
 # then install HIViz from GitHub:
pak::pak("AtefehRashidi/HIViz")

Then run the Shiny App with:

HIViz::launchApp()

You can test the dashboard with the built-in sample_data.

🤝 Contributing

Issues and pull requests are welcome. Please open an issue to report bugs or suggest enhancements.