Interactive Dashboard for 'HIV' Data Visualization.
📊 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
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.