Malaria node demographics report (ReportNodeDemographicsMalaria.csv)¶
The malaria node demographics report is a CSV-formatted report that extends the ReportNodeDemographics report (see Node demographics report (ReportNodeDemographics.csv)) by adding malaria-specific statistics. The report still contains population information stratified by node, but the data columns now also contain information about malaria parasite counts.
The report name is ReportNodeDemographicsMalaria.csv, and is generated by the libReportNodeDemographicsMalaria.dll file. See Custom reporters for information on using dynamic link library (DLL) files.
Configuration¶
The following parameters need to be configured to generate the report:
Parameter name |
Data type |
Min |
Max |
Default |
Description |
|---|---|---|---|---|---|
IP_Key_To_Collect |
string |
NA |
NA |
(empty string) |
The name of the IndividualProperties key by which to stratify the report. An empty string implies ‘do not stratify by IP.’ |
Age_Bins |
Array of integers |
0 |
MAX_HUMAN_AGE |
[40, 80, 125] |
The Age Bins (in years) to aggregate within and report; an empty array implies ‘do not stratify by age.’ |
Stratify_By_Gender |
boolean |
0 |
1 |
1 |
Set to true (1) to stratify by gender; a value of 0 will not stratify by gender. |
Output file data¶
The report will contain the following output data, divided between stratification columns and data columns.
Stratification columns¶
Parameter |
Data type |
Description |
|---|---|---|
Time |
integer |
The day of the simulation that the data was collected. |
NodeID |
string |
The External ID of the node for the data in the row in the report. |
Gender |
enum |
Possible values are M or F; the gender of the individuals in the row in the report. |
AgeYears |
integer |
The max age in years of the bin for the individuals in the row in the report. |
IndividualProp |
string |
The value of the IP for the individuals in the row in the report. |
Data columns¶
Parameter |
Data type |
Description |
|---|---|---|
NumIndividuals |
integer |
The number of individuals that meet the stratification values. |
NumInfected |
integer |
The number of infected individuals that meet the stratification values and are infected. |
AvgParasiteDensity |
float |
The average true parasite density for the individuals of this row. |
AvgGametocyteDensity |
float |
The average true gametocyte density for the individuals of this row. |
NumInfections |
integer |
The total number of infections for the people in this row. This will be greater than NumInfected when people have multiple infections. |
<Genome Marker Columns> |
integer |
The report will add columns for each possible combination of Genome_Markers as defined in the config.json file. The data for each column will be the number of infections that have this exact genome marker combination. |
Example¶
The following is an example of ReportNodeDemographicsMalaria.csv.
Time |
NodeID |
NumIndividuals |
NumInfected |
AvgParasiteDensity |
AvgGametocyteDensity |
NumInfections |
NoMarkers |
A |
B |
A-B |
|---|---|---|---|---|---|---|---|---|---|---|
18 |
4 |
1000 |
110 |
0.0256798 |
0 |
114 |
0 |
58 |
56 |
0 |
18 |
3 |
1000 |
86 |
0.0188456 |
0 |
86 |
0 |
0 |
86 |
0 |
18 |
2 |
1000 |
105 |
0.0218442 |
0 |
105 |
0 |
105 |
0 |
0 |
18 |
1 |
1000 |
108 |
0.0227728 |
0 |
108 |
108 |
0 |
0 |
0 |
19 |
4 |
1000 |
110 |
0.0256667 |
0 |
114 |
0 |
58 |
56 |
0 |
19 |
3 |
1000 |
86 |
0.0188368 |
0 |
86 |
0 |
0 |
86 |
0 |
19 |
2 |
1000 |
105 |
0.0218349 |
0 |
105 |
0 |
105 |
0 |
0 |
19 |
1 |
1000 |
108 |
0.0227626 |
0 |
108 |
108 |
0 |
0 |
0 |
20 |
4 |
1000 |
110 |
0.399371 |
0 |
114 |
0 |
58 |
56 |
0 |
20 |
3 |
1000 |
86 |
0.293125 |
0 |
86 |
0 |
0 |
86 |
0 |
20 |
2 |
1000 |
105 |
0.339806 |
0 |
105 |
0 |
105 |
0 |
0 |
20 |
1 |
1000 |
108 |
0.354227 |
0 |
108 |
108 |
0 |
0 |
0 |