General disease¶
The following parameters determine general disease characteristics.
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 format does not permit comments, but you can add “dummy” parameters to add contextual information to your files. Any keys that are not EMOD parameter names will be ignored by the model.
Parameter |
Data type |
Minimum |
Maximum |
Default |
Description |
Example |
|---|---|---|---|---|---|---|
Enable_Strain_Tracking |
boolean |
0 |
1 |
0 |
Enable an association of an infection with a specified strain, defined by unique integers for a clade and a genome. For infections distributed through interventions, you specify clade and genome values using the Clade and Genome parameters with the Outbreak and OutbreakIndividual intervention classes in the campaign file. When using an initial prevalence distribution, you specify clade and genome values using the InitialPrevalenceStrains parameter as part of IndividualAttributes in the demographics file. When Enable_Strain_Tracking is set to false (0) or absent, all infections are associated with a single strain that has clade and genome identity (0, 0). When Enable_Strain_Tracking is set to true (1) then both Number_of_Clades and Log2_Number_of_Genomes_per_Clade parameters must be specified. Warning Do not set both Enable_Strain_Tracking and Enable_Infectivity_Reservoir to true (1) or Enable_Strain_Tracking and Enable_Maternal_Infection_Transmission to true (1) - as these combinations will cause an exception error. |
{
"Enable_Strain_Tracking": 1,
"Log2_Number_of_Genomes_per_Clade": 8,
"Number_of_Clades": 2
}
|
Log2_Number_of_Genomes_per_Clade |
integer |
0 |
24 |
0 |
The maximum number of genome combinations per clades. Used with Number_of_Clades and dependent upon Enable_Strain_Tracking enabled, set to 1. Note Log2_Number_of_Genomes_per_Clade is internally fixed to 0 when using Typhoid and Malaria simulations. |
{
"Enable_Strain_Tracking": 1,
"Log2_Number_of_Genomes_per_Clade": 8,
"Number_of_Clades": 2
}
|
Number_of_Clades |
integer |
1 |
10 |
1 |
The maximum number of distinct clades in the simulation. Used with Log2_Number_of_Genomes_per_Clade to define the strain associated with an infection. Dependent upon Enable_Strain_Tracking enabled, set to 1. |
{
"Enable_Strain_Tracking": 1,
"Log2_Number_of_Genomes_per_Clade": 8,
"Number_of_Clades": 2
}
|