Outbreak¶
The Outbreak class allows the introduction of a disease outbreak event by the addition of new infected individuals or infection of existing individuals in a node. Outbreak is a node-level intervention; to distribute an outbreak to specific categories of existing individuals within a node, use OutbreakIndividual.
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.
The table below describes all possible parameters with which this class can be configured. The JSON example that follows shows one potential configuration.
Parameter |
Data type |
Minimum |
Maximum |
Default |
Description |
Example |
---|---|---|---|---|---|---|
Antigen |
integer |
0 |
10 |
0 |
The antigenic base strain ID of the outbreak infection. This must not exceed the number specified in the configuration parameter Number_Basestrains. |
{
"Intervention_Config": {
"Antigen": 0,
"Genome": 0,
"Outbreak_Source": "PrevalenceIncrease",
"class": "OutbreakIndividual"
}
}
|
Genome |
integer |
-1 |
16777216 |
0 |
The genetic substrain ID of the outbreak infection. This must not exceed the number specified in the configuration parameter Number_Substrains. |
{
"Intervention_Config": {
"Antigen": 0,
"Genome": 0,
"Outbreak_Source": "PrevalenceIncrease",
"class": "OutbreakIndividual",
"Incubation_Period_Override": 0
}
}
|
Import_Age |
float |
0 |
43800 |
365 |
The age (in days) of infected import cases. |
{
"Import_Age": 10000
}
|
Incubation_Period_Override |
integer |
-1 |
2.15E+0 |
-1 |
The incubation period, in days, that infected individuals will go through before becoming infectious. This value overrides the incubation period set in the configuration file. Set to -1 to honor the configuration parameter settings. |
{
"Incubation_Period_Override": 0
}
|
Number_Cases_Per_Node |
integer |
0 |
2.15E+0 |
1 |
The number of new cases of Outbreak to import (per node). Note This will increase the population and there is no control over demographics of these individuals. |
{
"Intervention_Config": {
"Antigen": 0,
"Genome": 0,
"Outbreak_Source": "ImportCases",
"Number_Cases_Per_Node": 10,
"class": "Outbreak"
}
}
|
Probability_Of_Infection |
float |
0 |
1 |
1 |
The probability that each individual added by the intervention is infected. 0.0 adds only susceptible individuals to the population. |
{
"Probability_Of_Infection": 1
}
|
{
"Use_Defaults": 1,
"Events": [{
"class": "CampaignEvent",
"Nodeset_Config": {
"class": "NodeSetAll"
},
"Start_Day": 40,
"Event_Coordinator_Config": {
"class": "StandardInterventionDistributionEventCoordinator",
"Intervention_Config": {
"class": "Outbreak",
"Antigen": 0,
"Genome": 0,
"Number_Cases_Per_Node": 10
}
}
}]
}