InsetChart

The inset chart output report is output with every simulation. It is a JSON-formatted file with the channel output results of the simulation, consisting of simulation-wide averages by time step. The channels in an inset chart are fully specified by the simulation type and cannot be altered without making changes to the EMOD source code. The file name is InsetChart.json. You can use Python or other tools to create charts out of the information contained in the file, but EMOD does not automatically output a chart or figures.

The configuration parameter Enable_Default_Reporting must be set to true (1) to enable the creation of InsetChart.json.

Example

The following is a sample of an InsetChart.json file for a simulation with five time steps.

{
    "Header": {
        "DateTime": "Thu Dec 03 11:28:34 2015",
        "DTK_Version": "5738 HIV-Ongoing 2015/11/18 13:00:39",
        "Report_Type": "InsetChart",
        "Report_Version": "3.2",
        "Start_Time": 0,
        "Simulation_Timestep": 1,
        "Timesteps": 5,
        "Channels": 17
    },
    "Channels": {
        "Births": {
            "Units": "Births",
            "Data": [
                0,
                0,
                0,
                0,
                0
            ]
        },
        "Campaign Cost": {
            "Units": "USD",
            "Data": [
                0,
                0,
                0,
                0,
                0
            ]
        },
        "Cumulative Infections": {
            "Units": "",
            "Data": [
                0,
                0,
                0,
                0,
                0
            ]
        },
        "Cumulative Reported Infections": {
            "Units": "",
            "Data": [
                0,
                0,
                0,
                0,
                0
            ]
        },
        "Disease Deaths": {
            "Units": "",
            "Data": [
                0,
                0,
                0,
                0,
                0
            ]
        },
        "Exposed Population": {
            "Units": "Exposed Fraction",
            "Data": [
                0,
                0,
                0,
                0,
                0
            ]
        },
        "Human Infectious Reservoir": {
            "Units": "Total Infectivity",
            "Data": [
                0,
                0,
                0,
                0,
                0
            ]
        },
        "Infected": {
            "Units": "Infected Fraction",
            "Data": [
                0,
                0,
                0,
                0,
                0
            ]
        },
        "Infectious Population": {
            "Units": "Infectious Fraction",
            "Data": [
                0,
                0,
                0,
                0,
                0
            ]
        },
        "Log Prevalence": {
            "Units": "Log Prevalence",
            "Data": [-10, -10, -10, -10, -10]
        },
        "New Infections": {
            "Units": "",
            "Data": [
                0,
                0,
                0,
                0,
                0
            ]
        },
        "New Reported Infections": {
            "Units": "",
            "Data": [
                0,
                0,
                0,
                0,
                0
            ]
        },
        "Daily (Human) Infection Rate": {
            "Units": "Infection Rate",
            "Data": [
                0,
                0,
                0,
                0,
                0
            ]
        },
        "Recovered Population": {
            "Units": "Recovered (Immune) Fraction",
            "Data": [
                0,
                0,
                0,
                0,
                0
            ]
        },
        "Statistical Population": {
            "Units": "Population",
            "Data": [
                900,
                900,
                900,
                900,
                900
            ]
        },
        "Susceptible Population": {
            "Units": "Susceptible Fraction",
            "Data": [
                1,
                1,
                1,
                1,
                1
            ]
        },
        "Waning Population": {
            "Units": "Waning Immunity Fraction",
            "Data": [
                0,
                0,
                0,
                0,
                0
            ]
        }
    }
}

Example of plots created from InsetChart data

Header

The header section contains 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 noted 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 this simulation.
Channels	integer	The number of channels in the simulation.

Channels

The channels section contains the following parameters.

Parameter	Data type	Description
<Channel_Title>	string	The title of the particular channel.
Units	string	The units used for this channel.
Data	array	A list of the channel data at each time step.

When running HIV simulations, the following channels are included in the InsetChart.json file. For channels related to the HIV stage (latent, acute, AIDS), these definitions are described in more detail in Intrahost dynamics and HIV biology.

Channel	Description
Active COMMERCIAL Relationships	The number of relationships that are currently “commercial”.
Active INFORMAL Relationships	The number of relationships that are currently “informal”.
Active MARITAL Relationships	The number of relationships that are currently “marital”.
Active TRANSITORY Relationships	The number of relationships that are currently “transitory”.
Births	The live births cumulative up to that day.
Campaign Cost	The cost of campaigns cumulative up to that day (set by the Cost_To_Consumer parameter).
Disease Deaths	The number of individuals whose death is attributed to HIV/AIDS, cumulative up to that day.
Infected	The fraction of the population currently infected.
Infectious Population	The fraction of the population that is currently infected and contagious.
New Infections	The number of individuals that got infected on that day.
Newly Symptomatic	The number individuals that became symptomatic on that day.
Number of (untreated) Individuals with AIDS	The number of individuals not on ART with AIDS.
Number of (untreated) Individuals with Acute HIV	The number of individuals not on ART with acute HIV.
Number of (untreated) Individuals with Latent HIV	The number of individuals not on ART with latent HIV.
Number of ART dropouts (cumulative)	The number of individuals who started and dropped ART, cumulative up to that day.
Number of Circumcised Males	The number of male individuals that are circumcised via the MaleCircumcision intervention.
Number of Events	The total number of events (births, new infections, etc.) cumulative up to that day.
Number of Individuals Ever in a Relationship	The number of individuals who have ever been in a relationship cumulative up to that day.
Number of Individuals HIV+ w/ CD4 < 200 (non-ART)	The number of individuals who are HIV+ with CD4 count less than 200 and NOT on ART on that day.
Number of Individuals HIV+ w/ CD4 < 200 (on-ART)	The number of individuals who are HIV+ with CD4 count less than 200 and ON ART on that day.
Number of Individuals HIV+ w/ CD4 >= 200 (non-ART)	The number of individuals who are HIV+ with CD4 count greater than 200 and NOT on ART on that day.
Number of Individuals HIV+ w/ CD4 >= 200 (on-ART)	The number of individuals who are HIV+ with CD4 count greater than 200 and ON ART on that day.
Number of Individuals on ART	The total number of individuals on ART on that day.
Paired People	The number of individuals currently in any type of relationship.
Post-Debut Population	The number of individuals that are sexually active.
Prevalence (Females, 15-49)	The fraction of infected individuals in the population of females 15-49.
Prevalence (Males, 15-49)	The fraction of infected individuals in the population of males 15-49.
Prevalence among Sexually Active (Adults)	The fraction of infected individuals in the post-debut adult population.
Single Post-Debut Men	The number of sexually active males who are currently not in a relationship.
Single Post-Debut Women	The number of sexually active females who are currently not in a relationship.
Statistical Population	The total number of individuals in the simulation on that day.
Susceptible Population	The fraction of the population that is currently not infected and is maximally susceptible.
Symptomatic Population	The total number of symptomatic HIV+ individuals.