InsetChart#

The inset chart (InsetChart.json) is an output report that is automatically generated with every simulation. It contains simulation-wide averages, one per time step, for a wide number of data channels. The channels are fully specified by the simulation type and cannot be altered without making changes to the EMOD source code. Python or other tools can be used to create charts out of the information contained in the file (see the example charts provided at the end of this page.)

Configuration#

To generate this report, make sure the Enable_Default_Reporting parameter is set to 1 in the config.json file.

Output file data#

Headers#

When running malaria simulations, the header section will contain the following parameters.

Parameter

Data type

Description

DateTime

string

The time stamp indicating when the report was generated.

DTK_Version

string

The version of EMOD used.

Report_Type

string

The type of output report.

Report_Version

string

The format version of the report.

Start_Time

integer

The time in days when the simulation begins.

Simulation_Timestep

integer

The number of days in each time step.

Timesteps

integer

The number of time steps in the simulation.

Channels

integer

The number of channels in the simulation.

Channels#

When running malaria simulations, the following channels are included in the InsetChart.json file. Note that the diagnostic channels are calculated once each time step and the same results of the diagnostic are used in all reports.

Note that you cannot generate a separate InsetChart by node; to do so, use ReportMalariaFiltered.

Channel

Description

30-day Av Infection Duration

A running average of the duration of each infection that cleared in the last 30 days (both naturally and due to drugs). Use Inset_Chart_Reporting_Include_30Day_Avg_Infection_Duration to control the presence of this channel. The default is to include the channel.

Adult Vectors

The average number of adult vectors per node.

Air Temperature

The average air temperature, in Celsius, on that day per node.

Avg Num Infections

The average number of infections, per person (infected people only) on that day. These are all the infections the individual has and may not be detectable by diagnostics. Note that this may not equal the number of infected people as people may have multiple infections.

Avg Num Vector Infs

The average number of infections per infected/infectious vector. This number implies that the infections are different in either time or genetics of the parasite. This channel is included when Malaria_Model is set to MALARIA_MECHANISTIC_MODEL_WITH_PARASITE_GENETICS.

Births

The live births cumulative up to that day.

Blood Smear Gametocyte Prevalence

The fraction of the population that is detectable with the BLOOD_SMEAR_GAMETOCYTES version of MalariaDiagnostic. The detectability of the diagnostic is controlled by the parameters Report_Gametocyte_Smear_Sensitivity and Report_Detection_Threshold_Blood_Smear_Gametocytes.

Blood Smear Parasite Prevalence

The fraction of the population that is detectable with the BLOOD_SMEAR_PARASITES version of MalariaDiagnostic. The detectability of the diagnostic is controlled by parameters Report_Parasite_Smear_Sensitivity and Report_Detection_Threshold_Blood_Smear_Parasites.

Campaign Cost

The cost of campaigns cumulative up to that day (set by the Cost_To_Consumer parameter in each intervention).

Daily Bites per Human

The average number of mosquito bites received per individual on that day.

Daily EIR

The entomological inoculation rate (EIR), or number of infected mosquito bites each individual receives each day, on average.

Disease Deaths

The number of individuals whose death is attributed to malaria, cumulative up to that day.

Fever Prevalence

The fraction of the population currently with a fever. Detectable fever is determined by the parameter Report_Detection_Threshold_Fever, the level of temperature above normal (Celsius) for an individual to be considered to have a fever.

Has_<Intervention>

The fraction of the population that has the given intervention. There is one channel for each entry in the parameter Inset_Chart_Has_Interventions. The parameter contains a list of intervention names that you can define in the campaign for the intervention using the parameter Intervention_Name. This only pertains to those interventions that persist in the individual from one time step to the next. You can use this channel as a simple debugging tool to see if and when interventions are distributed. If Inset_Chart_Has_Interventions is an empty list, there are no channels. The parameter does not validate the entries.

HasIP_<Key>:<Value>

The fraction of the population that has this Value for the individual property Key. There will be one channel for each value of each individual property key listed in the configuration parameter Inset_Chart_Has_IP. If Inset_Chart_Has_IP is an empty list, there will be no channels added to the report. They keys provided in the parameter must be defined in the demographics.

Human Infectious Reservoir

The expected number of infections from human to vector, including human immunity and within-host interventions but not vector control interventions, if each human were bitten by one vector that day.  The average infectiousness per individual in the simulation.

Infected

The fraction of the population currently infected.

Infected and Infectious Vectors

The fraction of adult female vectors that are either infected or infectious. These vectors could have either oocyts, sporozoites or both. This channel is included when Malaria_Model is set to MALARIA_MECHANISTIC_MODEL_WITH_PARASITE_GENETICS.

