MalariaPatientJSONReport#

The malaria patient data report (MalariaPatientJSONReport.json) is a JSON-formatted report that provides medical data for each individual on each day of the simulation. For example, for a specified number of time steps, each “patient” will have information collected on the temperature of their fever, their parasite counts, treatments they received, and other relevant data.

Configuration#

To generate this report, the following parameters must be configured in the custom_reports.json file:

Parameter

Data type

Min

Max

Default

Description

Filename_Suffix

string

NA

NA

(empty string)

Augments the filename of the report. If multiple reports are being generated, this allows you to distinguish among the multiple reports.

Start_Day

float

0

3.40282e+38

0

The day of the simulation to start collecting data.

End_Day

float

0

3.40282e+38

3.40282e+38

The day of the simulation to stop collecting data.

Node_IDs_Of_Interest

array of integers

0

2.14748e+09

[]

Data will be collected for the nodes in this list. Empty list implies all nodes.

Min_Age_Years

float

0

9.3228e+35

0

Minimum age in years of people to collect data on.

Max_Age_Years

float

0

9.3228e+35

9.3228e+35

Maximum age in years of people to collect data on.

Must_Have_IP_Key_Value

string

NA

NA

(empty string)

A Key:Value pair that the individual must have in order to be included. Empty string means to not include IPs in the selection criteria.

Must_Have_Intervention

string

NA

NA

(empty string)

The name of the intervention that the person must have in order to be included. Empty string means to not include interventions in the selection criteria.

{
    "Reports": [
        {
            "class": "MalariaPatientJSONReport",
            "Filename_Suffix": "Node1",
            "Start_Day": 365,
            "End_Day": 465,
            "Node_IDs_Of_Interest": [ 1 ],
            "Min_Age_Years": 5,
            "Max_Age_Years": 10,
            "Must_Have_IP_Key_Value": "Risk:LOW",
            "Must_Have_Intervention": "UsageDependentBednet"
        }
    ],
    "Use_Defaults": 1
}

Output file data#

The report contains the following information:

Parameter

Data type

Description

ntsteps

integer

Number of time steps in the simulation in which the report is active. Each channel for each person has this number of elements People that are born after the start of the simulation or die before the end will have fewer entries.

patient_array

array of JSON objects

For each patient in patient_array, there will be a dictionary of key:value pairs. Some dictionary entries will contain a single, constant value that does not change through time, such as the individual’s birthday. Other dictionary entries will be arrays of daily measures for that individual, such as the count of count of asexual parasites on each day of the simulation. Please see the example below for an illustration.

Patient data channels#

Each of the following statistics has one value for each timestep or day.

Parameter

Data type

Description

id

string

The unique ID of the individual.

initial_age

float

The initial age of the person, in days, when the report started tracking them. This value will be non-zero for individuals created at initialization, but should be zero for the rest of the population.

birthday

float

The day that the individual was born/created in relation to the start of the report.

Patient array data channels#

Each of the following statistics is an array of data, where each entry is the value of that field at the time of the event.

Parameter

Data type

Description

asexual_parasites

integer

The results of the BLOOD_SMEAR_PARASITES diagnostic that reports the number of parasites detected.

asexual_positive_fields

integer

The count of parasites using positive slide fields.

gametocyte_positive_fields

integer

The count of gametocytes using positive slide fields.

gametocytes

integer

The results of the BLOOD_SMEAR_GAMETOCYTES diagnostic that reports the number of gametocytes detected.

hemoglobin

float

The amount of hemoglobin the individual has based on their red blood cell count.

infected_mosquito_fraction

float

The fraction of mosquito bites the patient received from infectious mosquitoes.

temps

float

The individual’s body temperature, in Celsius, when they had a fever. It is -1 if they do not have a fever. This is based on their cytokine level.

treatment

string

The list of drug names that the user is currently taking, which includes any drugs in the person’s system during that timestep. The names are separated by ‘space+space.’

true_asexual_parasites

float

The actual number of parasites that the individual has.

true_gametocytes

float

The actual number of gametocytes that the individual has.

Example#

The following is an example of MalariaPatientReport.json.

{
    "ntsteps": 5,
    "patient_array": [{
        "asexual_parasites": [
            [
                0,
                30,
                30,
                730,
                570

            ]
        ],
        "asexual_positive_fields": [
            [
                0,
                21,
                19,
                154,
                147
            ]
        ],
        "birthday": -3031.024658203,
        "gametocyte_positive_fields": [
            [
                0,
                0,
                0,
                0,
                1
            ]
        ],
        "gametocytes": [
            [
                0,
                0,
                0,
                0,
                10
            ]
        ],
        "hemoglobin": [
            [
                13.95295619965,
                13.94942092896,
                13.94591999054,
                13.94245052338,
                13.93901348114
            ]
        ],
        "id": 1,
        "infected_mosquito_fraction": [
            [
                0,
                0.02632671967149,
                0.1359317451715,
                0.3907080292702,
                2.00230383873
            ]
        ],
        "initial_age": 3031.024658203,
        "temps": [
            [
                -1,
                38.39496612549,
                40.47192382813,
                40.53329849243,
                43.32601165771
            ]
        ],
        "treatment": [
            [
                "",
                "",
                "",
                "",
                ""
            ]
        ],
        "true_asexual_parasites": [
            [
                0,
                0.01264353003353,
                0.2007576525211,
                2.86963891983,
                41.02872848511
            ]
        ],
        "true_gametocytes": [
            [
                0,
                0.3181047737598,
                4.729532718658,
                67.70833587646,
                967.8447875977
            ]
        ]
    }]
}