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.

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

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")
install.packages("HIViz", repos = c('https://atefehrashidi.r-universe.dev', 'https://cloud.r-project.org'))

or

# install.packages("remotes")
# remotes::install_github("AtefehRashidi/HIViz")
install.packages("HIViz", repos = c('https://atefehrashidi.r-universe.dev', 'https://cloud.r-project.org'))

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.