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
            ]
        }
    }
}
_images/inset-chart.png

Example of plots created from InsetChart data

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.