Infectious Vectors

The fraction of vectors in the simulation that are currently infected and infectious.

Land Temperature

The average land temperature per node, in Celsius, on that day.

Log Prevalence

The logarithm of the population prevalence. Log10 of the infected channel.

Mean Parasitemia

The geometric mean number of parasites per microliter of blood. [Exponential of (Sum of log(BLOOD_SMEAR_PARASITES diagnostic) for all individuals divided by the number of individuals detected using (BLOOD_SMEAR_PARASITES) diagnostic – geometric mean].

New Clinical Cases

The number of new clinical cases on that day. This channel is controlled by the Clinical_Fever_Threshold_Low and Clinical_Fever_Threshold_High parameters. The amount that an individual’s fever is above normal must be greater than both of these values to be considered clinical.

New Infections

The number of individuals who got infected on that day. Because an individual could receive multiple infections in a single day, this is not the number of total new infections on that day. The Malaria_Model parameter controls the number of new infections possible per person per day.

New Vector Infections

The number of new infections occurring in vectors on that day. Since vectors only feed once per day, it is also the number of vectors that received an infection that day. This could be an infected or infectious vector taking on more gametocytes. This channel is included when Malaria_Model is set to MALARIA_MECHANISTIC_MODEL_WITH_PARASITE_GENETICS.

New Severe Cases

The number of new severe cases of malaria on that day. An individual is considered to be a severe case if the combined probability of anemia, parasite density, and fever is greater than a uniform random number. This combined probability is the combination of sigmoid using the following parameters: Anemia_Severe_Threshold and Anemia_Severe_Inverse_Width, Parasite_Severe_Threshold and Parasite_Severe_Inverse_Width, and Fever_Severe_Threshold and Fever_Severe_Inverse_Width. For more information see Malaria symptoms and diagnostics.

Newly Symptomatic

50% of new infections are randomly selected to be ‘symptomatic’.

PCR Gametocyte Prevalence

The fraction of the population that is detectable with the PCR_GAMETOCYTES version of MalariaDiagnostic. The detectability of the diagnostic is controlled by parameter Report_Detection_Threshold_PCR_Gametocytes.

PCR Parasite Prevalence

The fraction of the population that is detectable with the PCR_PARASITES version of MalariaDiagnostic. The detectability of the diagnostic is controlled by parameter Report_Detection_Threshold_PCR_Parasites.

PfHRP2 Prevalence

The fraction of the population that is detectable with the PF_HRP2 version of MalariaDiagnostic. The detectability of the diagnostic is controlled by parameter Report_Detection_Threshold_PCR_PfHRP2.

Rainfall

The average number in millimeters of rainfall per node on that day.

Relative Humidity

The average relative humidity per node on that day.

Statistical Population

The total number of individuals in the simulation on that day.

Symptomatic Population

Not connected in Malaria simulations.

True_Prevalence

The fraction of the population that is detectable with the TRUE_PARASITE_DENSITY version of MalariaDiagnostic. The detectability of the diagnostic is controlled by the parameter Report_Detection_Threshold_True_Parasite_Density.

Variant Fraction-PfEMP1 Major

The average of the fraction of variants of the PfEMP1 var genes that an individual has had. The parameter Falciparum_PfEMP1_Variants defines the total number of possible variants. This channel indicates the average fraction that an individual has seen of this total number. The greater the fraction the more that the population has developed antibodies to the parasite.

Example#

The following is an example of a malaria-specific InsetChart.json:

{
    "Header": {
        "DateTime": "Thu Jun 10 07:01:07 2021",
        "DTK_Version": "0 unknown-branch (unknown) Jun  9 2021 11:19:20",
        "Report_Type": "InsetChart",
        "Report_Version": "3.2",
        "Start_Time": 0,
        "Simulation_Timestep": 1,
        "Timesteps": 2850,
        "Channels": 31
    },
    "Channels": {
        "30-day Avg Infection Duration": {
            "Units": "Days",
            "Data": [3729.955566406, 3697.680664063, 3650.832519531, 3629.385742188, 3646.3359375]
        },
        "Adult Vectors": {
            "Units": "Average Count/Node",
            "Data": [1027.041625977, 1027.176391602, 1027.213378906, 1026.593139648, 1026.565429688]
        },
        "Air Temperature": {
            "Units": "degrees Celsius",
            "Data": [22, 22, 22, 22, 22]
        },
        "Avg Num Infections": {
            "Units": "Count",
            "Data": [2.812913894653, 2.819536447525, 2.817204236984, 2.809917449951, 2.80363035202]
        },
        "Births": {
            "Units": "Count",
            "Data": [2515, 2515, 2517, 2520, 2521]
        },
        "Blood Smear Gametocyte Prevalence": {
            "Units": "Fraction Detected Infected",
            "Data": [0.1729622334242, 0.1707532554865, 0.1703867465258, 0.1688397824764, 0.1727031767368]
        },
        "Blood Smear Parasite Prevalence": {
            "Units": "Fraction Detected Infected",
            "Data": [0.2233267128468, 0.2217804342508, 0.223646402359, 0.2238674014807, 0.2206272035837]
        },
        "Campaign Cost": {
            "Units": "USD",
            "Data": [5486.75, 5488.75, 5490.75, 5494.75, 5498.75]
        },
        "Daily Bites per Human": {
            "Units": "Bites/Day/Human",
            "Data": [113.6352996826, 113.5904541016, 113.3630905151, 113.5420913696, 113.4094543457]
        },
        "Daily EIR": {
            "Units": "Infectious Bites/Day",
            "Data": [0.3297989964485, 0.3540976345539, 0.3334806859493, 0.3672928214073, 0.3440812528133]
        },
        "Disease Deaths": {
            "Units": "Count",
            "Data": [0, 0, 0, 0, 0]
        },
        "Fever Prevalence": {
            "Units": "Fraction Detected Infected",
            "Data": [0.008614976890385, 0.008614976890385, 0.008839778602123, 0.005966851022094, 0.005962897557765]
        },
        "Human Infectious Reservoir": {
            "Units": "Infectivity/Person",
            "Data": [0.005706539843231, 0.005738727282733, 0.005730483215302, 0.005793820600957, 0.005701572168618]
        },
        "Infected": {
            "Units": "Infected Fraction",
            "Data": [0.2666224837303, 0.2668433785439, 0.2669613361359, 0.2671823203564, 0.2672261595726]
        },
        "Infectious Vectors": {
            "Units": "Infectious Fraction",
            "Data": [0.00372875877656, 0.003818936413154, 0.003874097252265, 0.003857779549435, 0.003872038796544]
        },
        "Land Temperature": {
            "Units": "degrees Celsius",
            "Data": [26, 26, 26, 26, 26]
        },
        "Log Prevalence": {
            "Units": "Log Prevalence",
            "Data": [-0.5741032361984, -0.5737435817719, -0.5735516548157, -0.5731922984123, -0.5731210112572]
        },
        "Mean Parasitemia": {
            "Units": "Geo. mean parasites/microliter",
            "Data": [409.4178161621, 426.9133300781, 387.6334228516, 402.7696838379, 379.7192382813]
        },
        "New Clinical Cases": {
            "Units": "Count",
            "Data": [9, 13, 9, 7, 5]
        },
        "New Infections": {
            "Units": "Count",
            "Data": [32, 31, 25, 17, 21]
        },
        "New Severe Cases": {
            "Units": "Count",
            "Data": [ 0, 0, 0, 3, 1]
        },
        "Newly Symptomatic": {
            "Units": "Count",
            "Data": [19, 15, 16, 5, 11]
        },
        "PCR Gametocyte Prevalence": {
            "Units": "% Detected Infected",
            "Data": [0.2491716295481, 0.2476253658533, 0.2495027631521, 0.2466298341751, 0.2495582997799]
        },
        "PCR Parasite Prevalence": {
            "Units": "% Detected Infected",
            "Data": [0.2540313601494, 0.2529268860817, 0.2519336938858, 0.2514917254448, 0.2526501715183]
        },
        "PfHRP2 Prevalence": {
            "Units": "% Detected Infected",
            "Data": [0.248729839921, 0.2491716295481, 0.2481767982244, 0.2497237622738, 0.25]
        },
        "Rainfall": {
            "Units": "mm/day",
            "Data": [9.999994277954, 9.999994277954, 9.999994277954, 9.999994277954, 9.999994277954]
        },
        "Relative Humidity": {
            "Units": "",
            "Data": [0.75, 0.75, 0.75, 0.75, 0.75]
        },
        "Statistical Population": {
            "Units": "Population",
            "Data": [4527, 4527, 4525, 4525, 4528]
        },
        "Symptomatic Population": {
            "Units": "Count",
            "Data": [0, 0, 0, 0, 0]
        },
        "True Prevalence": {
            "Units": "% Detected Infected",
            "Data": [0.2622045576572, 0.2622045576572, 0.2618784606457, 0.2616574466228, 0.2617049515247]
        },
        "Variant Fraction-PfEMP1 Major": {
            "Units": "Fraction",
            "Data": [0.1735506355762, 0.1736092269421, 0.1737322509289, 0.1737831532955, 0.173709705472]
        }
    }
}
../_images/malaria-inset-chart.png