MosquitoRelease
The MosquitoRelease intervention class adds mosquito release vector control programs to the simulation. Mosquito release is a key vector control mechanism that allows the release of sterile males, genetically modified mosquitoes, or even Wolbachia- or Microsporidia-infected mosquitoes. See parameter-configuration-vector-control configuration parameters for more information.
Released vectors are added to the population and participate in the vector life cycle and mating system the same day.
You can also release already-mated females to guarantee specific genomes in the offspring by setting the Released_Mate_Genome parameter.
See vector-model-genetics for information on defining vector genomes, gene drivers, and insecticide resistance alleles. See vector-model-microsporidia for information on microsporidia strains and their transmission dynamics within vector populations.
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.
The table below describes all possible parameters with which this class can be configured. The JSON example that follows shows one potential configuration.
| Parameter | Type | Min | Max | Default | Description |
|---|---|---|---|---|---|
| Cost_To_Consumer | float | 0 | 999999 | 0 | The cost of each mosquito release. |
| Disqualifying_Properties | array of strings | NA | NA | [] | A list of NodeProperty key:value pairs that cause an intervention to be aborted (persistent interventions will stop being distributed to nodes with these values). See IndividualProperties and NodeProperties parameters for more information. Generally used to control the flow of health care access. For example, to prevent the same individual from accessing health care via two different routes at the same time. |
| Dont_Allow_Duplicates | bool | NA | NA | 0 | If set to true (1), does not allow any new interventions with matching Intervention_Name parameter value to be distributed to the node. |
| Intervention_Name | string | NA | NA | MosquitoRelease | The optional name used to refer to this intervention as a means to differentiate it from others that use the same class. |
| New_Property_Value | string | NA | NA | "" | An optional NodeProperty key:value pair that will be assigned when the intervention is applied. See IndividualProperties and NodeProperties parameters for more information. |
| Released_Ratio | float | 0 | 3.40E+038 | 0 | The number of released mosquitoes is proportional to the mosquito population from the previous timestep, specifically considering mosquitoes of the same gender as those being released. This approach is used when on Released_Type is set to RATIO. |
| Released_Genome | array of strings | NA | NA | [] | This defines the alleles of the genome of the vectors to be released. It must define all of the alleles including the gender gene. '' is not allowed. See Vector_Species_Params* for more information. |
| Released_Mate_Genome | array of string arrays | NA | NA | [] | Optional parameter which defines the alleles of the genome of the mate for pre-mated female releases. The Released_Mate_Genome must be male and Released_Genome must be female. It must define all of the alleles including the gender gene. * is not allowed. When this parameter is defined, the released female vectors will be fully gestated and ready to lay eggs, which will be the product of Released_Genome and Released_Mate_Genome. |
| Released_Infectious | float | 0 | 1 | 0 | The fraction of vectors released that are to be infectious. You can only use this feature when Malaria_Model is NOT set to MALARIA_MECHANISTIC_MODEL_WITH_PARASITE_GENETICS. |
| Released_Microsporidia_Strain | string | NA | NA | "" | The name of the microsporidia strain for the released mosquitoes. The strain name must match a strain defined in Vector_Species_Params, Microsporidia for the species being released. An empty string indicates no microsporidia infection. |
| Released_Number | integer | 1 | 100000000.0 | 10000 | The number of mosquitoes released in the intervention. |
| Released_Species | string | NA | NA | NA | The name of the released mosquito species, such as arabiensis. The simulation configuration parameter, Vector_Species_Params, needs to contain that specific mosquito species. |
| Released_Type | enum | NA | NA | FIXED_NUMBER | Specifies the number of mosquitoes to release. Possible values are FRACTION and FIXED_NUMBER. When set to FRACTION, this specifies the fraction of the current population to release. When set to FIXED_NUMBER, specifies an exact count of mosquitoes to release. |
| Released_Wolbachia | enum | NA | NA | WOLBACHIA_FREE | The Wolbachia type of released mosquitoes. Possible values are: WOLBACHIA_FREE VECTOR_WOLBACHIA_A VECTOR_WOLBACHIA_B VECTOR_WOLBACHIA_AB |
{
"Events": [
{
"class": "CampaignEvent",
"Event_Name": "MosquitoRelease",
"Start_Day": 5,
"Nodeset_Config": {"class": "NodeSetAll"},
"Event_Coordinator_Config": {
"class": "StandardInterventionDistributionEventCoordinator",
"Intervention_Config": {
"class": "MosquitoRelease",
"Cost_To_Consumer": 200,
"Released_Type": "Ratio",
"Released_Ratio": 1.5,
"Released_Infectious": 0.5,
"Released_Species": "SillySkeeter",
"Released_Wolbachia": "VECTOR_WOLBACHIA_FREE",
"Released_Genome": [["X", "Y"], ["a1", "a1"]]
}
}
},
{
"class": "CampaignEvent",
"Event_Name": "MosquitoRelease",
"Start_Day": 125,
"Nodeset_Config": {"class": "NodeSetAll"},
"Event_Coordinator_Config": {
"class": "StandardInterventionDistributionEventCoordinator",
"Intervention_Config": {
"class": "MosquitoRelease",
"Cost_To_Consumer": 200,
"Released_Type": "FIXED_NUMBER",
"Released_Number": 35000,
"Released_Species": "SillySkeeter",
"Released_Wolbachia": "VECTOR_WOLBACHIA_A",
"Released_Genome": [["X", "X"], ["b0", "b0"]]
}
}
},
{
"class": "CampaignEvent",
"Event_Name": "MosquitoRelease_Microsporidia",
"Start_Day": 200,
"Nodeset_Config": {"class": "NodeSetAll"},
"Event_Coordinator_Config": {
"class": "StandardInterventionDistributionEventCoordinator",
"Intervention_Config": {
"class": "MosquitoRelease",
"Cost_To_Consumer": 200,
"Released_Type": "FIXED_NUMBER",
"Released_Number": 50000,
"Released_Species": "gambiae",
"Released_Microsporidia_Strain": "Strain_A",
"Released_Genome": [["X", "X"], ["a1", "a1"]]
}
}
},
{
"class": "CampaignEvent",
"Event_Name": "MosquitoRelease Pre-mated",
"Start_Day": 200,
"Nodeset_Config": {"class": "NodeSetAll"},
"Event_Coordinator_Config": {
"class": "StandardInterventionDistributionEventCoordinator",
"Intervention_Config": {
"class": "MosquitoRelease",
"Cost_To_Consumer": 300,
"Released_Type": "FIXED_NUMBER",
"Released_Number": 20000,
"Released_Species": "SillySkeeter",
"Released_Genome": [["X", "X"], ["a1", "a1"]],
"Released_Mate_Genome": [["X", "Y"], ["a1", "a1"]]
}
}
}
],
"Use_Defaults": 1
}