Larval habitat¶
The following parameters determine mosquito larval development related to habitat and climate. For more information, see Larval habitat. Parameters for the vector life cycle more broadly are described in Vector life cycle.
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 |
|---|---|---|---|---|---|---|
Aquatic_Arrhenius_1 |
float |
0 |
1.00E+15 |
8.42E+10 |
The Arrhenius equation, \(a_1^{-a_2/T}\), with T in degrees Kelvin, parameterizes the daily rate of fractional progression of mosquito aquatic development (egg-hatching through emergence). This duration is a decreasing function of temperature. The variable a1 is a temperature-independent scale factor on development rate. |
{
"Vector_Species_Params": {
"aegypti": {
"Aquatic_Arrhenius_1": 9752291.727
}
}
}
|
Aquatic_Arrhenius_2 |
float |
0 |
1.00E+15 |
8328 |
The Arrhenius equation, \(a_1^{-a_2/T}\), with T in degrees Kelvin, parameterizes the daily rate of fractional progression of mosquito aquatic development (egg-hatching through emergence). This duration is a decreasing function of temperature. The variable a2 governs how quickly the rate changes with temperature. |
{
"Vector_Species_Params": {
"arabiensis": {
"Aquatic_Arrhenius_2": 8328
}
}
}
|
Aquatic_Mortality_Rate |
float |
0 |
1 |
0.1 |
The base aquatic mortality per day for the species before adjusting for effects of overpopulation and drying out of aquatic habitat. |
{
"Vector_Species_Params": {
"arabiensis": {
"Aquatic_Mortality_Rate": 0.1
}
}
}
|
Drought_Egg_Hatch_Delay |
float |
0 |
1 |
0.33 |
Proportion of regular egg hatching that still occurs when habitat dries up. Enable_Drought_Egg_Hatch_Delay must be set to 1. |
{
"Enable_Drought_Egg_Hatch_Delay": 1,
"Drought_Egg_Hatch_Delay": 0.33
}
|
Egg_Arrhenius1 |
float |
0 |
1.00E+10 |
6.16E+07 |
The Arrhenius equation, \(a_1^{-a_2/T}\), with T in degrees Kelvin, parameterizes the daily rate of mosquito egg hatching. This duration is a decreasing function of temperature. The variable a1 is a temperature-independent scale factor on hatching rate. Enable_Temperature_Dependent_Egg_Hatching must be set to 1. |
{
"Enable_Temperature_Dependent_Egg_Hatching": 1,
"Egg_Arrhenius1": 61599956,
"Egg_Arrhenius2": 5754
}
|
Egg_Arrhenius2 |
float |
0 |
1.00E+10 |
5754.03 |
The Arrhenius equation, \(a_1^{-a_2/T}\), with T in degrees Kelvin, parameterizes the daily rate of mosquito egg hatching. This duration is a decreasing function of temperature. The variable a2 is a temperature-dependent scale factor on hatching rate. Enable_Temperature_Dependent_Egg_Hatching must be set to 1. |
{
"Enable_Temperature_Dependent_Egg_Hatching": 1,
"Egg_Arrhenius1": 61599956,
"Egg_Arrhenius2": 5754
}
|
Egg_Hatch_Density_Dependence |
enum |
NA |
NA |
NO_DENSITY_DEPENDENCE |
The effect of larval density on egg hatching rate. Possible values are:
|
{
"Egg_Hatch_Density_Dependence": "NO_DENSITY_DEPENDENCE"
}
|
Egg_Saturation_At_Oviposition |
enum |
NA |
NA |
NO_SATURATION |
If laying all eggs from ovipositing females would overflow the larval habitat capacity on a given day, the means by which the viable eggs become saturated. Possible values are:
|
{
"Egg_Saturation_At_Oviposition": "SATURATION_AT_OVIPOSITION"
}
|
Enable_Drought_Egg_Hatch_Delay |
boolean |
0 |
1 |
0 |
Controls whether or not eggs hatch at delayed rates, set by Drought_Egg_Hatch_Delay, when the habitat dries up completely. |
{
"Enable_Drought_Egg_Hatch_Delay": 1,
"Drought_Egg_Hatch_Delay": 0.33
}
|
Enable_Egg_Mortality |
boolean |
0 |
1 |
0 |
Controls whether or not to include a daily mortality rate on the egg population, which is independent of climatic factors. |
{
"Enable_Egg_Mortality": 1
}
|
Enable_Temperature_Dependent_Egg_Hatching |
boolean |
0 |
1 |
0 |
Controls whether or not temperature has an effect on egg hatching, defined by Egg_Arrhenius_1 and Egg_Arrhenius_2. |
{
"Enable_Temperature_Dependent_Egg_Hatching": 1,
"Egg_Arrhenius1": 61599956.864,
"Egg_Arrhenius2": 5754.033
}
|
Larval_Density_Dependence |
enum |
NA |
NA |
UNIFORM_WHEN_OVERPOPULATION |
The functional form of mortality and growth delay for mosquito larvae based on population density. Possible values are:
|
{
"Larval_Density_Dependence": "GRADUAL_INSTAR_SPECIFIC"
}
|
Larval_Habitat_Types |
JSON object |
NA |
NA |
NA |
A measure of the habitat type and scale factors used to estimate larval population. This parameter is a dictionary that specifies habitat type with a simple numeric scale factor or, for LINEAR_SPLINE, with a more detailed configuration for scaling. The numeric scaling value represents larval density with the number of larvae in a 1x1-degree area. The factor multiplicatively scales the resulting weather or population-dependent functional form. See Larval habitat for more information. Possible habitat values are:
The values set here can be scaled per node using LarvalHabitatMultiplier in the demographics file (see NodeAttributes) or per intervention using Larval_Habitat_Multiplier in the campaign file (see ScaleLarvalHabitat). |
The following example shows how to specify larval habitat using LINEAR_SPLINE. {
"Vector_Species_Params": {
"arabiensis": {
"Larval_Habitat_Types": {
"LINEAR_SPLINE": {
"Capacity_Distribution_Per_Year": {
"Times": [
0,
60.833,
121.667,
182.5,
204.167,
243.333
],
"Values": [
0,
0,
0.2,
1,
0.5,
0
]
},
"Max_Larval_Capacity": 10000000000
}
}
}
}
}
The following example shows how to specify the larval habitat using climatological habitat types (you may use one or more for each vector species). {
"arabiensis": {
"Larval_Habitat_Types": {
"BRACKISH_SWAMP": 30000000,
"TEMPORARY_RAINFALL": 11250000000,
"WATER_VEGETATION": 6000000000
}
}
}
|
Larval_Rainfall_Mortality_Threshold |
float |
0.01 |
1000 |
100 |
The threshold value on daily rainfall in millimeters, above which larval mortality is applied when Vector_Larval_Rainfall_Mortality is set to either SIGMOID or SIGMOID_HABITAT_SHIFTING. |
{
"Larval_Rainfall_Mortality_Threshold": 30.0
}
|
Rainfall_In_mm_To_Fill_Swamp |
float |
1 |
10000 |
1000 |
Millimeters of rain to fill larval habitat to capacity. This is only used for vector species with Larval_Habitat_Types set to BRACKISH_SWAMP. |
{
"Rainfall_In_mm_To_Fill_Swamp": 1000.0
}
|
Semipermanent_Habitat_Decay_Rate |
float |
0.0001 |
100 |
0.01 |
Daily rate of larval habitat loss for semi-permanent habitats with Larval_Habitat_Types parameter value of WATER_VEGETATION or BRACKISH_SWAMP. |
{
"Semipermanent_Habitat_Decay_Rate": 0.01
}
|
Temporary_Habitat_Decay_Factor |
float |
0.001 |
100 |
0.05 |
The factor to convert raw evaporation rate (ignoring boundary layer effects) to the daily rate of larval habitat loss for temporary habitats (Larval_Habitat_Types set to TEMPORARY_RAINFALL). Units are (larval carrying capacity per day) / (kg per square meter per second). |
{
"Temporary_Habitat_Decay_Factor": 0.05
}
|
Vector_Larval_Rainfall_Mortality |
enum |
NA |
NA |
NONE |
The type of vector larval mortality function due to rainfall. Possible values are:
|
{
"Vector_Larval_Rainfall_Mortality": "SIGMOID"
}
|
Vector_Migration_Habitat_Modifier |
float |
0 |
3.40E+38 |
0 |
The preference of a vector to migrate toward a node with more habitat. Only used when Vector_Sampling_Type is set to TRACK_ALL_VECTORS. Enable_Vector_Migration must be set to 1. |
{
"Vector_Migration_Habitat_Modifier": 1.0
}
|
x_Larval_Habitats |
float |
0 |
10000 |
1 |
Scale factor for the habitat size for all mosquito populations. |
{
"x_Larval_Habitats": 1
}
|