Configuration parameters¶
The parameters described in this reference section can be added to the JSON (JavaScript Object Notation) formatted configuration file to determine the core behavior of a simulation including the computing environment, functionality to enable, additional files to use, and characteristics of the disease being modeled. This file contains mostly a flat list of JSON key:value pairs.
For more information on the structure of these files, see Configuration file.
The tables below contain only parameters available when using the typhoid simulation type. Some parameters may appear in multiple categories.
Note
Parameters are case-sensitive. For Boolean parameters, set to 1 for true or 0 for false. Minimum, maximum, or default values of “NA” indicate that those values are not applicable for that parameter.
EMOD does not use true defaults; that is, if the dependency relationships indicate that a parameter is required, you must supply a value for it. However, many of the tools used to work with EMOD will use the default values provided below.
JSON does not permit comments, but you can add “dummy” parameters to add contextual information to your files.
Contents
Disease progression¶
The following parameters determine aspects of typhoid disease progression.
Parameter |
Data type |
Minimum |
Maximum |
Default |
Description |
Example |
---|---|---|---|---|---|---|
Typhoid_Exposure_Lambda |
float |
-1 |
100 |
2 |
The average number of typhoid exposures during time period. |
{
"Typhoid_Exposure_Lambda": 2
}
|
Typhoid_Symptomatic_Fraction |
float |
0 |
1 |
0.5 |
Proportion of prepatent cases that become acute vs. subclinical. |
{
"Typhoid_Symptomatic_Fraction": 0.5
}
|
Enable or disable features¶
The following parameters enable or disable features of the model, such as allowing births, deaths, or aging. Set to false (0) to disable; set to true (1) to enable.
Parameter |
Data type |
Minimum |
Maximum |
Default |
Description |
Example |
---|---|---|---|---|---|---|
Enable_Aging |
boolean |
0 |
1 |
1 |
Controls whether or not individuals in a population age during the simulation. Enable_Vital_Dynamics must be set to true (1). |
{
"Enable_Vital_Dynamics": 1,
"Enable_Aging": 1
}
|
Enable_Air_Migration |
boolean |
0 |
1 |
0 |
Controls whether or not migration by air travel will occur. Migration_Model must be set to FIXED_RATE_MIGRATION. |
{
"Migration_Model": "FIXED_RATE_MIGRATION",
"Enable_Air_Migration": 1,
"Air_Migration_Filename": "../inputs/air_migration.bin"
}
|
Enable_Birth |
boolean |
0 |
1 |
1 |
Controls whether or not individuals will be added to the simulation by birth. Enable_Vital_Dynamics must be set to true (1). If you want new individuals to have the same intervention coverage as existing individuals, you must add a BirthTriggeredIV to the campaign file. |
{
"Enable_Vital_Dynamics": 1,
"Enable_Birth": 1
}
|
Enable_Climate_Stochasticity |
boolean |
0 |
1 |
0 |
Controls whether or not the climate has stochasticity. Climate_Model must be set to CLIMATE_CONSTANT or CLIMATE_BY_DATA. Set the variance using the parameters Air_Temperature_Variance, Land_Temperature_Variance, Enable_Rainfall_Stochasticity, and Relative_Humidity_Variance. |
{
"Climate_Model": "CLIMATE_BY_DATA",
"Enable_Climate_Stochasticity": 1,
"Air_Temperature_Variance": 2,
"Enable_Rainfall_Stochasticity": 1,
"Land_Temperature_Variance": 2,
"Relative_Humidity_Variance": 0.05
}
|
Enable_Default_Reporting |
boolean |
0 |
1 |
1 |
Controls whether or not the default InsetChart.json report is created. |
{
"Enable_Default_Reporting": 1
}
|
Enable_Demographics_Birth |
boolean |
0 |
1 |
0 |
Controls whether or not newborns have identical or heterogeneous characteristics. Set to false (0) to give all newborns identical characteristics; set to true (1) to allow for heterogeneity in traits such as sickle-cell status. Enable_Birth must be set to true (1). |
{
"Enable_Birth": 1,
"Enable_Demographics_Birth": 1
}
|
Enable_Demographics_Builtin |
boolean |
0 |
1 |
0 |
Controls whether or not built-in demographics for default geography will be used. Note that the built-in demographics feature does not represent a real geographical location and is mostly used for testing. Set to true (1) to define the initial population and number of nodes using Default_Geography_Initial_Node_Population and Default_Geography_Torus_Size. Set to false (0) to use demographics input files defined in Demographics_Filenames. |
{
"Enable_Demographics_Builtin": 1,
"Default_Geography_Initial_Node_Population": 1000,
"Default_Geography_Torus_Size": 3
}
|
Enable_Demographics_Reporting |
boolean |
0 |
1 |
1 |
Controls whether or not demographic summary data and age-binned reports are outputted to file. |
{
"Enable_Demographics_Reporting": 1
}
|
Enable_Disease_Mortality |
boolean |
0 |
1 |
1 |
Controls whether or not individuals are removed from the simulation due to disease deaths. |
{
"Enable_Disease_Mortality": 1
}
|
Enable_Family_Migration |
boolean |
0 |
1 |
0 |
Controls whether or not all members of a household can migrate together when a MigrateFamily event occurs. All residents must be home before they can leave on the trip. Migration_Model must be set to FIXED_RATE_MIGRATION. |
{
"Enable_Migration": "FIXED_RATE_MIGRATION",
"Enable_Family_Migration": 1,
"Family_Migration_Filename": "../inputs/family_migration.bin"
}
|
Enable_Heterogeneous_Intranode_Transmission |
boolean |
0 |
1 |
0 |
Controls whether or not individuals experience heterogeneous disease transmission within a node. When set to true (1), individual property definitions and the \(\beta\) matrix must be specified in the demographics file (see NodeProperties and IndividualProperties parameters). The \(\beta\) values are multiplied with the \(\beta\) 0 value configured by Base_Infectivity. This is used only in generic simulations, but must be set to false (0) for all other simulation types. Heterogeneous transmission for other diseases uses other mechanistic parameters included with the simulation type. |
{
"Enable_Heterogeneous_Intranode_Transmission": 1
}
|
Enable_Immune_Decay |
boolean |
0 |
1 |
1 |
Controls whether or not immunity decays after an infection clears. Set to true (1) if immunity decays; set to false (0) if recovery from the disease confers complete immunity for life. Enable_Immunity must be set to true (1). This parameter should always be set to 0 (off) in this simulation type. |
{
"Enable_Immunity": 1,
"Enable_Immune_Decay": 0
}
|
Enable_Initial_Susceptibility_Distribution |
boolean |
0 |
1 |
0 |
Controls whether or not individuals in the population have immunity at the beginning of the simulation. If set to 0, individuals are not initialized with immunity but may acquire immunity. If set to 1, you must indicate the type of distribution to use for immunity in the configuration parameter Immunity_Initialization_Distribution_Type and the distribution values in the demographics file. Enable_Immunity must be set to 1. |
{
"Enable_Immunity": 1,
"Enable_Initial_Susceptibility_Distribution": 1,
"Immunity_Initialization_Distribution_Type": "DISTRIBUTION_SIMPLE"
}
|
Enable_Interventions |
boolean |
0 |
1 |
0 |
Controls whether or not campaign interventions will be used in the simulation. Set Campaign_Filename to the path of the file that contains the campaign interventions. |
{
"Enable_Interventions": 1,
"Campaign_Filename": "campaign.json"
}
|
Enable_Local_Migration |
boolean |
0 |
1 |
0 |
Controls whether or not local migration (the diffusion of people in and out of nearby nodes by foot travel) occurs. Migration_Model must be set to FIXED_RATE_MIGRATION. |
{
"Migration_Model": "FIXED_RATE_MIGRATION",
"Enable_Local_Migration": 1,
"Local_Migration_Filename": "../inputs/local_migration.bin"
}
|
Enable_Maternal_Protection |
boolean |
0 |
1 |
0 |
Controls whether or not mothers pass immunity on to their infants. Setting to 1 (true) enables maternal protection as defined by Maternal_Protection_Type. Enable_Birth must be set to 1 (true). |
{
"Enable_Maternal_Protection": 1,
"Maternal_Protection_Type": "LINEAR_FRACTIONAL"
}
|
Enable_Migration_Heterogeneity |
boolean |
0 |
1 |
1 |
Controls whether or not migration rate is heterogeneous among individuals within each group that has a migration rate setting. Set to true (1) to apply a migration rate distribution (see NodeAttributes demographics parameters); set to false (0) to use the same migration rate applied to all individuals in the group. For example, if you are using a migration file that sets different migration rates for each age group in a node, you could apply an Gaussian distribution around a mean value in each age group or you could assign the same value to each individual in each age group. Migration_Model must be set to FIXED_RATE_MIGRATION. |
{
"Migration_Model": "FIXED_RATE_MIGRATION",
"Enable_Migration_Heterogeneity": 1
}
|
Enable_Natural_Mortality |
boolean |
0 |
1 |
0 |
Controls whether or not individuals are removed from the simulation due to natural (non-disease) deaths. Enable_Vital_Dynamics must be set to 1 (true). Use Death_Rate_Dependence to set the natural death rate. |
{
"Enable_Natural_Mortality": 1,
"Enable_Vital_Dynamics": 1
}
|
Enable_Property_Output |
boolean |
0 |
1 |
0 |
Controls whether or not to create property output reports, which detail groups as defined in IndividualProperties in the demographics file (see NodeProperties and IndividualProperties parameters). When there is more than one property type, the report will display the channel information for all combinations of the property type groups. |
{
"Enable_Property_Output": 1
}
|
Enable_Rainfall_Stochasticity |
boolean |
0 |
1 |
1 |
Controls whether or not there is stochastic variation in rainfall; set to true (1) for stochastic variation of rainfall that is drawn from an exponential distribution (with a mean value as the daily rainfall from the Climate_Model values CLIMATE_CONSTANT or CLIMATE_BY_DATA), or set to false (0) to disable rainfall stochasticity. |
{
"Enable_Climate_Stochasticity": 1,
"Air_Temperature_Variance": 2,
"Enable_Rainfall_Stochasticity": 1,
"Land_Temperature_Variance": 2,
"Relative_Humidity_Variance": 0.05
}
|
Enable_Regional_Migration |
boolean |
0 |
1 |
0 |
Controls whether or not there is migration by road or rail network into and out of nodes in the simulation. Migration_Model must be set to FIXED_RATE_MIGRATION. |
{
"Migration_Model": "FIXED_RATE_MIGRATION",
"Enable_Regional_Migration": 1,
"Regional_Migration_Filename": "../inputs/regional_migration.bin"
}
|
Enable_Sea_Migration |
boolean |
0 |
1 |
0 |
Controls whether or not there is migration on ships into and out of coastal cities with seaports. Migration_Model must be set to FIXED_RATE_MIGRATION. |
{
"Migration_Model": "FIXED_RATE_MIGRATION",
"Enable_Sea_Migration": 1,
"Sea_Migration_Filename": "../inputs/sea_migration.bin"
}
|
Enable_Spatial_Output |
boolean |
0 |
1 |
0 |
Controls whether or not spatial output reports are created. If set to true (1), spatial output reports include all channels listed in the parameter Spatial_Output_Channels. Note Spatial output files require significant processing time and disk space. |
{
"Enable_Spatial_Output": 1,
"Spatial_Output_Channels": [
"Prevalence",
"New_Infections"
]
}
|
Enable_Susceptibility_Scaling |
boolean |
0 |
1 |
0 |
Controls whether or not susceptibility is scaled by time as defined by Susceptibility_Scaling_Type. |
{
"Enable_Susceptibility_Scaling": 1,
"Susceptibility_Scaling_Type": "LOG_LINEAR_FUNCTION_OF_TIME"
}
|
Enable_Vital_Dynamics |
boolean |
0 |
1 |
1 |
Controls whether or not births and deaths occur in the simulation. Births and deaths must be individually enabled and set. |
{
"Enable_Vital_Dynamics": 1,
"Enable_Birth": 1,
"Death_Rate_Dependence": "NOT_INITIALIZED",
"Base_Mortality": 0.002
}
|
General disease¶
The following parameters determine general disease characteristics.
Parameter |
Data type |
Minimum |
Maximum |
Default |
Description |
Example |
---|---|---|---|---|---|---|
Number_Basestrains |
integer |
1 |
10 |
1 |
The number of base strains in the simulation, such as antigenic variants. The specific base strain of an outbreak is specified using Antigen in the campaign file. |
{
"Number_Basestrains": 1
}
|
Number_Substrains |
integer |
1 |
16777216 |
256 |
The number of disease substrains for each base strain, such as genetic variants. The specific substrain of an outbreak is specified using Genome in the campaign file. |
{
"Number_Substrains": 256
}
|
Geography and environment¶
The following parameters determine characteristics of the geography and environment of the simulation. For example, how to use the temperature or rainfall data in the climate files and the size of the nodes in the simulation.
Parameter |
Data type |
Minimum |
Maximum |
Default |
Description |
Example |
---|---|---|---|---|---|---|
Air_Temperature_Filename |
string |
NA |
NA |
air_temp.json |
The path to the input file that defines air temperature data measured two meters above ground. Climate_Model must be set to CLIMATE_BY_DATA. The file must be in .bin format. |
{
"Climate_Model": "CLIMATE_BY_DATA",
"Air_Temperature_Filename": "Namawala_single_node_air_temperature_daily.bin"
}
|
Air_Temperature_Offset |
float |
-20 |
20 |
0 |
The linear shift of air temperature in degrees Celsius. Climate_Model must be set to CLIMATE_BY_DATA. |
{
"Air_Temperature_Offset": 1
}
|
Air_Temperature_Variance |
float |
0 |
5 |
2 |
The standard deviation (in degrees Celsius) for normally distributed noise applied to the daily air temperature values when Climate_Model is configured as CLIMATE_CONSTANT or CLIMATE_BY_DATA. Enable_Climate_Stochasticity must be set to true (1). |
{
"Enable_Climate_Stochasticity": 1,
"Air_Temperature_Variance": 2
}
|
Base_Air_Temperature |
float |
-55 |
45 |
22 |
The air temperature, in degrees Celsius, where Climate_Model is set to CLIMATE_CONSTANT. |
{
"Climate_Model": "CLIMATE_CONSTANT",
"Base_Air_Temperature": 30
}
|
Base_Land_Temperature |
float |
-55 |
60 |
26 |
The land temperature, in degrees Celsius, where Climate_Model is set to CLIMATE_CONSTANT. |
{
"Climate_Model": "CLIMATE_CONSTANT",
"Base_Land_Temperature": 20
}
|
Base_Rainfall |
float |
0 |
150 |
10 |
The value of rainfall per day in millimeters when Climate_Model is set to CLIMATE_CONSTANT. |
{
"Climate_Model": "CLIMATE_CONSTANT",
"Base_Rainfall": 20
}
|
Base_Relative_Humidity |
float |
0 |
1 |
0.75 |
The value of humidity where Climate_Model is set to CLIMATE_CONSTANT. |
{
"Base_Relative_Humidity": 0.1
}
|
Climate_Update_Resolution |
enum |
NA |
NA |
CLIMATE_UPDATE_YEAR |
The resolution of data in climate files. Climate_Model must be set to CLIMATE_CONSTANT, CLIMATE_BY_DATA, or CLIMATE_KOPPEN. Possible values are: CLIMATE_UPDATE_YEAR CLIMATE_UPDATE_MONTH CLIMATE_UPDATE_WEEK CLIMATE_UPDATE_DAY CLIMATE_UPDATE_HOUR |
{
"Climate_Update_Resolution": "CLIMATE_UPDATE_DAY"
}
|
Default_Geography_Initial_Node_Population |
integer |
0 |
1000000 |
1000 |
When using the built-in demographics for default geography, the initial number of individuals in each node. Note that the built-in demographics feature does not represent a real geographical location and is mostly used for testing. Enable_Demographics_Builtin must be set to true (1). |
{
"Enable_Demographics_Builtin": 1,
"Default_Geography_Initial_Node_Population": 1000,
"Default_Geography_Torus_Size": 3
}
|
Default_Geography_Torus_Size |
integer |
3 |
100 |
10 |
When using the built-in demographics for default geography, the square root of the number of nodes in the simulation. The simulation uses an N x N square grid of nodes with N specified by this parameter. If migration is enabled, the N x N nodes are assumed to be a torus and individuals can migrate from any node to all four adjacent nodes. To enable migration, set Migration_Model to FIXED_RATE_MIGRATION. Built-in migration is a form of “local” migration where individuals only migrate to the adjacent nodes. You can use the x_Local_Migration parameter to control the rate of migration. The other migration parameters are ignored. Note that the built-in demographics feature does not represent a real geographical location and is mostly used for testing. Enable_Demographics_Builtin must be set to true (1). |
{
"Enable_Demographics_Builtin": 1,
"Default_Geography_Initial_Node_Population": 1000,
"Default_Geography_Torus_Size": 3
}
|
Enable_Climate_Stochasticity |
boolean |
0 |
1 |
0 |
Controls whether or not the climate has stochasticity. Climate_Model must be set to CLIMATE_CONSTANT or CLIMATE_BY_DATA. Set the variance using the parameters Air_Temperature_Variance, Land_Temperature_Variance, Enable_Rainfall_Stochasticity, and Relative_Humidity_Variance. |
{
"Climate_Model": "CLIMATE_BY_DATA",
"Enable_Climate_Stochasticity": 1,
"Air_Temperature_Variance": 2,
"Enable_Rainfall_Stochasticity": 1,
"Land_Temperature_Variance": 2,
"Relative_Humidity_Variance": 0.05
}
|
Enable_Rainfall_Stochasticity |
boolean |
0 |
1 |
1 |
Controls whether or not there is stochastic variation in rainfall; set to true (1) for stochastic variation of rainfall that is drawn from an exponential distribution (with a mean value as the daily rainfall from the Climate_Model values CLIMATE_CONSTANT or CLIMATE_BY_DATA), or set to false (0) to disable rainfall stochasticity. |
{
"Enable_Climate_Stochasticity": 1,
"Air_Temperature_Variance": 2,
"Enable_Rainfall_Stochasticity": 1,
"Land_Temperature_Variance": 2,
"Relative_Humidity_Variance": 0.05
}
|
Koppen_Filename |
string |
NA |
NA |
koppen_climate.json |
The path to the input file used to specify Koppen climate classifications. Climate_Model must be set to CLIMATE_KOPPEN. |
{
"Koppen_Filename": "Mad_2_5arcminute_koppen.dat"
}
|
Land_Temperature_Filename |
string |
NA |
NA |
land_temp.json |
The path of the input file defining temperature data measured at land surface; used only when Climate_Model is set to CLIMATE_BY_DATA. The file must be in .bin format. |
{
"Land_Temperature_Filename": "Namawala_single_node_land_temperature_daily.bin"
}
|
Land_Temperature_Offset |
float |
-20 |
20 |
0 |
The linear shift of land surface temperature in degrees Celsius; only used when Climate_Model is set to CLIMATE_BY_DATA. |
{
"Land_Temperature_Offset": 0
}
|
Land_Temperature_Variance |
float |
0 |
7 |
2 |
The standard deviation (in degrees Celsius) for normally distributed noise applied to the daily land temperature values when Climate_Model is configured to CLIMATE_CONSTANT or CLIMATE_BY_DATA; only used if the Enable_Climate_Stochasticity is set to true (1). |
{
"Land_Temperature_Variance": 1.5
}
|
Node_Grid_Size |
float |
0.00416 |
90 |
0.004167 |
The spatial resolution indicating the node grid size for a simulation in degrees. |
{
"Node_Grid_Size": 0.042
}
|
Rainfall_Filename |
string |
NA |
NA |
rainfall.json |
The path of the input file which defines rainfall data. Climate_Model must be set to CLIMATE_BY_DATA. The file must be in .bin format. |
{
"Rainfall_Filename": "Namawala_single_node_rainfall_daily.bin"
}
|
Rainfall_Scale_Factor |
float |
0.1 |
10 |
1 |
The scale factor used in multiplying rainfall value(s). Climate_Model must be set to CLIMATE_BY_DATA. |
{
"Rainfall_Scale_Factor": 1
}
|
Relative_Humidity_Filename |
string |
NA |
NA |
rel_hum.json |
The path of the input file which defines relative humidity data measured 2 meters above ground. Climate_Model must be set to CLIMATE_BY_DATA. The file must be in .bin format. |
{
"Relative_Humidity_Filename": "Namawala_single_node_relative_humidity_daily.bin"
}
|
Relative_Humidity_Scale_Factor |
float |
0.1 |
10 |
1 |
The scale factor used in multiplying relative humidity values. Climate_Model must be set to CLIMATE_BY_DATA. |
{
"Relative_Humidity_Scale_Factor": 1
}
|
Relative_Humidity_Variance |
float |
0 |
0.12 |
0.05 |
The standard deviation (in percentage) for normally distributed noise applied to the daily relative humidity values when Climate_Model is configured as CLIMATE_CONSTANT or CLIMATE_BY_DATA. Enable_Climate_Stochasticity must be set to true (1). |
{
"Relative_Humidity_Variance": 0.05
}
|
Immunity¶
The following parameters determine the immune system response for the disease being modeled, including waning immunity after an infection clears.
Parameter |
Data type |
Minimum |
Maximum |
Default |
Description |
Example |
---|---|---|---|---|---|---|
Acquisition_Blocking_Immunity_Decay_Rate |
float |
0 |
1 |
0.001 |
The rate at which acquisition-blocking immunity decays after the initial period indicated by the base acquisition-blocking immunity offset. Only used when Enable_Immunity and Enable_Immune_Decay parameters are set to true (1). |
{
"Acquisition_Blocking_Immunity_Decay_Rate": 0.05
}
|
Acquisition_Blocking_Immunity_Duration_Before_Decay |
float |
0 |
45000 |
0 |
The number of days after infection until acquisition-blocking immunity begins to decay. Enable_Immunity and Enable_Immune_Decay must be set to true (1). |
{
"Acquisition_Blocking_Immunity_Duration_Before_Decay": 10
}
|
Enable_Immune_Decay |
boolean |
0 |
1 |
1 |
Controls whether or not immunity decays after an infection clears. Set to true (1) if immunity decays; set to false (0) if recovery from the disease confers complete immunity for life. Enable_Immunity must be set to true (1). This parameter should always be set to 0 (off) in this simulation type. |
{
"Enable_Immunity": 1,
"Enable_Immune_Decay": 0
}
|
Enable_Initial_Susceptibility_Distribution |
boolean |
0 |
1 |
0 |
Controls whether or not individuals in the population have immunity at the beginning of the simulation. If set to 0, individuals are not initialized with immunity but may acquire immunity. If set to 1, you must indicate the type of distribution to use for immunity in the configuration parameter Immunity_Initialization_Distribution_Type and the distribution values in the demographics file. Enable_Immunity must be set to 1. |
{
"Enable_Immunity": 1,
"Enable_Initial_Susceptibility_Distribution": 1,
"Immunity_Initialization_Distribution_Type": "DISTRIBUTION_SIMPLE"
}
|
Enable_Maternal_Protection |
boolean |
0 |
1 |
0 |
Controls whether or not mothers pass immunity on to their infants. Setting to 1 (true) enables maternal protection as defined by Maternal_Protection_Type. Enable_Birth must be set to 1 (true). |
{
"Enable_Maternal_Protection": 1,
"Maternal_Protection_Type": "LINEAR_FRACTIONAL"
}
|
Immune_Threshold_For_Downsampling |
float |
0 |
1 |
0 |
The threshold on acquisition immunity at which to apply immunity-dependent downsampling; individuals who are more immune than this this threshold are downsampled. A value of 1 is equivalent to full susceptibility and 0 is equivalent to full immunity. If the acquisition immunity modifier is larger than the threshold, no downsampling occurs. Individual_Sampling_Type must set to ADAPTED_SAMPLING_BY_IMMUNE_STATE. |
{
"Relative_Sample_Rate_Immune": 0.1,
"Immune_Threshold_For_Downsampling": 0.5,
"Individual_Sampling_Type": "ADAPTED_SAMPLING_BY_IMMUNE_STATE"
}
|
Maternal_Linear_Slope |
float |
0.0001 |
1 |
0.01 |
Slope parameter describing the rate of waning for maternal protection, must be positive. The per-day increase in susceptibility. Maternal_Protection_Type must be set to LINEAR_FRACTIONAL or LINEAR_BINARY. |
{
"Maternal_Protection_Type": "LINEAR_FRACTIONAL",
"Maternal_Linear_SusZero": 0.45,
"Maternal_Linear_Slope": 0.02
}
|
Maternal_Linear_SusZero |
float |
0 |
1 |
0.2 |
The initial level of maternal protection at age 0, given as susceptibility. A value of 0.0 implies total protection, a value of 1.0 implies no protection. Maternal_Protection_Type must be set to LINEAR_FRACTIONAL or LINEAR_BINARY. |
{
"Maternal_Protection_Type": "LINEAR_FRACTIONAL",
"Maternal_Linear_SusZero": 0.45,
"Maternal_Linear_Slope": 0.02
}
|
Maternal_Protection_Type |
enum |
NA |
NA |
NONE |
The type of maternal protection afforded to infants. Enable_Maternal_Protection must be set to 1 (true). Possible values are:
You must set Susceptibility_Type to determine if susceptibility at a particular age is interpreted as a fractional value or the probability of complete immunity or susceptibility. |
{
"Enable_Maternal_Protection": 1,
"Maternal_Protection_Type": "LINEAR_FRACTIONAL"
}
|
Maternal_Sigmoid_HalfMaxAge |
float |
-270 |
3650 |
180 |
The age in days that the level of maternal protection is half of its initial value. Maternal_Protection_Type must be set to SIGMOID_FRACTIONAL or SIGMOID_BINARY. |
{
"Maternal_Protection_Type": "SIGMOID_BINARY",
"Maternal_Sigmoid_SteepFac": 30,
"Maternal_Sigmoid_HalfMaxAge": 365,
"Maternal_Sigmoid_SusInit": 0.0002
}
|
Maternal_Sigmoid_SteepFac |
float |
0.1 |
1000 |
30 |
The steepness factor describing the rate of waning for maternal protection, must be positive. Small values imply rapid waning.**Maternal_Protection_Type** must be set to SIGMOID_FRACTIONAL or SIGMOID_BINARY. |
{
"Maternal_Protection_Type": "SIGMOID_BINARY",
"Maternal_Sigmoid_SteepFac": 30,
"Maternal_Sigmoid_HalfMaxAge": 365,
"Maternal_Sigmoid_SusInit": 0.0002
}
|
Maternal_Sigmoid_SusInit |
float |
0 |
1 |
0 |
The initial level of maternal protection at age -INF, given as susceptibility. A value of 0.0 implies total protection, a value of 1.0 implies no protection. Maternal_Protection_Type must be set to SIGMOID_FRACTIONAL or SIGMOID_BINARY. |
{
"Maternal_Protection_Type": "SIGMOID_BINARY",
"Maternal_Sigmoid_SteepFac": 30,
"Maternal_Sigmoid_HalfMaxAge": 365,
"Maternal_Sigmoid_SusInit": 0.0002
}
|
Mortality_Blocking_Immunity_Decay_Rate |
float |
0 |
1 |
0.001 |
The rate at which mortality-blocking immunity decays after the mortality-blocking immunity offset period. Enable_Immune_Decay must be set to 1. |
{
"Mortality_Blocking_Immunity_Decay_Rate": 0.1
}
|
Mortality_Blocking_Immunity_Duration_Before_Decay |
float |
0 |
45000 |
0 |
The number of days after infection until mortality-blocking immunity begins to decay. Enable_Immunity and Enable_Immune_Decay must be set to 1. |
{
"Mortality_Blocking_Immunity_Duration_Before_Decay": 270
}
|
Post_Infection_Acquisition_Multiplier |
float |
0 |
1 |
0 |
The multiplicative reduction in the probability of reacquiring disease. At the time of recovery, the immunity against acquisition is multiplied by Acquisition_Blocking_Immunity_Decay_Rate x (1 - Post_Infection_Acquisition_Multiplier). Enable_Immunity must be set to 1 (true). |
{
"Enable_Immunity": 1,
"Enable_Immune_Decay": 1,
"Post_Infection_Acquisition_Multiplier": 0.9
}
|
Post_Infection_Mortality_Multiplier |
float |
0 |
1 |
0 |
The multiplicative reduction in the probability of dying from infection after getting reinfected. At the time of recovery, the immunity against mortality is multiplied by Mortality_Blocking_Immunity_Decay_Rate x (1 - Post_Infection_Mortality_Multiplier). Enable_Immunity must be set to 1 (true). |
{
"Enable_Immunity": 1,
"Enable_Immune_Decay": 1,
"Post_Infection_Mortality_Multiplier": 0.5
}
|
Post_Infection_Transmission_Multiplier |
float |
0 |
1 |
0 |
The multiplicative reduction in the probability of transmitting infection after getting reinfected. At the time of recovery, the immunity against transmission is multiplied by Transmission_Blocking_Immunity_Decay_Rate x (1 - Post_Infection_Transmission_Multiplier). Enable_Immunity must be set to 1 (true). |
{
"Enable_Immunity": 1,
"Enable_Immunity_Decay": 1,
"Post_Infection_Transmission_Multiplier": 0.9
}
|
Susceptibility_Initialization_Distribution_Type |
enum |
NA |
NA |
DISTRIBUTION_OFF |
The method for initializing the susceptibility distribution in the simulated population. Enable_Initial_Susceptibility_Distribution must be set to 1 (true). Possible values are:
|
{
"Enable_Immunity": 1,
"Enable_Initial_Susceptibility_Distribution": 1,
"Susceptibility_Initialization_Distribution_Type": "DISTRIBUTION_COMPLEX"
}
|
Transmission_Blocking_Immunity_Decay_Rate |
float |
0 |
1000 |
0.001 |
The rate at which transmission-blocking immunity decays after the base transmission-blocking immunity offset period. Used only when Enable_Immunity and Enable_Immune_Decay parameters are set to true (1). |
{
"Transmission_Blocking_Immunity_Decay_Rate": 0.01
}
|
Transmission_Blocking_Immunity_Duration_Before_Decay |
float |
0 |
45000 |
0 |
The number of days after infection until transmission-blocking immunity begins to decay. Only used when Enable_Immunity and Enable_Immune_Decay parameters are set to true (1). |
{
"Transmission_Blocking_Immunity_Duration_Before_Decay": 90
}
|
Typhoid_3year_Susceptible_Fraction |
float |
0 |
1 |
0.5 |
Proportion of immune population at 3 years that moves to susceptible state. |
{
"Typhoid_3year_Susceptible_Fraction": 0.5
}
|
Typhoid_6month_Susceptible_Fraction |
float |
0 |
1 |
0.5 |
Proportion of immune population at 6 months that moves to susceptible state. |
{
"Typhoid_6month_Susceptible_Fraction": 0.5
}
|
Typhoid_6year_Susceptible_Fraction |
float |
0 |
1 |
0.5 |
Proportion of immune population of 6 year olds that moves to susceptible state. |
{
"Typhoid_6year_Susceptible_Fraction": 0.5
}
|
Incubation¶
The following parameters determine the characteristics of the incubation period.
Parameter |
Data type |
Minimum |
Maximum |
Default |
Description |
Example |
---|---|---|---|---|---|---|
Incubation_Period_Constant |
float |
0 |
3.40282E+38 |
6 |
The incubation period to use for all individuals. |
{
"Incubation_Period_Distribution": "CONSTANT_DISTRIBUTION",
"Incubation_Period_Constant": 8
}
|
Incubation_Period_Distribution |
enum |
NA |
NA |
NOT_INITIALIZED |
The distribution type to use for assigning the incubation period to each individual in the population. Each individual’s value is a random draw from the distribution. Possible values are:
|
{
"Incubation_Period_Distribution": "GAUSSIAN_DISTRIBUTION",
"Incubation_Period_Gaussian_Mean": 8,
"Incubation_Period_Gaussian_Std_Dev": 1.5
}
|
Incubation_Period_Exponential |
float |
0 |
3.40282E+38 |
6 |
The mean incubation period when Incubation_Period_Distribution is set to EXPONENTIAL_DISTRIBUTION. |
{
"Incubation_Period_Distribution": "EXPONENTIAL_DISTRIBUTION",
"Incubation_Period_Exponential": 4.25
}
|
Incubation_Period_Gaussian_Mean |
float |
0 |
3.40282E+38 |
6 |
The mean of the incubation period when Incubation_Period_Distribution is set to GAUSSIAN_DISTRIBUTION. |
{
"Incubation_Period_Distribution": "GAUSSIAN_DISTRIBUTION",
"Incubation_Period_Gaussian_Mean": 8,
"Incubation_Period_Gaussian_Std_Dev": 1.5
}
|
Incubation_Period_Gaussian_Std_Dev |
float |
1.17549E-38 |
3.40282E+38 |
1 |
The standard deviation of the incubation period when Incubation_Period_Distribution is set to GAUSSIAN_DISTRIBUTION. |
{
"Incubation_Period_Distribution": "GAUSSIAN_DISTRIBUTION",
"Incubation_Period_Gaussian_Mean": 8,
"Incubation_Period_Gaussian_Std_Dev": 1.5
}
|
Incubation_Period_Kappa |
float |
1.17549E-38 |
3.40282E+38 |
1 |
The shape value for the incubation period when Incubation_Period_Distribution is set to WEIBULL_DISTRIBUTION. |
{
"Incubation_Period_Distribution": "WEIBULL_DISTRIBUTION",
"Incubation_Period_Kappa": 0.9,
"Incubation_Period_Lambda": 1.5
}
|
Incubation_Period_Lambda |
float |
1.17549E-38 |
3.40282E+38 |
1 |
The scale value for the incubation period when Incubation_Period_Distribution is set to WEIBULL_DISTRIBUTION. |
{
"Incubation_Period_Distribution": "WEIBULL_DISTRIBUTION",
"Incubation_Period_Kappa": 0.9,
"Incubation_Period_Lambda": 1.5
}
|
Incubation_Period_Log_Normal_Mu |
float |
1.17549E-38 |
3.40282E+38 |
6 |
The mean of the natural log of the incubation period when Incubation_Period_Distribution is set to LOG_NORMAL_DISTRIBUTION. |
{
"Incubation_Period_Distribution": "LOG_NORMAL_DISTRIBUTION",
"Incubation_Period_Log_Normal_Mu": 4,
"Incubation_Period_Log_Normal_Sigma": 1
}
|
Incubation_Period_Log_Normal_Sigma |
float |
1.17549E-38 |
3.40282E+38 |
1 |
The standard deviation of the natural log of the incubation period when Incubation_Period_Distribution is set to LOG_NORMAL_DISTRIBUTION. |
{
"Incubation_Period_Distribution": "LOG_NORMAL_DISTRIBUTION",
"Incubation_Period_Log_Normal_Mu": 4,
"Incubation_Period_Log_Normal_Sigma": 1
}
|
Incubation_Period_Max |
float |
0 |
3.40282E+38 |
1 |
The maximum incubation period when Incubation_Period_Distribution is set to UNIFORM_DISTRIBUTION. |
{
"Incubation_Period_Distribution": "UNIFORM_DISTRIBUTION",
"Incubation_Period_Min": 2,
"Incubation_Period_Max": 7
}
|
Incubation_Period_Mean_1 |
float |
1.17549E-38 |
3.40282E+38 |
1 |
The mean of the first exponential distribution when Incubation_Period_Distribution is set to DUAL_EXPONENTIAL_DISTRIBUTION. |
{
"Incubation_Period_Distribution": "DUAL_EXPONENTIAL_DISTRIBUTION",
"Incubation_Period_Mean_1": 4,
"Incubation_Period_Mean_2": 12,
"Incubation_Period_Proportion_1": 0.2
}
|
Incubation_Period_Mean_2 |
float |
1.17549E-38 |
3.40282E+38 |
1 |
The mean of the second exponential distribution when Incubation_Period_Distribution is set to DUAL_EXPONENTIAL_DISTRIBUTION. |
{
"Incubation_Period_Distribution": "DUAL_EXPONENTIAL_DISTRIBUTION",
"Incubation_Period_Mean_1": 4,
"Incubation_Period_Mean_2": 12,
"Incubation_Period_Proportion_1": 0.2
}
|
Incubation_Period_Min |
float |
0 |
3.40282E+38 |
0 |
The minimum incubation period when Incubation_Period_Distribution is set to UNIFORM_DISTRIBUTION. |
{
"Incubation_Period_Distribution": "UNIFORM_DISTRIBUTION",
"Incubation_Period_Min": 2,
"Incubation_Period_Max": 7
}
|
Incubation_Period_Peak_2_Value |
float |
0 |
3.40282E+38 |
1 |
The incubation period value to assign to the remaining individuals when Incubation_Period_Distribution is set to DUAL_CONSTANT_DISTRIBUTION. |
{
"Incubation_Period_Distribution": "DUAL_CONSTANT_DISTRIBUTION",
"Incubation_Period_Proportion_0": 0.25,
"Incubation_Period_Peak_2_Value": 5
}
|
Incubation_Period_Poisson_Mean |
float |
0 |
3.40282E+38 |
6 |
The mean of the incubation period when Incubation_Period_Distribution is set to POISSON_DISTRIBUTION. |
{
"Incubation_Period_Distribution": "POISSON_DISTRIBUTION",
"Incubation_Period_Poisson_Mean": 5
}
|
Incubation_Period_Proportion_0 |
float |
0 |
1 |
1 |
The proportion of individuals to assign a value of zero days incubation when Incubation_Period_Distribution is set to DUAL_CONSTANT_DISTRIBUTION. |
{
"Incubation_Period_Distribution": "DUAL_CONSTANT_DISTRIBUTION",
"Incubation_Period_Proportion_0": 0.25,
"Incubation_Period_Peak_2_Value": 5
}
|
Incubation_Period_Proportion_1 |
float |
0 |
1 |
1 |
The proportion of individuals in the first exponential distribution when Incubation_Period_Distribution is set to DUAL_EXPONENTIAL_DISTRIBUTION. |
{
"Incubation_Period_Distribution": "DUAL_EXPONENTIAL_DISTRIBUTION",
"Incubation_Period_Mean_1": 4,
"Incubation_Period_Mean_2": 12,
"Incubation_Period_Proportion_1": 0.2
}
|
Symptomatic_Infectious_Offset |
float |
-3.40282e+38 |
3.40282e+38 |
3.40282e+38 |
Amount of time, in days, after the infectious period starts that symptoms appear. Negative values imply an individual is symptomatic before infectious. If this offset is greater than the infectious duration, the infection will not be symptomatic. For example, if Incubation_Period_Constant is set to 10 and Symptomatic_Infectious_Offset is set to 4, then an infected person would become symptomatic 14 days after transmission. |
{
"Infectious_Period_Distribution": "CONSTANT_DISTRIBUTION",
"Symptomatic_Infectious_Offset": 4,
"Incubation_Period_Constant": 10
}
|
Infectivity and transmission¶
The following parameters determine aspects of infectivity and disease transmission. For example, how infectious individuals are and the length of time for which they remain infectious, whether the disease can be maternally transmitted, and how population density affects infectivity.
Parameter |
Data type |
Minimum |
Maximum |
Default |
Description |
Example |
---|---|---|---|---|---|---|
Base_Infectivity |
float |
0 |
1000 |
0.3 |
The base infectiousness of individuals before accounting for transmission-blocking effects of acquired immunity and/or campaign interventions. For environmental simulations, this is the probability of infecting an individual through the contact and environmental routes. This parameter is not used. |
{
"Base_Infectivity": 0.5
}
|
Enable_Heterogeneous_Intranode_Transmission |
boolean |
0 |
1 |
0 |
Controls whether or not individuals experience heterogeneous disease transmission within a node. When set to true (1), individual property definitions and the \(\beta\) matrix must be specified in the demographics file (see NodeProperties and IndividualProperties parameters). The \(\beta\) values are multiplied with the \(\beta\) 0 value configured by Base_Infectivity. This is used only in generic simulations, but must be set to false (0) for all other simulation types. Heterogeneous transmission for other diseases uses other mechanistic parameters included with the simulation type. |
{
"Enable_Heterogeneous_Intranode_Transmission": 1
}
|
Enable_Skipping |
boolean |
0 |
1 |
0 |
Controls whether or not the simulation uses an optimization that can increase performance by up to 50% in some cases by probablistically exposing individuals rather than exposing every single person. Useful in low-prevalence, high-population scenarios. Infectivity_Scale_Type must be set to CONSTANT_INFECTIVITY. |
{
"Exposure_Skipping": 1
}
|
Enable_Susceptibility_Scaling |
boolean |
0 |
1 |
0 |
Controls whether or not susceptibility is scaled by time as defined by Susceptibility_Scaling_Type. |
{
"Enable_Susceptibility_Scaling": 1,
"Susceptibility_Scaling_Type": "LOG_LINEAR_FUNCTION_OF_TIME"
}
|
Enable_Termination_On_Zero_Total_Infectivity |
boolean |
0 |
1 |
0 |
Controls whether or not the simulation should be ended when total infectivity falls to zero. Supported only in single-node simulations. |
{
"Enable_Termination_On_Zero_Total_Infectivity": 1,
"Minimum_End_Time": 3650
}
|
Environmental_Cutoff_Days |
float |
0 |
365 |
2 |
Duration, in days, in which environmental exposure halts during the low season. |
{
"Environmental_Cutoff_Days": 2
}
|
Environmental_Peak_Start |
float |
0 |
500 |
2 |
The day of the year at which the environmental exposure reaches its peak. |
{
"Environmental_Peak_Start": 2
}
|
Environmental_Ramp_Down_Duration |
float |
0 |
270 |
2 |
Duration, in days, of the period over which the environmental exposure route descreases seasonally. |
{
"Environmental_Ramp_Down_Duration": 2
}
|
Environmental_Ramp_Up_Duration |
float |
0 |
200 |
2 |
Duration, in days, of the period over which the environmental exposure route increases seasonally. |
{
"Environmental_Ramp_Up_Duration": 2
}
|
Infection_Updates_Per_Timestep |
integer |
0 |
144 |
1 |
The number of infection updates executed during each timestep; note that a timestep defaults to one day. |
{
"Infection_Updates_Per_Timestep": 1
}
|
Infectious_Period_Constant |
float |
0 |
3.40282E+38 |
6 |
The infectious period to use for all individuals. |
{
"Infectious_Period_Distribution": "CONSTANT_DISTRIBUTION",
"Infectious_Period_Constant": 8
}
|
Infectious_Period_Distribution |
enum |
NA |
NA |
NOT_INITIALIZED |
The distribution type to use for assigning the infectious period to each individual in the population. Each individual’s value is a random draw from the distribution. Possible values are:
|
{
"Infectious_Period_Distribution": "GAUSSIAN_DISTRIBUTION",
"Infectious_Period_Gaussian_Mean": 4,
"Infectious_Period_Gaussian_Std_Dev": 1
}
|
Infectious_Period_Exponential |
float |
0 |
3.40282E+38 |
6 |
The mean infectious period when Infectious_Period_Distribution is set to EXPONENTIAL_DISTRIBUTION. |
{
"Infectious_Period_Distribution": "EXPONENTIAL_DISTRIBUTION",
"Infectious_Period_Exponential": 4.25
}
|
Infectious_Period_Gaussian_Mean |
float |
0 |
3.40282E+38 |
6 |
The mean of the infectious period when Infectious_Period_Distribution is set to GAUSSIAN_DISTRIBUTION. |
{
"Infectious_Period_Distribution": "GAUSSIAN_DISTRIBUTION",
"Infectious_Period_Gaussian_Mean": 4,
"Infectious_Period_Gaussian_Std_Dev": 1
}
|
Infectious_Period_Gaussian_Std_Dev |
float |
1.17549E-38 |
3.40282E+38 |
1 |
The standard deviation of the infectious period when Infectious_Period_Distribution is set to GAUSSIAN_DISTRIBUTION. |
{
"Infectious_Period_Distribution": "GAUSSIAN_DISTRIBUTION",
"Infectious_Period_Gaussian_Mean": 4,
"Infectious_Period_Gaussian_Std_Dev": 1
}
|
Infectious_Period_Kappa |
float |
1.17549E-38 |
3.40282E+38 |
1 |
The shape value for the infectious period when Infectious_Period_Distribution is set to WEIBULL_DISTRIBUTION. |
{
"Infectious_Period_Distribution": "WEIBULL_DISTRIBUTION",
"Infectious_Period_Kappa": 0.9,
"Infectious_Period_Lambda": 1.5
}
|
Infectious_Period_Lambda |
float |
1.17549E-38 |
3.40282E+38 |
1 |
The scale value for the infectious period when Infectious_Period_Distribution is set to WEIBULL_DISTRIBUTION. |
{
"Infectious_Period_Distribution": "WEIBULL_DISTRIBUTION",
"Infectious_Period_Kappa": 0.9,
"Infectious_Period_Lambda": 1.5
}
|
Infectious_Period_Log_Normal_Mu |
float |
1.17549E-38 |
3.40282E+38 |
6 |
The mean of the natural log of the infectious period when Infectious_Period_Distribution is set to LOG_NORMAL_DISTRIBUTION. |
{
"Infectious_Period_Distribution": "LOG_NORMAL_DISTRIBUTION",
"Infectious_Period_Log_Normal_Mu": 9,
"Infectious_Period_Log_Normal_Sigma": 2
}
|
Infectious_Period_Log_Normal_Sigma |
float |
1.17549E-38 |
3.40282E+38 |
1 |
The standard deviation of the natural log of the infectious period when Infectious_Period_Distribution is set to LOG_NORMAL_DISTRIBUTION. |
{
"Infectious_Period_Distribution": "LOG_NORMAL_DISTRIBUTION",
"Infectious_Period_Log_Normal_Mu": 9,
"Infectious_Period_Log_Normal_Sigma": 2
}
|
Infectious_Period_Max |
float |
0 |
3.40282E+38 |
1 |
The maximum infectious period when Infectious_Period_Distribution is set to UNIFORM_DISTRIBUTION. |
{
"Infectious_Period_Distribution": "UNIFORM_DISTRIBUTION",
"Infectious_Period_Min": 2,
"Infectious_Period_Max": 7
}
|
Infectious_Period_Mean_1 |
float |
1.17549E-38 |
3.4E+38 |
1 |
The mean of the first exponential distribution when Infectious_Period_Distribution is set to DUAL_EXPONENTIAL_DISTRIBUTION. |
{
"Infectious_Period_Distribution": "DUAL_EXPONENTIAL_DISTRIBUTION",
"Infectious_Period_Mean_1": 4,
"Infectious_Period_Mean_2": 12,
"Infectious_Period_Proportion_1": 0.2
}
|
Infectious_Period_Mean_2 |
float |
1.17549E-38 |
3.40282E+38 |
1 |
The mean of the second exponential distribution when Infectious_Period_Distribution is set to DUAL_EXPONENTIAL_DISTRIBUTION. |
{
"Infectious_Period_Distribution": "DUAL_EXPONENTIAL_DISTRIBUTION",
"Infectious_Period_Mean_1": 4,
"Infectious_Period_Mean_2": 12,
"Infectious_Period_Proportion_1": 0.2
}
|
Infectious_Period_Min |
float |
0 |
3.40282E+38 |
0 |
The minimum infectious period when Infectious_Period_Distribution is set to UNIFORM_DISTRIBUTION. |
{
"Infectious_Period_Distribution": "UNIFORM_DISTRIBUTION",
"Infectious_Period_Min": 2,
"Infectious_Period_Max": 7
}
|
Infectious_Period_Peak_2_Value |
float |
0 |
3.40282E+38 |
1 |
The infectious period value to assign to the remaining individuals when Infectious_Period_Distribution is set to DUAL_CONSTANT_DISTRIBUTION. |
{
"Infectious_Period_Distribution": "DUAL_CONSTANT_DISTRIBUTION",
"Infectious_Period_Proportion_0": 0.25,
"Infectious_Period_Peak_2_Value": 5
}
|
Infectious_Period_Poisson_Mean |
float |
0 |
3.40282E+38 |
6 |
The mean of the infectious period with Infectious_Period_Distribution is set to POISSON_DISTRIBUTION. |
{
"Infectious_Period_Distribution": "POISSON_DISTRIBUTION",
"Infectious_Period_Poisson_Mean": 5
}
|
Infectious_Period_Proportion_0 |
float |
0 |
1 |
1 |
The proportion of individuals to assign a value of zero days infectiousness when Infectious_Period_Distribution is set to DUAL_CONSTANT_DISTRIBUTION. |
{
"Infectious_Period_Distribution": "DUAL_CONSTANT_DISTRIBUTION",
"Infectious_Period_Proportion_0": 0.25,
"Infectious_Period_Peak_2_Value": 5
}
|
Infectious_Period_Proportion_1 |
float |
0 |
1 |
1 |
The proportion of individuals in the first exponential distribution when Infectious_Period_Distribution is set to DUAL_EXPONENTIAL_DISTRIBUTION. |
{
"Infectious_Period_Distribution": "DUAL_EXPONENTIAL_DISTRIBUTION",
"Infectious_Period_Mean_1": 4,
"Infectious_Period_Mean_2": 12,
"Infectious_Period_Proportion_1": 0.2
}
|
Infectivity_Boxcar_Forcing_Amplitude |
float |
0 |
3.40E+38 |
0 |
The fractional increase in R0 during the high-infectivity season when Infectivity_Scale_Type is equal to ANNUAL_BOXCAR_FUNCTION. |
{
"Infectivity_Boxcar_Forcing_Amplitude": 0.25,
"Infectivity_Boxcar_Forcing_End_Time": 270,
"Infectivity_Boxcar_Forcing_Start_Time": 90,
"Infectivity_Scale_Type": "ANNUAL_BOXCAR_FUNCTION"
}
|
Infectivity_Boxcar_Forcing_End_Time |
float |
0 |
365 |
0 |
The end of the high-infectivity season when Infectivity_Scale_Type is equal to ANNUAL_BOXCAR_FUNCTION. |
{
"Infectivity_Boxcar_Forcing_Amplitude": 0.25,
"Infectivity_Boxcar_Forcing_End_Time": 270,
"Infectivity_Boxcar_Forcing_Start_Time": 90,
"Infectivity_Scale_Type": "ANNUAL_BOXCAR_FUNCTION"
}
|
Infectivity_Boxcar_Forcing_Start_Time |
float |
0 |
365 |
0 |
The beginning of the high-infectivity season, in days, when Infectivity_Scale_Type is equal to ANNUAL_BOXCAR_FUNCTION. |
{
"Infectivity_Boxcar_Forcing_Amplitude": 0.25,
"Infectivity_Boxcar_Forcing_End_Time": 270,
"Infectivity_Boxcar_Forcing_Start_Time": 90,
"Infectivity_Scale_Type": "ANNUAL_BOXCAR_FUNCTION"
}
|
Infectivity_Exponential_Baseline |
float |
0 |
1 |
0 |
The scale factor applied to Base_Infectivity at the beginning of a simulation, before the infectivity begins to grow exponentially. Infectivity_Scale_Type must be set to EXPONENTIAL_FUNCTION_OF_TIME. |
{
"Infectivity_Exponential_Baseline": 0.1,
"Infectivity_Exponential_Delay": 90,
"Infectivity_Exponential_Rate": 45,
"Infectivity_Scale_Type": "EXPONENTIAL_FUNCTION_OF_TIME"
}
|
Infectivity_Exponential_Delay |
float |
0 |
3.40E+38 |
0 |
The number of days before infectivity begins to ramp up exponentially. Infectivity_Scale_Type must be set to EXPONENTIAL_FUNCTION_OF_TIME. |
{
"Infectivity_Exponential_Baseline": 0.1,
"Infectivity_Exponential_Delay": 90,
"Infectivity_Exponential_Rate": 45,
"Infectivity_Scale_Type": "EXPONENTIAL_FUNCTION_OF_TIME"
}
|
Infectivity_Exponential_Rate |
float |
0 |
3.40E+38 |
0 |
The daily rate of exponential growth to approach to full infectivity after the delay set by Infectivity_Exponential_Delay has passed. Infectivity_Scale_Type must be set to EXPONENTIAL_FUNCTION_OF_TIME. |
{
"Infectivity_Exponential_Rate": 45
}
|
Infectivity_Scale_Type |
enum |
NA |
NA |
CONSTANT_INFECTIVITY |
A scale factor that allows infectivity to be altered by time or season. Possible values are:
|
{
"Infectivity_Scale_Type": "FUNCTION_OF_CLIMATE"
}
|
Infectivity_Sinusoidal_Forcing_Amplitude |
float |
0 |
1 |
0 |
Sets the amplitude of sinusoidal variations in Base_Infectivity. Only used when Infectivity_Scale_Type is set to SINUSOIDAL_FUNCTION_OF_TIME. |
{
"Infectivity_Scale_Type": "SINUSOIDAL_FUNCTION_OF_TIME",
"Infectivity_Sinusoidal_Forcing_Amplitude": 0.1,
"Infectivity_Sinusoidal_Forcing_Phase": 0
}
|
Infectivity_Sinusoidal_Forcing_Phase |
float |
0 |
365 |
0 |
Sets the phase of sinusoidal variations in Base_Infectivity. Only used when Infectivity_Scale_Type is set to SINUSOIDAL_FUNCTION_OF_TIME. |
{
"Infectivity_Scale_Type": "SINUSOIDAL_FUNCTION_OF_TIME",
"Infectivity_Sinusoidal_Forcing_Amplitude": 0.1,
"Infectivity_Sinusoidal_Forcing_Phase": 0
}
|
Maternal_Infection_Transmission_Probability |
float |
0 |
1 |
0 |
The probability of transmission of infection from mother to infant at birth. Enable_Maternal_Infection_Transmission must be set to 1. Note For malaria and vector simulations, set this to 0. Instead, use the Maternal_Antibody_Protection, Maternal_Antibody_Decay_Rate, and Maternal_Antibodies_Type parameters. |
{
"Maternal_Infection_Transmission_Probability": 0.3
}
|
Max_Individual_Infections |
integer |
0 |
1000 |
1 |
The limit on the number of infections that an individual can have simultaneously. Enable_Superinfection must be set to 1. |
{
"Max_Individual_Infections": 5
}
|
Population_Density_C50 |
float |
0 |
3.40E+38 |
10 |
The population density at which R0 for a 2.5-arc minute square reaches half of its initial value. Population_Density_Infectivity_Correction must be set to SATURATING_FUNCTION_OF_DENSITY. |
{
"Population_Density_C50": 30
}
|
Population_Density_Infectivity_Correction |
enum |
NA |
NA |
CONSTANT_INFECTIVITY |
Correction to alter infectivity by population density set in the Population_Density_C50 parameter. Measured in people per square kilometer. Possible values are:
Note Sparsely populated areas have a lower infectivity, while densely populated areas have a higher infectivity, which rises to saturate at the Base_Infectivity value. |
{
"Population_Density_Infectivity_Correction": "SATURATING_FUNCTION_OF_DENSITY"
}
|
Relative_Sample_Rate_Immune |
float |
0.001 |
1 |
0.1 |
The relative sampling rate for people who have acquired immunity through recovery or vaccination. The immune threshold at which to downsample is set by Immune_Threshold_For_Downsampling. If set to 1, this will have no effect, even if the individual’s immunity modifier is below threshold. This can be a useful sanity check while learning this feature. Individual_Sampling_Type must be set to ADAPTED_SAMPLING_BY_IMMUNE_STATE. |
{
"Relative_Sample_Rate_Immune": 0.1,
"Immune_Threshold_For_Downsampling": 0.8,
"Individual_Sampling_Type": "ADAPTED_SAMPLING_BY_IMMUNE_STATE"
}
|
Susceptibility_Scaling_Rate |
float |
0 |
3.40282e+38 |
0 |
The scaling rate for the variation in time of the log-linear susceptibility scaling. Susceptibility_Scaling_Type must be set to LOG_LINEAR_FUNCTION_OF_TIME. |
{
"Susceptibility_Scaling_Type": "LOG_LINEAR_FUNCTION_OF_TIME",
"Susceptibility_Scaling_Rate": 1.58
}
|
Susceptibility_Scaling_Type |
enum |
NA |
NA |
CONSTANT_SUSCEPTIBILITY |
The effect of time on susceptibility. Possible values are:
|
{
"Susceptibility_Scaling_Type": "CONSTANT_SUSCEPTIBILITY"
}
|
Symptomatic_Infectious_Offset |
float |
-3.40282e+38 |
3.40282e+38 |
3.40282e+38 |
Amount of time, in days, after the infectious period starts that symptoms appear. Negative values imply an individual is symptomatic before infectious. If this offset is greater than the infectious duration, the infection will not be symptomatic. For example, if Incubation_Period_Constant is set to 10 and Symptomatic_Infectious_Offset is set to 4, then an infected person would become symptomatic 14 days after transmission. |
{
"Infectious_Period_Distribution": "CONSTANT_DISTRIBUTION",
"Symptomatic_Infectious_Offset": 4,
"Incubation_Period_Constant": 10
}
|
Transmission_Blocking_Immunity_Decay_Rate |
float |
0 |
1000 |
0.001 |
The rate at which transmission-blocking immunity decays after the base transmission-blocking immunity offset period. Used only when Enable_Immunity and Enable_Immune_Decay parameters are set to true (1). |
{
"Transmission_Blocking_Immunity_Decay_Rate": 0.01
}
|
Transmission_Blocking_Immunity_Duration_Before_Decay |
float |
0 |
45000 |
0 |
The number of days after infection until transmission-blocking immunity begins to decay. Only used when Enable_Immunity and Enable_Immune_Decay parameters are set to true (1). |
{
"Transmission_Blocking_Immunity_Duration_Before_Decay": 90
}
|
Typhoid_3year_Susceptible_Fraction |
float |
0 |
1 |
0.5 |
Proportion of immune population at 3 years that moves to susceptible state. |
{
"Typhoid_3year_Susceptible_Fraction": 0.5
}
|
Typhoid_6month_Susceptible_Fraction |
float |
0 |
1 |
0.5 |
Proportion of immune population at 6 months that moves to susceptible state. |
{
"Typhoid_6month_Susceptible_Fraction": 0.5
}
|
Typhoid_6year_Susceptible_Fraction |
float |
0 |
1 |
0.5 |
Proportion of immune population of 6 year olds that moves to susceptible state. |
{
"Typhoid_6year_Susceptible_Fraction": 0.5
}
|
Typhoid_Acute_Infectiousness |
float |
0 |
1.00E+07 |
4000 |
Daily shedding into contact and environmental reservoirs in colony-forming units |
{
"Typhoid_Acute_Infectiousness": 4000
}
|
Typhoid_Carrier_Probability |
float |
0 |
1 |
0.25 |
The probability of becoming a chronic carrier after a subclinical or acute infection with gallstones. |
{
"Typhoid_Carrier_Probability": 0.15
}
|
Typhoid_Chronic_Relative_Infectiousness |
float |
0 |
1 |
1 |
Relative infectiousness of chronic carriers to acute infections. |
{
"Typhoid_Chronic_Relative_Infectiousness": 1
}
|
Typhoid_Contact_Exposure_Rate |
float |
0 |
100 |
0.5 |
Poisson rate determining daily number of exposures to the contact transmission route. |
{
"Typhoid_Contact_Exposure_Rate": 0.5
}
|
Typhoid_Environmental_Exposure_Rate |
float |
0 |
10 |
0.5 |
Poisson rate determining daily number of exposures to the environmental transmission route. |
{
"Typhoid_Environmental_Exposure_Rate": 0.5
}
|
Typhoid_Exposure_Lambda |
float |
-1 |
100 |
2 |
The average number of typhoid exposures during time period. |
{
"Typhoid_Exposure_Lambda": 2
}
|
Typhoid_Prepatent_Relative_Infectiousness |
float |
0 |
1 |
1 |
Relative infectiousness of prepatent infections to acute infections. |
{
"Typhoid_Prepatent_Relative_Infectiousness": 1
}
|
Typhoid_Protection_Per_Infection |
float |
0 |
1 |
0.1 |
Decrease in susceptibility per infection (exponential decrease). |
{
"Typhoid_Protection_Per_Infection": 0.1
}
|
Typhoid_Subclinical_Relative_Infectiousness |
float |
0 |
1 |
1 |
Relative infectiousness of subclinical infections to acute infections. |
{
"Typhoid_Subclinical_Relative_Infectiousness": 1
}
|
Typhoid_Symptomatic_Fraction |
float |
0 |
1 |
0.5 |
Proportion of prepatent cases that become acute vs. subclinical. |
{
"Typhoid_Symptomatic_Fraction": 0.5
}
|
Input files¶
The following parameters set the paths to the the campaign file and the input files for climate, migration, demographics, and load-balancing.
Parameter |
Data type |
Minimum |
Maximum |
Default |
Description |
Example |
---|---|---|---|---|---|---|
Air_Migration_Filename |
string |
NA |
NA |
The path to the input file that defines patterns of migration by airplane. Enable_Air_Migration must be set to true (1). The file must be in .bin format. |
{
"Migration_Model": "FIXED_RATE_MIGRATION",
"Enable_Air_Migration": 1,
"Air_Migration_Filename": "../Global_1degree_air_migration.bin"
}
|
|
Air_Temperature_Filename |
string |
NA |
NA |
air_temp.json |
The path to the input file that defines air temperature data measured two meters above ground. Climate_Model must be set to CLIMATE_BY_DATA. The file must be in .bin format. |
{
"Climate_Model": "CLIMATE_BY_DATA",
"Air_Temperature_Filename": "Namawala_single_node_air_temperature_daily.bin"
}
|
Campaign_Filename |
string |
NA |
NA |
The path to the campaign file. It is required when interventions are part of the simulation and Enable_Interventions is set to true (1). The file must be in .json format. |
{
"Enable_Interventions": 1,
"Campaign_Filename": "campaign.json"
}
|
|
Demographics_Filenames |
array of strings |
NA |
NA |
An array of the paths to demographics files containing information on the identity and demographics of the region to simulate. The files must be in .json format. Note that this parameter is only required when Enable_Demographics_Builtin is set to 0. |
{
"Demographics_Filenames": [
"Namawala_single_node_demographics.json",
"Namawala_demographics_overlay.json"
]
}
|
|
Family_Migration_Filename |
string |
NA |
NA |
The name of the binary file to use to configure family migration. Enable_Family_Migration must be set to true (1). The file must be in .bin format. |
{
"Migration_Model": "FIXED_RATE_MIGRATION",
"Enable_Family_Migration": 1,
"Family_Migration_Filename": "../inputs/family_migration.bin"
}
|
|
Koppen_Filename |
string |
NA |
NA |
koppen_climate.json |
The path to the input file used to specify Koppen climate classifications. Climate_Model must be set to CLIMATE_KOPPEN. |
{
"Koppen_Filename": "Mad_2_5arcminute_koppen.dat"
}
|
Land_Temperature_Filename |
string |
NA |
NA |
land_temp.json |
The path of the input file defining temperature data measured at land surface; used only when Climate_Model is set to CLIMATE_BY_DATA. The file must be in .bin format. |
{
"Land_Temperature_Filename": "Namawala_single_node_land_temperature_daily.bin"
}
|
Load_Balance_Filename |
string |
NA |
NA |
UNINITIALIZED STRING |
The path to the input file used when a static load balancing scheme is selected. The file must be in .json format. |
{
"Load_Balance_Filename": "GitHub_426_LoadBalance.json"
}
|
Local_Migration_Filename |
string |
NA |
NA |
The path of the input file which defines patterns of migration to adjacent nodes by foot travel. The file must be in .bin format. |
{
"Local_Migration_Filename": "Local_Migration.bin"
}
|
|
Rainfall_Filename |
string |
NA |
NA |
rainfall.json |
The path of the input file which defines rainfall data. Climate_Model must be set to CLIMATE_BY_DATA. The file must be in .bin format. |
{
"Rainfall_Filename": "Namawala_single_node_rainfall_daily.bin"
}
|
Regional_Migration_Filename |
string |
NA |
NA |
The path of the input file which defines patterns of migration by vehicle via road or rail network. If the node is not on a road or rail network, regional migration focuses on the closest hub city in the network. The file must be in .bin format. |
{
"Regional_Migration_Filename": "Regional_Migration.bin"
}
|
|
Relative_Humidity_Filename |
string |
NA |
NA |
rel_hum.json |
The path of the input file which defines relative humidity data measured 2 meters above ground. Climate_Model must be set to CLIMATE_BY_DATA. The file must be in .bin format. |
{
"Relative_Humidity_Filename": "Namawala_single_node_relative_humidity_daily.bin"
}
|
Sea_Migration_Filename |
string |
NA |
NA |
The path of the input file which defines patterns of migration by ship. Only used when Enable_Sea_Migration is set to true (1). The file must be in .bin format. |
{
"Sea_Migration_Filename": "5x5_Households_Work_Migration.bin"
}
|
|
Serialized_Population_Filenames |
array of strings |
NA |
NA |
NA |
An array of filenames with serialized population data. The number of filenames must match the number of cores used for the simulation. The files must be in .dtk format. Serialized population files are created using Serialization_Time_Steps. |
{
"Serialized_Population_Filenames": [
"state-00010.dtk"
]
}
|
Serialized_Population_Path |
string |
NA |
NA |
. |
The root path for the serialized population files. Serialized population files are created using Serialization_Time_Steps. |
{
"Serialized_Population_Path": "../00_Generic_Version_1_save/output"
}
|
Migration¶
The following parameters determine aspects of population migration into and outside of a node, including daily commutes, seasonal migration, and one-way moves. Modes of transport includes travel by foot, automobile, sea, or air. Migration can also be configured to move all individuals in a family at the same time.
Parameter |
Data type |
Minimum |
Maximum |
Default |
Description |
Example |
---|---|---|---|---|---|---|
Air_Migration_Filename |
string |
NA |
NA |
The path to the input file that defines patterns of migration by airplane. Enable_Air_Migration must be set to true (1). The file must be in .bin format. |
{
"Migration_Model": "FIXED_RATE_MIGRATION",
"Enable_Air_Migration": 1,
"Air_Migration_Filename": "../Global_1degree_air_migration.bin"
}
|
|
Air_Migration_Roundtrip_Duration |
float |
0 |
10000 |
1 |
The average time spent (in days) at the destination node during a round-trip migration by airplane. Migration_Pattern must be set to SINGLE_ROUND_TRIPS. |
{
"Migration_Model": "FIXED_RATE_MIGRATION",
"Enable_Air_Migration": 1,
"Migration_Pattern": "SINGLE_ROUND_TRIPS",
"Air_Migration_Roundtrip_Duration": 2
}
|
Air_Migration_Roundtrip_Probability |
float |
0 |
1 |
0.8 |
The likelihood that an individual who flies to another node will return to the node of origin during the next migration. Enable_Air_Migration must be set to true (1). |
{
"Migration_Model": "FIXED_RATE_MIGRATION",
"Enable_Air_Migration": 1,
"Air_Migration_Roundtrip_Probability": 0.9
}
|
Enable_Air_Migration |
boolean |
0 |
1 |
0 |
Controls whether or not migration by air travel will occur. Migration_Model must be set to FIXED_RATE_MIGRATION. |
{
"Migration_Model": "FIXED_RATE_MIGRATION",
"Enable_Air_Migration": 1,
"Air_Migration_Filename": "../inputs/air_migration.bin"
}
|
Enable_Family_Migration |
boolean |
0 |
1 |
0 |
Controls whether or not all members of a household can migrate together when a MigrateFamily event occurs. All residents must be home before they can leave on the trip. Migration_Model must be set to FIXED_RATE_MIGRATION. |
{
"Enable_Migration": "FIXED_RATE_MIGRATION",
"Enable_Family_Migration": 1,
"Family_Migration_Filename": "../inputs/family_migration.bin"
}
|
Enable_Local_Migration |
boolean |
0 |
1 |
0 |
Controls whether or not local migration (the diffusion of people in and out of nearby nodes by foot travel) occurs. Migration_Model must be set to FIXED_RATE_MIGRATION. |
{
"Migration_Model": "FIXED_RATE_MIGRATION",
"Enable_Local_Migration": 1,
"Local_Migration_Filename": "../inputs/local_migration.bin"
}
|
Enable_Migration_Heterogeneity |
boolean |
0 |
1 |
1 |
Controls whether or not migration rate is heterogeneous among individuals within each group that has a migration rate setting. Set to true (1) to apply a migration rate distribution (see NodeAttributes demographics parameters); set to false (0) to use the same migration rate applied to all individuals in the group. For example, if you are using a migration file that sets different migration rates for each age group in a node, you could apply an Gaussian distribution around a mean value in each age group or you could assign the same value to each individual in each age group. Migration_Model must be set to FIXED_RATE_MIGRATION. |
{
"Migration_Model": "FIXED_RATE_MIGRATION",
"Enable_Migration_Heterogeneity": 1
}
|
Enable_Regional_Migration |
boolean |
0 |
1 |
0 |
Controls whether or not there is migration by road or rail network into and out of nodes in the simulation. Migration_Model must be set to FIXED_RATE_MIGRATION. |
{
"Migration_Model": "FIXED_RATE_MIGRATION",
"Enable_Regional_Migration": 1,
"Regional_Migration_Filename": "../inputs/regional_migration.bin"
}
|
Enable_Sea_Migration |
boolean |
0 |
1 |
0 |
Controls whether or not there is migration on ships into and out of coastal cities with seaports. Migration_Model must be set to FIXED_RATE_MIGRATION. |
{
"Migration_Model": "FIXED_RATE_MIGRATION",
"Enable_Sea_Migration": 1,
"Sea_Migration_Filename": "../inputs/sea_migration.bin"
}
|
Family_Migration_Filename |
string |
NA |
NA |
The name of the binary file to use to configure family migration. Enable_Family_Migration must be set to true (1). The file must be in .bin format. |
{
"Migration_Model": "FIXED_RATE_MIGRATION",
"Enable_Family_Migration": 1,
"Family_Migration_Filename": "../inputs/family_migration.bin"
}
|
|
Family_Migration_Roundtrip_Duration |
float |
0 |
10000 |
1 |
The number of days to complete the trip and return to the original node. Migration_Pattern must be set to SINGLE_ROUND_TRIPS. |
{
"Migration_Model": "FIXED_RATE_MIGRATION",
"Migration_Pattern": "SINGLE_ROUND_TRIPS",
"Enable_Family_Migration": 1,
"Family_Migration_Roundtrip_Duration": 100
}
|
Local_Migration_Filename |
string |
NA |
NA |
The path of the input file which defines patterns of migration to adjacent nodes by foot travel. The file must be in .bin format. |
{
"Local_Migration_Filename": "Local_Migration.bin"
}
|
|
Local_Migration_Roundtrip_Duration |
float |
0 |
10000 |
1 |
The average time spent (in days) at the destination node during a round-trip migration by foot travel. Migration_Pattern must be set to SINGLE_ROUND_TRIPS. |
{
"Enable_Local_Migration": 1,
"Migration_Pattern": "SINGLE_ROUND_TRIPS",
"Local_Migration_Roundtrip_Duration": 1.0
}
|
Local_Migration_Roundtrip_Probability |
float |
0 |
1 |
0.95 |
The likelihood that an individual who walks into a neighboring node will return to the node of origin during the next migration. Only used when Enable_Local_Migration is set to true (1). |
{
"Local_Migration_Roundtrip_Probability": 1.0
}
|
Migration_Model |
enum |
NA |
NA |
NO_MIGRATION |
Model to use for migration. Possible values are:
|
{
"Migration_Model": "FIXED_RATE_MIGRATION",
"Local_Migration_Filename": "../inputs/local_migration.bin",
"Enable_Local_Migration": 1
}
|
Migration_Pattern |
enum |
NA |
NA |
RANDOM_WALK_DIFFUSION |
Describes the pattern of travel used during migration. Migration_Model must be set to FIXED_RATE_MIGRATION. Possible values are:
|
{
"Migration_Model": "FIXED_RATE_MIGRATION",
"Migration_Pattern": "SINGLE_ROUND_TRIPS",
"Enable_Local_Migration": 1,
"Local_Migration_Roundtrip_Probability": 0.05,
"Local_Migration_Roundtrip_Duration": 10
}
|
Regional_Migration_Filename |
string |
NA |
NA |
The path of the input file which defines patterns of migration by vehicle via road or rail network. If the node is not on a road or rail network, regional migration focuses on the closest hub city in the network. The file must be in .bin format. |
{
"Regional_Migration_Filename": "Regional_Migration.bin"
}
|
|
Regional_Migration_Roundtrip_Duration |
float |
0 |
10000 |
1 |
The average time spent (in days) at the destination node during a round-trip migration by road network. Migration_Pattern must be set to SINGLE_ROUND_TRIPS. |
{
"Enable_Regional_Migration": 1,
"Migration_Pattern": "SINGLE_ROUND_TRIPS",
"Regional_Migration_Roundtrip_Duration": 1.0
}
|
Regional_Migration_Roundtrip_Probability |
float |
0 |
1 |
0.1 |
The likelihood that an individual who travels by vehicle to another node will return to the node of origin during the next migration. Migration_Pattern must be set to SINGLE_ROUND_TRIPS. |
{
"Regional_Migration_Roundtrip_Probability": 1.0
}
|
Roundtrip_Waypoints |
integer |
0 |
1000 |
10 |
The maximum number of points reached during a trip before steps are retraced on the return trip home. Migration_Pattern must be set to WAYPOINTS_HOME. |
{
"Roundtrip_Waypoints": 5
}
|
Sea_Migration_Filename |
string |
NA |
NA |
The path of the input file which defines patterns of migration by ship. Only used when Enable_Sea_Migration is set to true (1). The file must be in .bin format. |
{
"Sea_Migration_Filename": "5x5_Households_Work_Migration.bin"
}
|
|
Sea_Migration_Roundtrip_Duration |
float |
0 |
10000 |
1 |
The average time spent at the destination node during a round-trip migration by ship. Used only when Migration_Pattern must be set to SINGLE_ROUND_TRIPS. |
{
"Enable_Sea_Migration": 1,
"Migration_Pattern": "SINGLE_ROUND_TRIPS",
"Sea_Migration_Roundtrip_Duration": 10000
}
|
Sea_Migration_Roundtrip_Probability |
float |
0 |
1 |
0.25 |
The likelihood that an individual who travels by ship into a neighboring node will return to the node of origin during the next migration. Used only when Enable_Sea_Migration is set to true (1). |
{
"Sea_Migration_Roundtrip_Probability": 0
}
|
x_Air_Migration |
float |
0 |
3.40E+38 |
1 |
Scale factor for the rate of migration by air, as provided by the migration file. Enable_Air_Migration must be set to 1. |
{
"Scale_Factor_Air_Migration": 1
}
|
x_Family_Migration |
float |
0 |
3.40E+38 |
1 |
Scale factor for the rate of migration by families, as provided by the migration file. Enable_Family_Migration must be set to true (1). |
{
"x_Family_Migration": 1
}
|
x_Local_Migration |
float |
0 |
3.40E+38 |
1 |
Scale factor for rate of migration by foot travel, as provided by the migration file. Enable_Local_Migration must be set to 1. |
{
"x_Local_Migration": 1
}
|
x_Regional_Migration |
float |
0 |
3.40E+38 |
1 |
Scale factor for the rate of migration by road vehicle, as provided by the migration file. Enable_Regional_Migration must be set to 1. |
{
"x_Regional_Migration": 1
}
|
x_Sea_Migration |
float |
0 |
3.40E+38 |
1 |
Scale factor for the rate of migration by sea, as provided by the migration file. Enable_Sea_Migration must be set to 1. |
{
"x_Sea_Migration": 1
}
|
Mortality and survival¶
The following parameter determine mortality and survival characteristics of the disease being modeled and the population in general (non-disease mortality).
Parameter |
Data type |
Minimum |
Maximum |
Default |
Description |
Example |
---|---|---|---|---|---|---|
Death_Rate_Dependence |
enum |
NA |
NA |
NOT_INITIALIZED |
Determines how likely individuals are to die from natural, non-disease causes. Enable_Natural_Mortality must be set to 1. Possible values are:
Properties, rates, and bin sizes can be set for non-disease mortality for each gender in the demographics file (see Complex distributions parameters). |
{
"Death_Rate_Dependence": "NONDISEASE_MORTALITY_BY_AGE_AND_GENDER"
}
|
Enable_Disease_Mortality |
boolean |
0 |
1 |
1 |
Controls whether or not individuals are removed from the simulation due to disease deaths. |
{
"Enable_Disease_Mortality": 1
}
|
Enable_Natural_Mortality |
boolean |
0 |
1 |
0 |
Controls whether or not individuals are removed from the simulation due to natural (non-disease) deaths. Enable_Vital_Dynamics must be set to 1 (true). Use Death_Rate_Dependence to set the natural death rate. |
{
"Enable_Natural_Mortality": 1,
"Enable_Vital_Dynamics": 1
}
|
Mortality_Blocking_Immunity_Decay_Rate |
float |
0 |
1 |
0.001 |
The rate at which mortality-blocking immunity decays after the mortality-blocking immunity offset period. Enable_Immune_Decay must be set to 1. |
{
"Mortality_Blocking_Immunity_Decay_Rate": 0.1
}
|
Mortality_Time_Course |
enum |
NA |
NA |
DAILY_MORTALITY |
The method used to calculate disease deaths. Enable_Disease_Mortality must be set to 1. Possible values are:
|
{
"Mortality_Time_Course": "MORTALITY_AFTER_INFECTIOUS"
}
|
x_Other_Mortality |
float |
0 |
3.40E+38 |
1 |
Scale factor for mortality from causes other than the disease being simulated. Base mortality is provided by the demographics file (see Complex distributions parameters). Enable_Natural_Mortality must be set to 1. |
{
"x_Other_Mortality": 1
}
|
Output settings¶
The following parameters configure whether or not output reports are created for the simulation, such as reports detailing spatial or demographic data at each time step. By default, the Inset chart output report is always created.
Parameter |
Data type |
Minimum |
Maximum |
Default |
Description |
Example |
|||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Custom_Coordinator_Events |
array of strings |
NA |
NA |
NA |
The list of valid, user-defined events for Event Coordinators that will be included in the campaign. Any event used in the campaign must either be one of the built-in events or in this list. Note: This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Coordinator_Events": [
"Coordinator_Event_1",
"Coordinator_Event_2",
"Coordinator_Event_3"
]
}
|
|||||||||||||||
Custom_Individual_Events |
array of strings |
NA |
NA |
NA |
The list of valid, user-defined events that will be included in the campaign. Any event used in the campaign must either be one of the built-in events or in this list. Note: This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Individual_Events": [
"Individual_Event_1",
"Individual_Event_2",
"Individual_Event_3"
]
}
|
|||||||||||||||
Custom_Node_Events |
array of strings |
NA |
NA |
NA |
The list of valid, user-defined events for nodes that will be included in the campaign. Any event used in the campaign must either be one of the built-in events or in this list. Note: This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Node_Events": [
"Node_Event_1",
"Node_Event_2",
"Node_Event_3"
]
}
|
|||||||||||||||
Custom_Reports_Filename |
string |
NA |
NA |
UNINITIALIZED STRING |
The name of the file containing custom report configuration parameters. Omitting this parameter or setting it to RunAllCustomReports will load all reporters found that are valid for the given simulation type. The file must be in JSON format. |
{
"Custom_Reports_Filename": "custom_reports.json"
}
|
|||||||||||||||
Enable_Default_Reporting |
boolean |
0 |
1 |
1 |
Controls whether or not the default InsetChart.json report is created. |
{
"Enable_Default_Reporting": 1
}
|
|||||||||||||||
Enable_Demographics_Reporting |
boolean |
0 |
1 |
1 |
Controls whether or not demographic summary data and age-binned reports are outputted to file. |
{
"Enable_Demographics_Reporting": 1
}
|
|||||||||||||||
Enable_Property_Output |
boolean |
0 |
1 |
0 |
Controls whether or not to create property output reports, which detail groups as defined in IndividualProperties in the demographics file (see NodeProperties and IndividualProperties parameters). When there is more than one property type, the report will display the channel information for all combinations of the property type groups. |
{
"Enable_Property_Output": 1
}
|
|||||||||||||||
Enable_Spatial_Output |
boolean |
0 |
1 |
0 |
Controls whether or not spatial output reports are created. If set to true (1), spatial output reports include all channels listed in the parameter Spatial_Output_Channels. Note Spatial output files require significant processing time and disk space. |
{
"Enable_Spatial_Output": 1,
"Spatial_Output_Channels": [
"Prevalence",
"New_Infections"
]
}
|
|||||||||||||||
Property_Report_Start_Year |
float |
0 |
3.40282e+38 |
0 |
The year to start the property output report. This is dependent on Enable_Property_Output enabled (set to 1). |
{
"Property_Report_Start_Year": 1965.5
}
|
|||||||||||||||
Property_Report_Stop_Year |
float |
0 |
3.40282e+38 |
0 |
The year to stop the property output report. This is dependent on Enable_Property_Output enabled (set to 1). |
{
"Property_Report_Stop_Year": 2019.25
}
|
|||||||||||||||
Report_Coordinator_Event_Recorder |
boolean |
0 |
1 |
0 |
Enables or disables the ReportCoordinatorEventRecorder.csv output report for coordinator events. When enabled (set to 1) reports will be generated for the broadcasted valid coordinator events, as specified in Report_Coordinator_Event_Recorder_Events. Note: This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Coordinator_Events": [
"Coordinator_Event_1",
"Coordinator_Event_2",
"Coordinator_Event_3"
],
"Report_Coordinator_Event_Recorder": 1,
"Report_Coordinator_Event_Recorder_Events": [
"Coordinator_Event_1",
"Coordinator_Event_2",
"Coordinator_Event_3"
]
}
|
|||||||||||||||
Report_Coordinator_Event_Recorder_Events |
array of strings |
NA |
NA |
NA |
The list of events to include or exclude in the ReportCoordinatorEventRecorder.csv output report, based on how Report_Coordinator_Event_Recorder_Ignore_Events_In_List is set. This list must not be empty and is dependent upon Report_Coordinator_Event_Recorder being enabled. In addition, the events must be defined in Customer_Coordinator_Events. Note: This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Coordinator_Events": [
"Coordinator_Event_1",
"Coordinator_Event_2",
"Coordinator_Event_3"
],
"Report_Coordinator_Event_Recorder": 1,
"Report_Coordinator_Event_Recorder_Events": [
"Coordinator_Event_1",
"Coordinator_Event_2",
"Coordinator_Event_3"
]
}
|
|||||||||||||||
Report_Coordinator_Event_Recorder_Ignore_Events_In_List |
boolean |
0 |
1 |
0 |
If set to false (0), only the events listed in the Report_Coordinator_Event_Recorder_Events array will be included in the ReportCoordinatorEventRecorder.csv output report. If set to true (1), only the events listed in the array will be excluded, and all other events will be included. If you want to return all events from the simulation, leave the events array empty. Note: This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Coordinator_Events": [
"Coordinator_Event_1",
"Coordinator_Event_2",
"Coordinator_Event_3"
],
"Report_Coordinator_Event_Recorder": 1,
"Report_Coordinator_Event_Recorder_Events": [
"Coordinator_Event_1",
"Coordinator_Event_2",
"Coordinator_Event_3"
],
"Report_Coordinator_Event_Recorder_Ignore_Events_In_List": 0
}
|
|||||||||||||||
Report_Event_Recorder |
boolean |
0 |
1 |
0 |
Set to true (1) to enable or to false (0) to disable the ReportEventRecorder.csv output report that lists individual events in the simulation. See Event list for a list of all possible built-in events that will be recorded in the output when enabled. |
{
"Report_Event_Recorder": 1,
"Report_Event_Recorder_Events": [
"VaccinatedA",
"VaccineExpiredA",
"VaccinatedB",
"VaccineExpiredB"
],
"Report_Event_Recorder_Ignore_Events_In_List": 0
}
|
|||||||||||||||
Report_Event_Recorder_Events |
array |
NA |
NA |
The list of events to include or exclude in the ReportEventRecorder.csv output report, based on how Report_Event_Recorder_Ignore_Events_In_List is set. See Event list for a list of all possible built-in events. You can also define events in Custom_Individual_Events. The list cannot be empty. |
{
"Report_Event_Recorder": 1,
"Report_Event_Recorder_Events": [
"VaccinatedA",
"VaccineExpiredA",
"VaccinatedB",
"VaccineExpiredB"
],
"Report_Event_Recorder_Ignore_Events_In_List": 0
}
|
||||||||||||||||
Report_Event_Recorder_Ignore_Events_In_List |
boolean |
0 |
1 |
0 |
If set to false (0), only the events listed in the Report_Event_Recorder_Events array will be included in the ReportEventRecorder.csv output report. If set to true (1), only the events listed in the array will be excluded, and all other events will be included. If you want to return all events from the simulation, leave the events array empty.
|
{
"Report_Event_Recorder": 1,
"Report_Event_Recorder_Events": [
"VaccinatedA",
"VaccineExpiredA",
"VaccinatedB",
"VaccineExpiredB"
],
"Report_Event_Recorder_Ignore_Events_In_List": 0
}
|
|||||||||||||||
Report_Event_Recorder_Individual_Properties |
array of strings |
NA |
NA |
[] |
Specifies an array of (optional) individual property keys, as defined in IndividualProperties in the demographics file, to be added as additional columns to the output report. Individual’s IP value will be added to the (key) column at the time of the event. |
{
"Report_Event_Recorder_Individual_Properties": [
"Accessibility",
"Risk"
]
}
|
|||||||||||||||
Report_Node_Event_Recorder |
boolean |
0 |
1 |
0 |
Enables or disables the ReportNodeEventRecorder.csv output report. When enabled (set to 1) reports will be generated for the broadcasted valid node events, as specified in Report_Node_Event_Recorder_Events. Note: This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Node_Events": [
"Node_Event_1",
"Node_Event_2"
],
"Report_Node_Event_Recorder": 1,
"Report_Node_Event_Recorder_Events": [
"Node_Event_1",
"Node_Event_2"
]
}
|
|||||||||||||||
Report_Node_Event_Recorder_Ignore_Events_In_List |
boolean |
0 |
1 |
0 |
If set to false (0), only the node events listed in the Report_Node_Event_Recorder_Events array will be included in the ReportNodeEventRecorder.csv output report. If set to true (1), only the node events listed in the array will be excluded, and all other node events will be included. If you want to return all node events from the simulation, leave the node events array empty. Note: This configuration parameter is currently in beta release and has not yet been fully tested.
|
{
"Custom_Node_Events": [
"Node_Event_1",
"Node_Event_2"
],
"Report_Node_Event_Recorder": 1,
"Report_Node_Event_Recorder_Events": [
"Node_Event_1",
"Node_Event_2"
],
"Report_Node_Event_Recorder_Ignore_Events_In_List": 0
}
|
|||||||||||||||
Report_Node_Event_Recorder_Node_Properties |
array of strings |
NA |
NA |
[] |
Specifies an array of (optional) node property keys, as defined in NodeProperties in the demographics file, to be added as additional columns to the ReportNodeEventRecorder.csv output report. |
{
"Custom_Node_Events": [
"Node_Event_1",
"Node_Event_2"
],
"Report_Node_Event_Recorder": 1,
"Report_Node_Event_Recorder_Events": [
"Node_Event_1",
"Node_Event_2"
],
"Report_Node_Event_Recorder_Ignore_Events_In_List": 0,
"Report_Node_Event_Recorder_Node_Properties": [
"Geographic"
]
}
|
|||||||||||||||
Report_Node_Event_Recorder_Stats_By_IPs |
array of strings |
NA |
NA |
[] |
Specifies an array of (optional) individual property keys, as defined in IndividualProperties in the demographics file, to be added to the ReportNodeEventRecorder.csv output report. For each key:value pair there will be two additional columns (Key:Value:NumIndividuals, Key:Value:NumInfected) added to the report. For example, with a Risk property key assigned the values of LOW and HIGH there would then be four additional columns (Risk:LOW:NumIndividuals, Risk:LOW:NumInfected, Risk:HIGH:NumIndividuals, Risk:HIGH:NumInfected). An empty array equals no additional columns added. |
{
"Custom_Node_Events": [
"Node_Event_1",
"Node_Event_2"
],
"Report_Node_Event_Recorder": 1,
"Report_Node_Event_Recorder_Events": [
"Node_Event_1",
"Node_Event_2"
],
"Report_Node_Event_Recorder_Ignore_Events_In_List": 0,
"Report_Node_Event_Recorder_Node_Properties": [
"Geographic"
],
"Report_Node_Event_Recorder_Stats_By_IPs": [
"Risk"
]
}
|
|||||||||||||||
Report_Surveillance_Event_Recorder |
boolean |
0 |
1 |
0 |
Enables or disables the ReportSurveillanceEventRecorder.csv output report. When enabled (set to 1) reports will be generated for the broadcasted valid coordinator events, as specified in Report_Surveillance_Event_Recorder_Events. Note: This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Coordinator_Events": [
"Start_ACF",
"Start_SIA_2",
"Start_SIA_4",
"Ind_Start_SIA_2",
"Ind_Start_SIA_4",
"Respond_To_Surveillance"
],
"Report_Surveillance_Event_Recorder": 1,
"Report_Surveillance_Event_Recorder_Events": [
"Respond_To_Surveillance"
]
}
|
|||||||||||||||
Report_Surveillance_Event_Recorder_Events |
array of strings |
NA |
NA |
NA |
The list of events to include or exclude in the ReportSurveillanceEventRecorder.csv output report, based on how Report_Surveillance_Event_Recorder_Ignore_Events_In_List is set. This list must not be empty and is dependent upon Report_Surveillance_Event_Recorder being enabled. Note: This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Coordinator_Events": [
"Start_ACF",
"Start_SIA_2",
"Start_SIA_4",
"Ind_Start_SIA_2",
"Ind_Start_SIA_4",
"Respond_To_Surveillance"
],
"Report_Surveillance_Event_Recorder": 1,
"Report_Surveillance_Event_Recorder_Events": [
"Respond_To_Surveillance"
]
}
|
|||||||||||||||
Report_Surveillance_Event_Recorder_Ignore_Events_In_List |
boolean |
0 |
1 |
0 |
If set to false (0), only the events listed in the Report_Surveillance_Event_Recorder_Events array will be included in the ReportSurveillanceEventRecorder.csv output report. If set to true (1), only the events listed in the array will be excluded, and all other events will be included. If you want to return all events from the simulation, leave the events array empty. Note: This configuration parameter is currently in beta release and has not yet been fully tested.
|
{
"Custom_Coordinator_Events": [
"Start_ACF",
"Start_SIA_2",
"Start_SIA_4",
"Ind_Start_SIA_2",
"Ind_Start_SIA_4",
"Respond_To_Surveillance"
],
"Report_Surveillance_Event_Recorder": 1,
"Report_Surveillance_Event_Recorder_Events": [
"Respond_To_Surveillance"
],
"Report_Surveillance_Event_Recorder_Ignore_Events_In_List": 0
}
|
|||||||||||||||
Report_Surveillance_Event_Recorder_Stats_By_IPs |
array of strings |
NA |
NA |
[] |
Specifies an array of (optional) individual property keys, as defined in IndividualProperties in the demographics file, to be added to the ReportSurveillanceEventRecorder.csv output report. For each key:value pair there will be two additional columns (Key:Value:NumIndividuals, Key:Value:NumInfected) added to the report. For example, with a Risk property key assigned the values of LOW and HIGH there would then be four additional columns (Risk:LOW:NumIndividuals, Risk:LOW:NumInfected, Risk:HIGH:NumIndividuals, Risk:HIGH:NumInfected). An empty array equals no additional columns added. |
{
"Custom_Coordinator_Events": [
"Start_ACF",
"Start_SIA_2",
"Start_SIA_4",
"Ind_Start_SIA_2",
"Ind_Start_SIA_4",
"Respond_To_Surveillance"
],
"Report_Surveillance_Event_Recorder": 1,
"Report_Surveillance_Event_Recorder_Events": [
"Respond_To_Surveillance"
],
"Report_Surveillance_Event_Recorder_Stats_By_IPs": []
}
|
|||||||||||||||
Report_Typhoid_ByAgeAndGender_Start_Year |
float |
0 |
3.40E+38 |
0 |
The year to start the typhoid output report. |
{
"Report_Typhoid_ByAgeAndGender_Start_Year": 1970
}
|
|||||||||||||||
Report_Typhoid_ByAgeAndGender_Stop_Year |
float |
0 |
3.40E+38 |
3.40E+38 |
The year to stop the typhoid output report. |
{
"Report_Typhoid_ByAgeAndGender_Stop_Year": 2000
}
|
|||||||||||||||
Spatial_Output_Channels |
array of strings |
NA |
NA |
[] |
An array of channel names for spatial output by node and time step. The data from each channel will be written to a separate binary file. Enable_Spatial_Output must be set to true (1). Possible values are:
|
{
"Spatial_Output_Channels": [
"Prevalence",
"New_Infections"
]
}
|
|||||||||||||||
Typhoid_Inset_Chart_Reporting_Start_Year |
float |
1850 |
2200 |
0 |
The start year for inset chart reporting. |
{
"Typhoid_Inset_Chart_Reporting_Start_Year": 0
}
|
|||||||||||||||
Typhoid_Inset_Chart_Reporting_Stop_Year |
float |
1850 |
2200 |
0 |
The stop year for inset chart reporting. |
{
"Typhoid_Inset_Chart_Reporting_Stop_Year": 0
}
|
Population dynamics¶
The following parameters determine characteristics related to population dynamics, such as age distribution, births, deaths, and gender. The values set here generally interact closely with values in the demographics file.
Parameter |
Data type |
Minimum |
Maximum |
Default |
Description |
Example |
---|---|---|---|---|---|---|
Age_Initialization_Distribution_Type |
enum |
NA |
NA |
DISTRIBUTION_OFF |
The method for initializing the age distribution in the simulated population. Possible values are:
|
{
"Age_Initialization_Distribution_Type": "DISTRIBUTION_SIMPLE"
}
|
Birth_Rate_Boxcar_Forcing_Amplitude |
float |
0 |
3.40E+38 |
0 |
Fractional increase in birth rate during high birth season when Birth_Rate_Time_Dependence is set to ANNUAL_BOXCAR_FUNCTION. |
{
"Enable_Vital_Dynamics": 1,
"Enable_Birth": 1,
"Birth_Rate_Time_Dependence": "ANNUAL_BOXCAR_FUNCTION",
"Birth_Rate_Boxcar_Forcing_Amplitude": 0.1
}
|
Birth_Rate_Boxcar_Forcing_End_Time |
float |
0 |
365 |
0 |
Day of the year when the high birth rate season ends when Birth_Rate_Time_Dependence is set to ANNUAL_BOXCAR_FUNCTION. |
{
"Enable_Vital_Dynamics": 1,
"Enable_Birth": 1,
"Birth_Rate_Time_Dependence": "ANNUAL_BOXCAR_FUNCTION",
"Birth_Rate_Boxcar_Forcing_End_Time": 220
}
|
Birth_Rate_Boxcar_Forcing_Start_Time |
float |
0 |
365 |
0 |
Day of the year when the high birth rate season begins when Birth_Rate_Time_Dependence is set to ANNUAL_BOXCAR_FUNCTION. |
{
"Enable_Vital_Dynamics": 1,
"Enable_Birth": 1,
"Birth_Rate_Time_Dependence": "ANNUAL_BOXCAR_FUNCTION",
"Birth_Rate_Boxcar_Forcing_Start_Time": 130
}
|
Birth_Rate_Dependence |
enum |
NA |
NA |
FIXED_BIRTH_RATE |
The method used to modify the value set in BirthRate in the demographics file (see NodeAttributes parameters). Possible values are:
|
{
"Enable_Vital_Dynamics": 1,
"Enable_Birth": 1,
"Birth_Rate_Dependence": "POPULATION_DEP_RATE"
}
|
Birth_Rate_Sinusoidal_Forcing_Amplitude |
float |
0 |
1 |
0 |
The amplitude of sinusoidal variations in birth rate when Birth_Rate_Time_Dependence is set to SINUSOIDAL_FUNCTION_OF_TIME. |
{
"Enable_Vital_Dynamics": 1,
"Enable_Birth": 1,
"Birth_Rate_Time_Dependence": "SINUSOIDAL_FUNCTION_OF_TIME",
"Birth_Rate_Sinusoidal_Forcing_Amplitude": 0.1
}
|
Birth_Rate_Sinusoidal_Forcing_Phase |
float |
0 |
365 |
0 |
The phase of sinusoidal variations in birth rate. Birth_Rate_Time_Dependence must be set to SINUSOIDAL_FUNCTION_OF_TIME. |
{
"Birth_Rate_Sinusoidal_Forcing_Phase": 20
}
|
Birth_Rate_Time_Dependence |
enum |
NA |
NA |
NONE |
A scale factor for BirthRate that allows it to be altered by time or season. Enable_Birth must be set to true (1). Possible values are:
|
{
"Enable_Vital_Dynamics": 1,
"Enable_Birth": 1,
"Birth_Rate_Time_Dependence": "ANNUAL_BOXCAR_FUNCTION"
}
|
Death_Rate_Dependence |
enum |
NA |
NA |
NOT_INITIALIZED |
Determines how likely individuals are to die from natural, non-disease causes. Enable_Natural_Mortality must be set to 1. Possible values are:
Properties, rates, and bin sizes can be set for non-disease mortality for each gender in the demographics file (see Complex distributions parameters). |
{
"Death_Rate_Dependence": "NONDISEASE_MORTALITY_BY_AGE_AND_GENDER"
}
|
Default_Geography_Initial_Node_Population |
integer |
0 |
1000000 |
1000 |
When using the built-in demographics for default geography, the initial number of individuals in each node. Note that the built-in demographics feature does not represent a real geographical location and is mostly used for testing. Enable_Demographics_Builtin must be set to true (1). |
{
"Enable_Demographics_Builtin": 1,
"Default_Geography_Initial_Node_Population": 1000,
"Default_Geography_Torus_Size": 3
}
|
Demographics_Filenames |
array of strings |
NA |
NA |
An array of the paths to demographics files containing information on the identity and demographics of the region to simulate. The files must be in .json format. Note that this parameter is only required when Enable_Demographics_Builtin is set to 0. |
{
"Demographics_Filenames": [
"Namawala_single_node_demographics.json",
"Namawala_demographics_overlay.json"
]
}
|
|
Enable_Aging |
boolean |
0 |
1 |
1 |
Controls whether or not individuals in a population age during the simulation. Enable_Vital_Dynamics must be set to true (1). |
{
"Enable_Vital_Dynamics": 1,
"Enable_Aging": 1
}
|
Enable_Birth |
boolean |
0 |
1 |
1 |
Controls whether or not individuals will be added to the simulation by birth. Enable_Vital_Dynamics must be set to true (1). If you want new individuals to have the same intervention coverage as existing individuals, you must add a BirthTriggeredIV to the campaign file. |
{
"Enable_Vital_Dynamics": 1,
"Enable_Birth": 1
}
|
Enable_Demographics_Birth |
boolean |
0 |
1 |
0 |
Controls whether or not newborns have identical or heterogeneous characteristics. Set to false (0) to give all newborns identical characteristics; set to true (1) to allow for heterogeneity in traits such as sickle-cell status. Enable_Birth must be set to true (1). |
{
"Enable_Birth": 1,
"Enable_Demographics_Birth": 1
}
|
Enable_Demographics_Builtin |
boolean |
0 |
1 |
0 |
Controls whether or not built-in demographics for default geography will be used. Note that the built-in demographics feature does not represent a real geographical location and is mostly used for testing. Set to true (1) to define the initial population and number of nodes using Default_Geography_Initial_Node_Population and Default_Geography_Torus_Size. Set to false (0) to use demographics input files defined in Demographics_Filenames. |
{
"Enable_Demographics_Builtin": 1,
"Default_Geography_Initial_Node_Population": 1000,
"Default_Geography_Torus_Size": 3
}
|
Enable_Vital_Dynamics |
boolean |
0 |
1 |
1 |
Controls whether or not births and deaths occur in the simulation. Births and deaths must be individually enabled and set. |
{
"Enable_Vital_Dynamics": 1,
"Enable_Birth": 1,
"Death_Rate_Dependence": "NOT_INITIALIZED",
"Base_Mortality": 0.002
}
|
Minimum_Adult_Age_Years |
float |
0 |
3.40E+38 |
15 |
The age, in years, after which an individual is considered an adult. Individual_Sampling_Type must be set to ADAPTED_SAMPLING_BY_AGE_GROUP. |
{
"Minimum_Adult_Age_Years": 17
}
|
Population_Density_Infectivity_Correction |
enum |
NA |
NA |
CONSTANT_INFECTIVITY |
Correction to alter infectivity by population density set in the Population_Density_C50 parameter. Measured in people per square kilometer. Possible values are:
Note Sparsely populated areas have a lower infectivity, while densely populated areas have a higher infectivity, which rises to saturate at the Base_Infectivity value. |
{
"Population_Density_Infectivity_Correction": "SATURATING_FUNCTION_OF_DENSITY"
}
|
Population_Scale_Type |
enum |
NA |
NA |
USE_INPUT_FILE |
The method to use for scaling the initial population specified in the demographics input file. Possible values are:
|
{
"Population_Scale_Type": "FIXED_SCALING"
}
|
x_Base_Population |
float |
0 |
3.40E+38 |
1 |
Scale factor for InitialPopulation in the demographics file (see NodeAttributes parameters). If Population_Scale_Type is set to FIXED_SCALING, the initial simulation population is uniformly scaled over the entire area to adjust for historical or future population density. |
{
"x_Base_Population": 0.0001
}
|
x_Birth |
float |
0 |
3.40E+38 |
1 |
Scale factor for birth rate, as provided by the demographics file (see NodeAttributes parameters). Enable_Birth must be set to 1. |
{
"x_Birth": 1
}
|
Sampling¶
The following parameters determine how a population is sampled in the simulation. While you may want every agent (individual object) to represent a single person, you can often optimize CPU time with without degrading the accuracy of the simulation but having an agent represent multiple people. The sampling rate may be adapted to have a higher or lower sampling rate for particular regions or age groups.
Parameter |
Data type |
Minimum |
Maximum |
Default |
Description |
Example |
---|---|---|---|---|---|---|
Base_Individual_Sample_Rate |
float |
0.001 |
1 |
1 |
The base rate of sampling for individuals, equal to the fraction of individuals in each node being sampled. Reducing the sampling rate will reduce the time needed to run simulations. Individual_Sampling_Type must be set to FIXED_SAMPLING or ADAPTED_SAMPLING_BY_IMMUNE_STATE. |
{
"Base_Individual_Sample_Rate": 0.01
}
|
Immune_Threshold_For_Downsampling |
float |
0 |
1 |
0 |
The threshold on acquisition immunity at which to apply immunity-dependent downsampling; individuals who are more immune than this this threshold are downsampled. A value of 1 is equivalent to full susceptibility and 0 is equivalent to full immunity. If the acquisition immunity modifier is larger than the threshold, no downsampling occurs. Individual_Sampling_Type must set to ADAPTED_SAMPLING_BY_IMMUNE_STATE. |
{
"Relative_Sample_Rate_Immune": 0.1,
"Immune_Threshold_For_Downsampling": 0.5,
"Individual_Sampling_Type": "ADAPTED_SAMPLING_BY_IMMUNE_STATE"
}
|
Individual_Sampling_Type |
enum |
NA |
NA |
TRACK_ALL |
The type of individual human sampling to use, which can be used to down sample large populations, certain age groups, or the immune population that does not contribute to transmission. Possible values are:
|
The following example shows how to sampling immune individuals at a lower rate. {
"Individual_Sampling_Type": "ADAPTED_SAMPLING_BY_IMMUNE_STATE",
"Immune_Threshold_For_Downsampling": 0.5,
"Relative_Sample_Rate_Immune": 0.1
}
The following example shows how to sampling older individuals at a lower rate. {
"Individual_Sampling_Type": "ADAPTED_SAMPLING_BY_AGE_GROUP",
"Sample_Rate_0_18mo": 1,
"Sample_Rate_10_14": 0.5,
"Sample_Rate_15_19": 0.3,
"Sample_Rate_18mo_4yr": 1,
"Sample_Rate_20_Plus": 0.2,
"Sample_Rate_5_9": 1,
"Sample_Rate_Birth": 1
}
|
Max_Node_Population_Samples |
float |
1 |
3.40E+38 |
30 |
The maximum number of individuals to track in a node. When the population exceeds this number, the sampling rate will drop according to the value set in Individual_Sampling_Type. |
{
"Individual_Sampling_Type": "ADAPTED_SAMPLING_BY_POPULATION_SIZE",
"Max_Node_Population_Samples": 100000
}
|
Relative_Sample_Rate_Immune |
float |
0.001 |
1 |
0.1 |
The relative sampling rate for people who have acquired immunity through recovery or vaccination. The immune threshold at which to downsample is set by Immune_Threshold_For_Downsampling. If set to 1, this will have no effect, even if the individual’s immunity modifier is below threshold. This can be a useful sanity check while learning this feature. Individual_Sampling_Type must be set to ADAPTED_SAMPLING_BY_IMMUNE_STATE. |
{
"Relative_Sample_Rate_Immune": 0.1,
"Immune_Threshold_For_Downsampling": 0.8,
"Individual_Sampling_Type": "ADAPTED_SAMPLING_BY_IMMUNE_STATE"
}
|
Sample_Rate_0_18mo |
float |
0.001 |
1000 |
1 |
For age-adapted sampling, the relative sampling rate for infants age 0 to 18 months. Individual_Sampling_Type must be set to ADAPTED_SAMPLING_BY_AGE_GROUP or ADAPTED_SAMPLING_BY_AGE_GROUP_AND_POP_SIZE. |
{
"Sample_Rate_0_18mo": 1
}
|
Sample_Rate_10_14 |
float |
0.001 |
1000 |
1 |
For age-adapted sampling, the relative sampling rate for children age 10 to 14 years. Individual_Sampling_Type must be set to ADAPTED_SAMPLING_BY_AGE_GROUP or ADAPTED_SAMPLING_BY_AGE_GROUP_AND_POP_SIZE. |
{
"Sample_Rate_10_14": 1
}
|
Sample_Rate_15_19 |
float |
0.001 |
1000 |
1 |
For age-adapted sampling, the relative sampling rate for adolescents age 15 to 19 years. Individual_Sampling_Type must be set to ADAPTED_SAMPLING_BY_AGE_GROUP or ADAPTED_SAMPLING_BY_AGE_GROUP_AND_POP_SIZE. |
{
"Sample_Rate_15_19": 1
}
|
Sample_Rate_18mo_4yr |
float |
0.001 |
1000 |
1 |
For age-adapted sampling, the relative sampling rate for children age 18 months to 4 years. Individual_Sampling_Type must be set to ADAPTED_SAMPLING_BY_AGE_GROUP or ADAPTED_SAMPLING_BY_AGE_GROUP_AND_POP_SIZE. |
{
"Sample_Rate_18mo_4yr": 1
}
|
Sample_Rate_20_plus |
float |
0.001 |
1000 |
1 |
For age-adapted sampling, the relative sampling rate for adults age 20 and older. Individual_Sampling_Type must be set to ADAPTED_SAMPLING_BY_AGE_GROUP or ADAPTED_SAMPLING_BY_AGE_GROUP_AND_POP_SIZE. |
{
"Sample_Rate_20_plus": 1
}
|
Sample_Rate_5_9 |
float |
0.001 |
1000 |
1 |
For age-adapted sampling, the relative sampling rate for children age 5 to 9 years. Individual_Sampling_Type must be set to ADAPTED_SAMPLING_BY_AGE_GROUP or ADAPTED_SAMPLING_BY_AGE_GROUP_AND_POP_SIZE. |
{
"Sample_Rate_5_9": 1
}
|
Sample_Rate_Birth |
float |
0.001 |
1000 |
1 |
For age-adapted sampling, the relative sampling rate for births. Individual_Sampling_Type must be set to ADAPTED_SAMPLING_BY_AGE_GROUP or ADAPTED_SAMPLING_BY_AGE_GROUP_AND_POP_SIZE. |
{
"Sample_Rate_Birth": 1
}
|
Scalars and multipliers¶
The following parameters scale or multiply values set in other areas of the configuration file or other input files. This can be especially useful for understanding the sensitivities of disease dynamics to input data without requiring modifications to those base values. For example, one might set x_Birth to a value less than 1 to simulate a lower future birth rate due to increased economic prosperity and available medical technology.
Parameter |
Data type |
Minimum |
Maximum |
Default |
Description |
Example |
---|---|---|---|---|---|---|
Birth_Rate_Time_Dependence |
enum |
NA |
NA |
NONE |
A scale factor for BirthRate that allows it to be altered by time or season. Enable_Birth must be set to true (1). Possible values are:
|
{
"Enable_Vital_Dynamics": 1,
"Enable_Birth": 1,
"Birth_Rate_Time_Dependence": "ANNUAL_BOXCAR_FUNCTION"
}
|
Infectivity_Exponential_Baseline |
float |
0 |
1 |
0 |
The scale factor applied to Base_Infectivity at the beginning of a simulation, before the infectivity begins to grow exponentially. Infectivity_Scale_Type must be set to EXPONENTIAL_FUNCTION_OF_TIME. |
{
"Infectivity_Exponential_Baseline": 0.1,
"Infectivity_Exponential_Delay": 90,
"Infectivity_Exponential_Rate": 45,
"Infectivity_Scale_Type": "EXPONENTIAL_FUNCTION_OF_TIME"
}
|
Population_Scale_Type |
enum |
NA |
NA |
USE_INPUT_FILE |
The method to use for scaling the initial population specified in the demographics input file. Possible values are:
|
{
"Population_Scale_Type": "FIXED_SCALING"
}
|
Post_Infection_Acquisition_Multiplier |
float |
0 |
1 |
0 |
The multiplicative reduction in the probability of reacquiring disease. At the time of recovery, the immunity against acquisition is multiplied by Acquisition_Blocking_Immunity_Decay_Rate x (1 - Post_Infection_Acquisition_Multiplier). Enable_Immunity must be set to 1 (true). |
{
"Enable_Immunity": 1,
"Enable_Immune_Decay": 1,
"Post_Infection_Acquisition_Multiplier": 0.9
}
|
Post_Infection_Mortality_Multiplier |
float |
0 |
1 |
0 |
The multiplicative reduction in the probability of dying from infection after getting reinfected. At the time of recovery, the immunity against mortality is multiplied by Mortality_Blocking_Immunity_Decay_Rate x (1 - Post_Infection_Mortality_Multiplier). Enable_Immunity must be set to 1 (true). |
{
"Enable_Immunity": 1,
"Enable_Immune_Decay": 1,
"Post_Infection_Mortality_Multiplier": 0.5
}
|
Post_Infection_Transmission_Multiplier |
float |
0 |
1 |
0 |
The multiplicative reduction in the probability of transmitting infection after getting reinfected. At the time of recovery, the immunity against transmission is multiplied by Transmission_Blocking_Immunity_Decay_Rate x (1 - Post_Infection_Transmission_Multiplier). Enable_Immunity must be set to 1 (true). |
{
"Enable_Immunity": 1,
"Enable_Immunity_Decay": 1,
"Post_Infection_Transmission_Multiplier": 0.9
}
|
Susceptibility_Scaling_Rate |
float |
0 |
3.40282e+38 |
0 |
The scaling rate for the variation in time of the log-linear susceptibility scaling. Susceptibility_Scaling_Type must be set to LOG_LINEAR_FUNCTION_OF_TIME. |
{
"Susceptibility_Scaling_Type": "LOG_LINEAR_FUNCTION_OF_TIME",
"Susceptibility_Scaling_Rate": 1.58
}
|
Susceptibility_Scaling_Type |
enum |
NA |
NA |
CONSTANT_SUSCEPTIBILITY |
The effect of time on susceptibility. Possible values are:
|
{
"Susceptibility_Scaling_Type": "CONSTANT_SUSCEPTIBILITY"
}
|
x_Air_Migration |
float |
0 |
3.40E+38 |
1 |
Scale factor for the rate of migration by air, as provided by the migration file. Enable_Air_Migration must be set to 1. |
{
"Scale_Factor_Air_Migration": 1
}
|
x_Base_Population |
float |
0 |
3.40E+38 |
1 |
Scale factor for InitialPopulation in the demographics file (see NodeAttributes parameters). If Population_Scale_Type is set to FIXED_SCALING, the initial simulation population is uniformly scaled over the entire area to adjust for historical or future population density. |
{
"x_Base_Population": 0.0001
}
|
x_Birth |
float |
0 |
3.40E+38 |
1 |
Scale factor for birth rate, as provided by the demographics file (see NodeAttributes parameters). Enable_Birth must be set to 1. |
{
"x_Birth": 1
}
|
x_Family_Migration |
float |
0 |
3.40E+38 |
1 |
Scale factor for the rate of migration by families, as provided by the migration file. Enable_Family_Migration must be set to true (1). |
{
"x_Family_Migration": 1
}
|
x_Local_Migration |
float |
0 |
3.40E+38 |
1 |
Scale factor for rate of migration by foot travel, as provided by the migration file. Enable_Local_Migration must be set to 1. |
{
"x_Local_Migration": 1
}
|
x_Other_Mortality |
float |
0 |
3.40E+38 |
1 |
Scale factor for mortality from causes other than the disease being simulated. Base mortality is provided by the demographics file (see Complex distributions parameters). Enable_Natural_Mortality must be set to 1. |
{
"x_Other_Mortality": 1
}
|
x_Regional_Migration |
float |
0 |
3.40E+38 |
1 |
Scale factor for the rate of migration by road vehicle, as provided by the migration file. Enable_Regional_Migration must be set to 1. |
{
"x_Regional_Migration": 1
}
|
x_Sea_Migration |
float |
0 |
3.40E+38 |
1 |
Scale factor for the rate of migration by sea, as provided by the migration file. Enable_Sea_Migration must be set to 1. |
{
"x_Sea_Migration": 1
}
|
Simulation setup¶
These parameters determine the basic setup of a simulation including the type of simulation you are running, such as “GENERIC_SIM” or “MALARIA_SIM”, the simulation duration, and the time step duration.
Parameter |
Data type |
Minimum |
Maximum |
Default |
Description |
Example |
---|---|---|---|---|---|---|
Base_Year |
float |
1900 |
2200 |
2015 |
The absolute time in years when the simulation begins. This can be combined with CampaignEventByYear to trigger campaign events (Start_Year for events must be after Base_Year). |
{
"Base_Year": 1960
}
|
Config_Name |
string |
NA |
NA |
UNINITIALIZED STRING |
The optional, user-supplied title naming a configuration file. |
{
"Config_Name": "My_First_Config"
}
|
Custom_Coordinator_Events |
array of strings |
NA |
NA |
NA |
The list of valid, user-defined events for Event Coordinators that will be included in the campaign. Any event used in the campaign must either be one of the built-in events or in this list. Note: This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Coordinator_Events": [
"Coordinator_Event_1",
"Coordinator_Event_2",
"Coordinator_Event_3"
]
}
|
Custom_Individual_Events |
array of strings |
NA |
NA |
NA |
The list of valid, user-defined events that will be included in the campaign. Any event used in the campaign must either be one of the built-in events or in this list. Note: This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Individual_Events": [
"Individual_Event_1",
"Individual_Event_2",
"Individual_Event_3"
]
}
|
Custom_Node_Events |
array of strings |
NA |
NA |
NA |
The list of valid, user-defined events for nodes that will be included in the campaign. Any event used in the campaign must either be one of the built-in events or in this list. Note: This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Node_Events": [
"Node_Event_1",
"Node_Event_2",
"Node_Event_3"
]
}
|
Enable_Interventions |
boolean |
0 |
1 |
0 |
Controls whether or not campaign interventions will be used in the simulation. Set Campaign_Filename to the path of the file that contains the campaign interventions. |
{
"Enable_Interventions": 1,
"Campaign_Filename": "campaign.json"
}
|
Enable_Random_Generator_From_Serialized_Population |
boolean |
0 |
1 |
0 |
Determines if the random number generator(s) should be extracted from a serialized population file. Enabling this will start a simulation from this file with the exact same random number stream and location in that stream as when the file was serialized. |
{
"Run_Number": 12,
"Random_Number_Generator_Type": "USE_AES_COUNTER",
"Random_Number_Generator_Policy": "ONE_PER_NODE",
"Enable_Random_Generator_From_Serialized_Population": 1
}
|
Enable_Skipping |
boolean |
0 |
1 |
0 |
Controls whether or not the simulation uses an optimization that can increase performance by up to 50% in some cases by probablistically exposing individuals rather than exposing every single person. Useful in low-prevalence, high-population scenarios. Infectivity_Scale_Type must be set to CONSTANT_INFECTIVITY. |
{
"Exposure_Skipping": 1
}
|
Enable_Termination_On_Zero_Total_Infectivity |
boolean |
0 |
1 |
0 |
Controls whether or not the simulation should be ended when total infectivity falls to zero. Supported only in single-node simulations. |
{
"Enable_Termination_On_Zero_Total_Infectivity": 1,
"Minimum_End_Time": 3650
}
|
Listed_Events |
array of strings |
NA |
NA |
[] |
The list of valid, user-defined events that will be included in the campaign. Any event used in the campaign must either be one of the built-in events or in this list. |
{
"Listed_Events": [
"Vaccinated",
"VaccineExpired"
]
}
|
Memory_Usage_Halting_Threshold_Working_Set_MB |
integer |
0 |
1.00E+06 |
8000 |
The maximum size (in MB) of working set memory before the system throws an exception and halts. |
{
"Memory_Usage_Halting_Threshold_Working_Set_MB": 4000
}
|
Memory_Usage_Warning_Threshold_Working_Set_MB |
integer |
0 |
1.00E+06 |
7000 |
The maximum size (in MB) of working set memory before memory usage statistics are written to the log regardless of log level. |
{
"Memory_Usage_Warning_Threshold_Working_Set_MB": 3500
}
|
Node_Grid_Size |
float |
0.00416 |
90 |
0.004167 |
The spatial resolution indicating the node grid size for a simulation in degrees. |
{
"Node_Grid_Size": 0.042
}
|
Random_Number_Generator_Policy |
enum |
NA |
NA |
ONE_PER_CORE |
The policy that determines if random numbers are generated for objects in a simulation on a per-core or per-node basis. The following values are available:
|
{
"Run_Number": 15,
"Random_Number_Generator_Type": "USE_AES_COUNTER",
"Random_Number_Generator_Policy": "ONE_PER_NODE"
}
|
Random_Number_Generator_Type |
enum |
NA |
NA |
USE_PSEUDO_DES |
The type of random number generator to use for objects in a simulation. Must set the RNG seed in Run_Number. The following values are available:
|
{
"Run_Number": 15,
"Random_Number_Generator_Type": "USE_LINEAR_CONGRUENTIAL",
"Random_Number_Generator_Policy": "ONE_PER_NODE",
"Enable_Random_Generator_From_Serialized_Population": 1
}
|
Run_Number |
integer |
0 |
65535 |
1 |
Sets the random number seed used with Random_Number_Generator_Type and Random_Number_Generator_Policy to assign random numbers to objects in a simulation. |
{
"Run_Number": 15,
"Random_Number_Generator_Type": "USE_PSEUDO_DES",
"Random_Number_Generator_Policy": "ONE_PER_NODE",
"Enable_Random_Generator_From_Serialized_Population": 1
}
|
Serialization_Times |
array of floats |
0 |
The list of times at which to save the serialized state to file. 0 indicates the initial state before simulation, n indicates the time to serialize in terms of start time and step size, and will be rounded up to the nearest time step. The serialized population files can then be loaded at the beginning of a simulation using Serialized_Population_Filenames and Serialized_Population_Path. |
{
"Serialization_Type": "TIME",
"Serialization_Times": [
40.5,
81
]
}
|
||
Serialization_Time_Steps |
array of integers |
0 |
2.15E+09 |
The list of time steps after which to save the serialized state to file. 0 (zero) indicates the initial state before simulation, n indicates after the nth time step. Serialization_Type must be set to TIMESTEP. The serialized population files can then be loaded at the beginning of a simulation using Serialized_Population_Filenames and Serialized_Population_Path. |
{
"Serialization_Type": "TIMESTEP",
"Serialization_Time_Steps": [
0,
10
]
}
|
|
Serialization_Type |
enum |
NA |
NA |
NONE |
The type of serialization to perform. Serialization saves the population state at particular times so you can start from that state in other simulations. Accepted values are:
|
{
"Serialization_Times": [
365,
3650
],
"Serialization_Type": "TIMSTEP"
}
j {}
|
Serialized_Population_Filenames |
array of strings |
NA |
NA |
NA |
An array of filenames with serialized population data. The number of filenames must match the number of cores used for the simulation. The files must be in .dtk format. Serialized population files are created using Serialization_Time_Steps. |
{
"Serialized_Population_Filenames": [
"state-00010.dtk"
]
}
|
Serialized_Population_Path |
string |
NA |
NA |
. |
The root path for the serialized population files. Serialized population files are created using Serialization_Time_Steps. |
{
"Serialized_Population_Path": "../00_Generic_Version_1_save/output"
}
|
Simulation_Duration |
float |
0 |
1000000 |
1 |
The elapsed time (in days) from the start to the end of a simulation. |
{
"Simulation_Duration": 7300
}
|
Simulation_Timestep |
float |
0 |
1000000 |
1 |
The duration of a simulation time step, in days. |
{
"Simulation_Timestep": 1
}
|
Simulation_Type |
enum |
NA |
NA |
GENERIC_SIM |
The type of disease being simulated. Possible IDM-supported values are:
|
{
"Simulation_Type": "STI_SIM"
}
|
Start_Time |
float |
0 |
1000000 |
1 |
The time, in days, when the simulation begins. This time is used to identify the starting values of the temporal input data, such as specifying which day’s climate values should be used for the first day of the simulation. Note The Start_Day of campaign events is in absolute time, so time relative to the beginning of the simulation depends on this parameter. |
{
"Start_Time": 365
}
|