Age and gender-stratified HIV report¶
The age- and gender-stratified HIV report is a CSV-formatted output file which provides information about population size, HIV prevalence, new infections, and mortality in 1-year age bins and semi- annual time bins. This output file is formatted as categories with aggregated counts of individuals. The file name is ReportHIVByAgeAndGender.csv.
This report is information-rich, and highly configurable. There are numerous associated parameters available to modify the information provided by the report. For example, Report_HIV_ByAgeAndGender_Start_Year and Report_HIV_ByAgeAndGender_Stop_Year can be used to configure the time to start and stop logging simulation data. See Output settings for more information on the types of data that can be collected with this report, and the modifications that can be made.
Some values, such as population size or number infected, are reported as single “snapshots” in time, so every other row of output data can be dropped to provide mid-year or end-year prevalence estimates. Other values, such as deaths or new infections, are accumulated from the previous interval to the next. For those values, output rows can be summed in pairs to provide the total number of new infections over the course of a year, from one mid-year to the next.
To generate the report, set the Rerport_HIV_ByAgeAndGender configuration parameter to 1.
Report structure and data channel descriptions¶
The file contains the following data channels:
Data channel |
Data type |
Description |
|---|---|---|
Year |
float |
The year at the end of the semiannual interval being recorded. E.g., 1980.5 means that the counts in this row were aggregated over the first half of 1980, or reported as a ‘snapshot’ in the middle of the year 1980. |
NodeId |
integer |
Geographic node. Currently, multi-node simulations are not supported for STI_SIM or HIV_Sim, so this is always set to 1. |
Gender |
boolean |
Set to 0 for male or 1 for female |
Age |
integer |
May range from 0 to 99. |
Population |
integer |
The total number of individuals in the age/gender category at the specified year. |
Infected |
integer |
The number of HIV-infected individuals in the age/gender category at the specified year. |
Newly Infected |
integer |
The number of newly infected individuals in the age/gender category, aggregated over the semi-annual period leading up to the specified year. |
On_ART |
integer |
The number of individuals receiving ART in the age/gender category at the specified year. |
Died |
integer |
The number of deaths among individuals in the age/gender category, aggregated over the semiannual period leading up to the specified year. |
Died_from_HIV |
integer |
The number of deaths due to HIV (as opposed to background mortality) among individuals in the age/gender category, aggregated over the semi-annual period leading up to the specified year. |
Tested Past Year or On_ART |
integer |
The number of individuals receiving ART or having tested in the past year, in the age/gender category at the specified year. |
Tested Ever |
integer |
The number of individuals having ever been tested for HIV, in the age/gender category at the specified year. |
Diagnosed |
integer |
The number of individuals that are HIV+, and is equal to the (number of new HIV+ diagnoses) - (number of individuals who died due to HIV) |
Newly Tested Positive |
integer |
The number of positive HIV tests that occur during the reporting period. |
Newly Tested Negative |
integer |
The number of negative HIV tests that occur during the reporting period. |
Example¶
The following is an example of a ReportHIVByAgeAndGender.csv report:
Year |
NodeId |
Gender |
Age |
Population |
Infected |
Newly Infected |
On_ART |
Died |
Died_from_HIV |
Tested Past Year or On_ART |
Tested Ever |
Diagnosed |
Newly Tested Positive |
Newly Tested Negative |
2000.49 |
1 |
0 |
0 |
52 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
2000.49 |
1 |
0 |
1 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
2000.49 |
1 |
0 |
2 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
2000.49 |
1 |
0 |
3 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
2000.49 |
1 |
0 |
4 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
2000.49 |
1 |
0 |
5 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
2000.49 |
1 |
0 |
6 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
2000.49 |
1 |
0 |
7 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
2000.49 |
1 |
0 |
8 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
2000.49 |
1 |
0 |
9 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
2000.49 |
1 |
0 |
10 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
2000.49 |
1 |
0 |
11 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
2000.49 |
1 |
0 |
12 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
2000.49 |
1 |
0 |
13 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
2000.49 |
1 |
0 |
14 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
2000.49 |
1 |
0 |
15 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
2000.49 |
1 |
0 |
16 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
2000.49 |
1 |
0 |
17 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
2000.49 |
1 |
0 |
18 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
2000.49 |
1 |
0 |
19 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
2000.49 |
1 |
0 |
20 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |