CampaignEvent¶

The CampaignEvent event class determines when to distribute the intervention based on the first day of the simulation. See the following JSON example and table, which shows all available parameters for this campaign event.

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	Data type	Minimum	Maximum	Default	Description	Example
Event_Coordinator_Config	JSON object	NA	NA	NA	An object that specifies how the event is handled by the simulation. It specifies which Event Coordinator class will handle the event, and then configures the coordinator. This description starts with specifying class, and then the other fields depend on the class.	{ "Event_Coordinator_Config": { "class": "StandardInterventionDistributionEventCoordinator", "Demographic_Coverage": 1.0 } }
Event_Name	string	NA	NA	NA	The optional name used to refer to this event as a means to differentiate it from others that use the same class.	{ "Events": [ { "Event_Name": "Outbreak", "class": "CampaignEvent", "Nodeset_Config": "NodeSetAll" } ] }
Nodeset_Config	JSON object	NA	NA	NA	An object that specifies in which nodes the interventions will be distributed. Set to one of the Nodeset_Config classes.	{ "Nodeset_Config": { "class": "NodeSetAll" } }
Start_Day	float	-1	3.40282e+38	1	The day of the simulation to activate the event’s event coordinator. Depending on the event coordinator and intervention, this may indicate when to distribute an intervention or when to begin listening for a trigger.	{ "Start_Day": 0, "End_Day": 100 }

{
    "Events": [{
        "class": "CampaignEvent",
        "Event_Name": "Individual outbreak",
        "Start_Day": 1,
        "Nodeset_Config": {
            "class": "NodeSetAll"
        },
        "Event_Coordinator_Config": {
            "class": "StandardInterventionDistributionEventCoordinator",
            "Target_Demographic": "Everyone",
            "Demographic_Coverage": 1.0,
            "Intervention_Config": {
                "class": "OutbreakIndividual"
            }
        }
    }]
}

Nodeset_Config classes¶

The following classes determine in which nodes the event will occur.

NodeSetAll¶

The event will occur in all nodes in the simulation. This class has no associated parameters. For example,

{
    "Nodeset_Config": {
        "class": "NodeSetAll"
    }
}

NodeSetNodeList¶

The event will occur in the nodes listed by Node ID.

Parameter	Data type	Minimum	Maximum	Default	Description	Example
Node_List	array of integers	NA	NA	NA	A comma-separated list of node IDs in which this event will occur.	{ "Nodeset_Config": { "class": "NodeSetNodeList", "Node_List": [ 1, 5, 27 ] } }

NodeSetPolygon¶

The event will occur in the nodes that fall within a given polygon.

Parameter

Data type

Minimum

Maximum

Default

Description

Example

Polygon_Format

enum

NA

SHAPE

The type of polygon to create. Currently, SHAPE is the only supported value.

{
    "Nodeset_Config": {
        "class": "NodeSetPolygon",
        "Polygon_Format": "SHAPE",
        "Vertices": "-122.320726936496,47.6597902588541 -122.320406460197,47.6520988276782 -122.308388598985,47.6471314450438"
    }
}

Vertices

string

NA

UNINTIALIZED STRING

Comma-separated list of latitude/longitude points that bound a polygon.

{
    "Nodeset_Config": {
        "class": "NodeSetPolygon",
        "Polygon_Format": "SHAPE",
        "Vertices": "-122.320726936496,47.6597902588541 -122.320406460197,47.6520988276782 -122.308388598985,47.6471314450438"
    }
}