Output settings¶
The following parameters configure whether or not output reports are created for the simulation, such as reports detailing spatial or demographic data at each time step. By default, the InsetChart is always created.
The following figures are examples for the parameter Report_HIV_Period.
When Report_HIV_Period is set to a value that is less than the Simulation_Timestep, a record will be written during the next time step after the reported period. More than one period may occur before the next time step.
When Report_HIV_Period is greater than Simulation_Timestep, a record will be written during the next time step after the period occurs. This means that a record may not be written at all time steps.
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 |
|||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Custom_Coordinator_Events |
array of strings |
NA |
NA |
NA |
The list of valid, user-defined events for Event Coordinators that will be included in the campaign. Any event used in the campaign must either be one of the built-in events or in this list. Note: This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Coordinator_Events": [
"Coordinator_Event_1",
"Coordinator_Event_2",
"Coordinator_Event_3"
]
}
|
|||||||||||||||
Custom_Individual_Events |
array of strings |
NA |
NA |
NA |
The list of valid, user-defined events that will be included in the campaign. Any event used in the campaign must either be one of the built-in events or in this list. Note This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Individual_Events": [
"Individual_Event_1",
"Individual_Event_2",
"Individual_Event_3"
]
}
|
|||||||||||||||
Custom_Node_Events |
array of strings |
NA |
NA |
NA |
The list of valid, user-defined events for nodes that will be included in the campaign. Any event used in the campaign must either be one of the built-in events or in this list. Note This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Node_Events": [
"Node_Event_1",
"Node_Event_2",
"Node_Event_3"
]
}
|
|||||||||||||||
Custom_Reports_Filename |
string |
NA |
NA |
UNINITIALIZED STRING |
The name of the file containing custom report configuration parameters. Omitting this parameter or setting it to RunAllCustomReports will load all reporters found that are valid for the given simulation type. The file must be in JSON format. |
{
"Custom_Reports_Filename": "custom_reports.json"
}
|
|||||||||||||||
Enable_Default_Reporting |
boolean |
0 |
1 |
1 |
Controls whether or not the default InsetChart.json report is created. |
{
"Enable_Default_Reporting": 1
}
|
|||||||||||||||
Enable_Demographics_Reporting |
boolean |
0 |
1 |
1 |
Controls whether or not demographic summary data and age-binned reports are outputted to file. |
{
"Enable_Demographics_Reporting": 1
}
|
|||||||||||||||
Enable_Property_Output |
boolean |
0 |
1 |
0 |
Controls whether or not to create property output reports, which detail groups as defined in IndividualProperties in the demographics file (see NodeProperties and IndividualProperties parameters). When there is more than one property type, the report will display the channel information for all combinations of the property type groups. |
{
"Enable_Property_Output": 1
}
|
|||||||||||||||
Enable_Spatial_Output |
boolean |
0 |
1 |
0 |
Controls whether or not spatial output reports are created. If set to true (1), spatial output reports include all channels listed in the parameter Spatial_Output_Channels. Note Spatial output files require significant processing time and disk space. |
{
"Enable_Spatial_Output": 1,
"Spatial_Output_Channels": [
"Prevalence",
"New_Infections"
]
}
|
|||||||||||||||
Report_Coital_Acts |
boolean |
0 |
1 |
0 |
Set to true (1) to enable or to false (0) to disable the RelationshipConsummatedReport.csv output report. |
{
"Report_Coital_Acts": 1
}
|
|||||||||||||||
Report_Coordinator_Event_Recorder |
boolean |
0 |
1 |
0 |
Enables or disables the ReportCoordinatorEventRecorder.csv output report for coordinator events. When enabled (set to 1) reports will be generated for the broadcasted valid coordinator events, as specified in Report_Coordinator_Event_Recorder_Events. Note: This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Coordinator_Events": [
"Coordinator_Event_1",
"Coordinator_Event_2",
"Coordinator_Event_3"
],
"Report_Coordinator_Event_Recorder": 1,
"Report_Coordinator_Event_Recorder_Events": [
"Coordinator_Event_1",
"Coordinator_Event_2",
"Coordinator_Event_3"
]
}
|
|||||||||||||||
Report_Coordinator_Event_Recorder_Events |
array of strings |
NA |
NA |
NA |
The list of events to include or exclude in the ReportCoordinatorEventRecorder.csv output report, based on how Report_Coordinator_Event_Recorder_Ignore_Events_In_List is set. This list must not be empty and is dependent upon Report_Coordinator_Event_Recorder being enabled. In addition, the events must be defined in Customer_Coordinator_Events. Note: This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Coordinator_Events": [
"Coordinator_Event_1",
"Coordinator_Event_2",
"Coordinator_Event_3"
],
"Report_Coordinator_Event_Recorder": 1,
"Report_Coordinator_Event_Recorder_Events": [
"Coordinator_Event_1",
"Coordinator_Event_2",
"Coordinator_Event_3"
]
}
|
|||||||||||||||
Report_Coordinator_Event_Recorder_Ignore_Events_In_List |
boolean |
0 |
1 |
0 |
If set to false (0), only the events listed in the Report_Coordinator_Event_Recorder_Events array will be included in the ReportCoordinatorEventRecorder.csv output report. If set to true (1), only the events listed in the array will be excluded, and all other events will be included. If you want to return all events from the simulation, leave the events array empty. Note: This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Coordinator_Events": [
"Coordinator_Event_1",
"Coordinator_Event_2",
"Coordinator_Event_3"
],
"Report_Coordinator_Event_Recorder": 1,
"Report_Coordinator_Event_Recorder_Events": [
"Coordinator_Event_1",
"Coordinator_Event_2",
"Coordinator_Event_3"
],
"Report_Coordinator_Event_Recorder_Ignore_Events_In_List": 0
}
|
|||||||||||||||
Report_Event_Recorder |
boolean |
0 |
1 |
0 |
Set to true (1) to enable or to false (0) to disable the ReportEventRecorder.csv output report that lists individual events in the simulation. See Event list for a list of all possible built-in events that will be recorded in the output when enabled. |
{
"Report_Event_Recorder": 1,
"Report_Event_Recorder_Events": [
"VaccinatedA",
"VaccineExpiredA",
"VaccinatedB",
"VaccineExpiredB"
],
"Report_Event_Recorder_Ignore_Events_In_List": 0
}
|
|||||||||||||||
Report_Event_Recorder_Events |
array |
NA |
NA |
The list of events to include or exclude in the ReportEventRecorder.csv output report, based on how Report_Event_Recorder_Ignore_Events_In_List is set. See Event list for a list of all possible built-in events. You can also define events in Custom_Individual_Events. The list cannot be empty. |
{
"Report_Event_Recorder": 1,
"Report_Event_Recorder_Events": [
"VaccinatedA",
"VaccineExpiredA",
"VaccinatedB",
"VaccineExpiredB"
],
"Report_Event_Recorder_Ignore_Events_In_List": 0
}
|
||||||||||||||||
Report_Event_Recorder_Ignore_Events_In_List |
boolean |
0 |
1 |
0 |
If set to false (0), only the events listed in the Report_Event_Recorder_Events array will be included in the ReportEventRecorder.csv output report. If set to true (1), only the events listed in the array will be excluded, and all other events will be included. If you want to return all events from the simulation, leave the events array empty.
|
{
"Report_Event_Recorder": 1,
"Report_Event_Recorder_Events": [
"VaccinatedA",
"VaccineExpiredA",
"VaccinatedB",
"VaccineExpiredB"
],
"Report_Event_Recorder_Ignore_Events_In_List": 0
}
|
|||||||||||||||
Report_Event_Recorder_Individual_Properties |
array of strings |
NA |
NA |
[] |
Specifies an array of (optional) individual property keys, as defined in IndividualProperties in the demographics file, to be added as additional columns to the output report. Individual’s IP value will be added to the (key) column at the time of the event. |
{
"Report_Event_Recorder_Individual_Properties": [
"Accessibility",
"Risk"
]
}
|
|||||||||||||||
Report_Event_Recorder_Start_Day |
float |
0 |
3.40282e+38 |
0 |
The day of the simulation to start collecting data. |
{
"Report_Event_Recorder": 1,
"Report_Event_Recorder_Start_Day": 365,
"Report_Event_Recorder_End_Day": 730,
"Report_Event_Recorder_Events": [
"VaccinatedA",
"VaccineExpiredA",
"VaccinatedB",
"VaccineExpiredB"
],
"Report_Event_Recorder_Ignore_Events_In_List": 0
}
|
|||||||||||||||
Report_Event_Recorder_End_Day |
float |
0 |
3.40282e+38 |
3.40282e+38 |
The day of the simulation to stop collecting data. |
{
"Report_Event_Recorder": 1,
"Report_Event_Recorder_Start_Day": 365,
"Report_Event_Recorder_End_Day": 730,
"Report_Event_Recorder_Events": [
"VaccinatedA",
"VaccineExpiredA",
"VaccinatedB",
"VaccineExpiredB"
],
"Report_Event_Recorder_Ignore_Events_In_List": 0
}
|
|||||||||||||||
Report_Event_Recorder_Node_IDs_Of_Interest |
array of integers |
0 |
2.14748e+09 |
[] |
Data will be collected for the nodes in this list. |
{
"Report_Event_Recorder": 1,
"Report_Event_Recorder_Start_Day": 365,
"Report_Event_Recorder_End_Day": 730,
"Report_Event_Recorder_Node_IDs_Of_Interest": [ 2, 7 ],
"Report_Event_Recorder_Events": [
"VaccinatedA",
"VaccineExpiredA",
"VaccinatedB",
"VaccineExpiredB"
],
"Report_Event_Recorder_Ignore_Events_In_List": 0
}
|
|||||||||||||||
Report_Event_Recorder_Min_Age_Years |
float |
0 |
|
0 |
Minimum age in years of people to collect data on. |
{
"Report_Event_Recorder": 1,
"Report_Event_Recorder_Start_Day": 365,
"Report_Event_Recorder_End_Day": 730,
"Report_Event_Recorder_Min_Age_Years": 5,
"Report_Event_Recorder_Max_Age_Years": 10,
"Report_Event_Recorder_Events": [
"VaccinatedA",
"VaccineExpiredA",
"VaccinatedB",
"VaccineExpiredB"
],
"Report_Event_Recorder_Ignore_Events_In_List": 0
}
|
|||||||||||||||
Report_Event_Recorder_Max_Age_Years |
float |
0 |
|
|
Maximum age in years of people to collect data on. |
{
"Report_Event_Recorder": 1,
"Report_Event_Recorder_Start_Day": 365,
"Report_Event_Recorder_End_Day": 730,
"Report_Event_Recorder_Min_Age_Years": 5,
"Report_Event_Recorder_Max_Age_Years": 10,
"Report_Event_Recorder_Events": [
"VaccinatedA",
"VaccineExpiredA",
"VaccinatedB",
"VaccineExpiredB"
],
"Report_Event_Recorder_Ignore_Events_In_List": 0
}
|
|||||||||||||||
Report_Event_Recorder_Must_Have_IP_Key_Value |
string |
NA |
NA |
(empty string) |
A Key:Value pair that the individual must have in order to be included. Empty string means to not include IPs in the selection criteria. |
{
"Report_Event_Recorder": 1,
"Report_Event_Recorder_Start_Day": 365,
"Report_Event_Recorder_End_Day": 730,
"Report_Event_Recorder_Min_Age_Years": 5,
"Report_Event_Recorder_Max_Age_Years": 10,
"Report_Event_Recorder_Must_Have_IP_Key_Value": "Risk:LOW",
"Report_Event_Recorder_Events": [
"VaccinatedA",
"VaccineExpiredA",
"VaccinatedB",
"VaccineExpiredB"
],
"Report_Event_Recorder_Ignore_Events_In_List": 0
}
|
|||||||||||||||
Report_Event_Recorder_Must_Have_Intervention |
string |
NA |
NA |
(empty string) |
The name of the intervention that the person must have in order to be included. Empty string means to not include interventions in the selection criteria. |
{
"Report_Event_Recorder": 1,
"Report_Event_Recorder_Start_Day": 365,
"Report_Event_Recorder_End_Day": 730,
"Report_Event_Recorder_Min_Age_Years": 5,
"Report_Event_Recorder_Max_Age_Years": 10,
"Report_Event_Recorder_Must_Have_IP_Key_Value": "Risk:LOW",
"Report_Event_Recorder_Must_Have_Intervention": "UsageDependentBednet",
"Report_Event_Recorder_Events": [
"VaccinatedA",
"VaccineExpiredA",
"VaccinatedB",
"VaccineExpiredB"
],
"Report_Event_Recorder_Ignore_Events_In_List": 0
}
|
|||||||||||||||
Report_HIV_ART |
boolean |
0 |
1 |
0 |
Set to true (1) to enable or to false (0) to disable the ReportHIVART.csv output report. |
{
"Report_HIV_ART": 0
}
|
|||||||||||||||
Report_HIV_ByAgeAndGender |
boolean |
0 |
1 |
0 |
Set to true (1) to enable or to false (0) to disable the ReportHIVByAgeAndGener.csv output report. |
{
"Report_HIV_ByAgeAndGender": 1
}
|
|||||||||||||||
Report_HIV_ByAgeAndGender_Add_Concordant_Relationships |
boolean |
0 |
1 |
0 |
When set to true (1), a ‘concordant’ column for each relationship type, as defined with the Society parameter in the demographics file, is included in the ReportHIVByAgeAndGender.csv output report file. Each ‘concordant’ column will include the number of concordant relationships, where both partners have the same disease status. |
{
"Report_HIV_ByAgeAndGender_Add_Concordant_Relationships": 1
}
|
|||||||||||||||
Report_HIV_ByAgeAndGender_Add_Relationships |
boolean |
0 |
1 |
0 |
Sets whether or not the ReportHIVByAgeAndGender.csv output file will contain data by relationship type on population currently in a relationship and ever in a relationship. A sum of those in two or more partnerships and a sum of the lifetime number of relationships in each bin will be included. |
{
"Report_HIV_ByAgeAndGender_Add_Relationships": 1
}
|
|||||||||||||||
Report_HIV_ByAgeAndGender_Add_Transmitters |
boolean |
0 |
1 |
0 |
When set to to true (1), the ‘transmitters’ column is included in the output report. For a given row, ‘Transmitters’ indicates how many people that have transmitted the disease meet the specifications of that row. |
{
"Report_HIV_ByAgeAndGender_Add_Transmitters": 1
}
|
|||||||||||||||
Report_HIV_ByAgeAndGender_Collect_Age_Bins_Data |
array of floats |
-3.40282e+38 |
3.40282e+38 |
1 |
This array of floats allows the user to define the age bins used to stratify the report by age. Each value defines the minimum value of that bin, while the next value defines the maximum value of the bin. The maximum number of age bins is 100. For example, if you had: “Report_HIV_ByAgeAndGender_Collect_Age_Bins_Data” : [ 0, 10, 20, 50, 100 ] The report would have the following age bins: From 0 up to (but not including) 10, from 10 up to (but not including) 20, from 20 up to (but not including) 50, from 50 up to (but not including) 100, and 100 and over. If no values are specified in the array, then the output report will have no age binning. |
{
"Report_HIV_ByAgeAndGender_Collect_Age_Bins_Data": [
0,
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26,
27,
28,
29,
30,
31,
32,
33,
34,
35,
36,
37,
38,
39,
40,
41,
42,
43,
44,
45,
46,
47,
48,
49,
50,
51,
52,
53,
54,
55,
56,
57,
58,
59,
60,
61,
62,
63,
64,
65,
66,
67,
68,
69,
70,
71,
72,
73,
74,
75,
76,
77,
78,
79,
80,
81,
82,
83,
84,
85,
86,
87,
88,
89,
90,
91,
92,
93,
94,
95,
96,
97,
98,
99
]
}
|
|||||||||||||||
Report_HIV_ByAgeAndGender_Collect_Circumcision_Data |
boolean |
0 |
1 |
0 |
When set to 1, the ReportHIVByAgeAndGender.csv output report will have separate rows for those who do or do not have the MaleCircumcision intervention and an additional column with 0 and 1 indicating whether the row corresponds to those who are or are not circumcised. Setting this to 1 doubles the number of rows in ReportHIVByAgeAndGender.csv. |
{
"Report_HIV_ByAgeAndGender_Collect_Circumcision_Data": 0
}
|
|||||||||||||||
Report_HIV_ByAgeAndGender_Collect_Gender_Data |
boolean |
0 |
1 |
0 |
Controls whether or not the report is stratified by gender; to enable gender stratification, set to true (1). |
{
"Report_HIV_ByAgeAndGender_Collect_Gender_Data": 1
}
|
|||||||||||||||
Report_HIV_ByAgeAndGender_Collect_HIV_Data |
boolean |
0 |
1 |
0 |
When set to 1, data in the ReportHIVByAgeAndGender.csv output report will be stratified by those who do or do not have HIV. Setting this to 1 doubles the number of rows in ReportHIVByAgeAndGender.csv. |
{
"Report_HIV_ByAgeAndGender_Collect_HIV_Data": 1
}
|
|||||||||||||||
Report_HIV_ByAgeAndGender_Collect_Intervention_Data |
array of strings |
NA |
NA |
NA |
Stratifies the population by adding a column of 0s and 1s depending on whether or not the person has the indicated intervention. This only works for interventions that remain with a person for a period of time, such as ART, VMMC, vaccine/PrEP, or a delay state in the cascade of care. You can name the intervention by adding a parameter Intervention_Name in the campaign file, and then give this parameter the same Intervention_Name. This allows you to have multiple types of vaccines, VMMCs, etc., but to only stratify on the type you want. |
{
"Report_HIV_ByAgeAndGender_Collect_Intervention_Data": [
"ART_Intervention",
"PrEP_Intervention"
]
}
|
|||||||||||||||
Report_HIV_ByAgeAndGender_Collect_IP_Data |
boolean |
0 |
1 |
0 |
When set to 1, the ReportHIVByAgeAndGender.csvoutput report will have separate rows for those with different IndividualProperties values and an additional column for each property indicating which row corresponds to which value of that property. Setting this to 1 typically increases by severalfold the number of rows in ReportHIVByAgeAndGender.csv. |
{
"Report_HIV_ByAgeAndGender_Collect_IP_Data": 0
}
|
|||||||||||||||
Report_HIV_ByAgeAndGender_Collect_On_Art_Data |
boolean |
0 |
1 |
0 |
Controls whether or not the output report is stratified by those people who are on ART and those who are not. Set to true (1) to enable stratification by ART status. |
{
"Report_HIV_ByAgeAndGender_Collect_On_Art_Data": 1
}
|
|||||||||||||||
Report_HIV_ByAgeAndGender_Event_Counter_List |
array of strings |
NA |
NA |
NA |
A list of columns to add to the ReportHIVByAgeAndGender.csv output files counting the number of times an intervention with the corresponding Distributed_Event_Trigger has been distributed. Note that the interventions will be specified in the campaign file. |
{
"Report_HIV_ByAgeAndGender_Event_Counter_List": [
"Reduced_Acquire_Lowest",
"Reduced_Acquire_Medium",
"Reduced_Acquire_Low",
"Reduced_Acquire_Highest_Not_Duplicated"
]
}
|
|||||||||||||||
Report_HIV_ByAgeAndGender_Has_Intervention_With_Name |
string |
NA |
NA |
“” |
This parameter will be deprecated. We recommend you use Report_HIV_ByAgeAndGender_Collect_Intervention_Data instead. |
{
"Report_HIV_ByAgeAndGender_Has_Intervention_With_Name": "VaccineA"
}
|
|||||||||||||||
Report_HIV_ByAgeAndGender_Start_Year |
float |
1900 |
2200 |
1900 |
The beginning calendar year that will be collected by the ReportHIVByAgeAndGender.csv report. |
{
"Report_HIV_ByAgeAndGender_Start_Year": 1962,
"Report_HIV_ByAgeAndGender_Stop_Year": 1978
}
|
|||||||||||||||
Report_HIV_ByAgeAndGender_Stop_Year |
float |
1900 |
2200 |
2200 |
The ending calendar year that will be collected by the HIVByAgeAndGender.csv report. |
{
"Report_HIV_ByAgeAndGender_Start_Year": 1962,
"Report_HIV_ByAgeAndGender_Stop_Year": 1978
}
|
|||||||||||||||
Report_HIV_ByAgeAndGender_Stratify_Infected_By_CD4 |
boolean |
0 |
1 |
0 |
When set to 1, the ReportHIVByAgeAndGender.csv output file will separate the count of the number of infected individuals by CD4 stratum. When set to 0, the number of infected individuals are aggregated into one column regardless of CD4 count. |
{
"Report_HIV_ByAgeAndGender_Stratify_Infected_By_CD4": 0
}
|
|||||||||||||||
Report_HIV_Event_Channels_List |
array of strings |
NA |
NA |
NA |
This is the list of events included in the InsetChart report. If events are specified with this parameter, the InsetChart will include a channel for each event listed. If no events are listed, a “Number of Events” channel will display the total number of all events that occurred during the simulation. |
{
"Report_HIV_Event_Channels_List": [
"NewInfectionEvent",
"HIVNeedsHIVTest",
"HIVPositiveHIVTest",
"HIVNegativeHIVTest",
"HIVDiagnosedEligibleForART",
"HIVSymptomatic",
"DiseaseDeaths",
"NonDiseaseDeaths",
"Births"
]
}
|
|||||||||||||||
Report_HIV_Infection |
boolean |
0 |
1 |
0 |
Enables or disables the ReportHIVInfection.csv output report. |
{
"Report_HIV_Infection": 0
}
|
|||||||||||||||
Report_HIV_Infection_Start_Year |
float |
1900 |
2200 |
1900 |
The beginning calendar year that will be collected by the ReportHIVInfection.csv output report. Report_HIV_Infection must be set to 1. |
{
"Report_HIV_Infection_Start_Year": 1900
}
|
|||||||||||||||
Report_HIV_Infection_Stop_Year |
float |
1900 |
2200 |
2200 |
The ending calendar year that will be collected by the ReportHIVInfection.csv output report. Report_HIV_Infection must be set to 1. |
{
"Report_HIV_Infection_Stop_Year": 2100
}
|
|||||||||||||||
Report_HIV_Mortality |
boolean |
0 |
1 |
0 |
Enables or disables the HIVMortality.csv (disease and non-disease deaths) output report. |
{
"Report_HIV_Mortality": 0
}
|
|||||||||||||||
Report_HIV_Period |
float |
30 |
36500 |
730 |
The number of days between records in the HIV_By_Age_And_Gender output report. Output data will only be recorded during a time step, so if Report_HIV_Period is set to a value less than the value set for Simulation_Timestep, more than one period may occur before the next time step. When Report_HIV_Period is greater than the value set for Simulation_Timestep, a record may not be written during each time step. Note that the number of days between records is half the time specified by this parameter. For example, if Report_HIV_Period is set to 40, the actual time between records is 20 days. For best results, use integers for this value. |
{
"Report_HIV_Period": 365
}
|
|||||||||||||||
Report_Node_Event_Recorder |
boolean |
0 |
1 |
0 |
Enables or disables the ReportNodeEventRecorder.csv output report. When enabled (set to 1) reports will be generated for the broadcasted valid node events, as specified in Report_Node_Event_Recorder_Events. Note: This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Node_Events": [
"Node_Event_1",
"Node_Event_2"
],
"Report_Node_Event_Recorder": 1,
"Report_Node_Event_Recorder_Events": [
"Node_Event_1",
"Node_Event_2"
]
}
|
|||||||||||||||
Report_Node_Event_Recorder_Events |
array of strings |
NA |
NA |
NA |
The list of node events to include or exclude in the ReportNodeEventRecorder.csv output report, based on how Report_Node_Event_Recorder_Ignore_Events_In_List is set. Note: This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Node_Events": [
"Node_Event_1",
"Node_Event_2"
],
"Report_Node_Event_Recorder": 1,
"Report_Node_Event_Recorder_Events": [
"Node_Event_1",
"Node_Event_2"
],
"Report_Node_Event_Recorder_Ignore_Events_In_List": 0
}
|
|||||||||||||||
Report_Node_Event_Recorder_Ignore_Events_In_List |
boolean |
0 |
1 |
0 |
If set to false (0), only the node events listed in the Report_Node_Event_Recorder_Events array will be included in the ReportNodeEventRecorder.csv output report. If set to true (1), only the node events listed in the array will be excluded, and all other node events will be included. If you want to return all node events from the simulation, leave the node events array empty. Note: This configuration parameter is currently in beta release and has not yet been fully tested.
|
{
"Custom_Node_Events": [
"Node_Event_1",
"Node_Event_2"
],
"Report_Node_Event_Recorder": 1,
"Report_Node_Event_Recorder_Events": [
"Node_Event_1",
"Node_Event_2"
],
"Report_Node_Event_Recorder_Ignore_Events_In_List": 0
}
|
|||||||||||||||
Report_Node_Event_Recorder_Node_Properties |
array of strings |
NA |
NA |
[] |
Specifies an array of (optional) node property keys, as defined in NodeProperties in the demographics file, to be added as additional columns to the ReportNodeEventRecorder.csv output report. |
{
"Custom_Node_Events": [
"Node_Event_1",
"Node_Event_2"
],
"Report_Node_Event_Recorder": 1,
"Report_Node_Event_Recorder_Events": [
"Node_Event_1",
"Node_Event_2"
],
"Report_Node_Event_Recorder_Ignore_Events_In_List": 0,
"Report_Node_Event_Recorder_Node_Properties": [
"Geographic"
]
}
|
|||||||||||||||
Report_Node_Event_Recorder_Stats_By_IPs |
array of strings |
NA |
NA |
[] |
Specifies an array of (optional) individual property keys, as defined in IndividualProperties in the demographics file, to be added to the ReportNodeEventRecorder.csv output report. For each key:value pair there will be two additional columns (Key:Value:NumIndividuals, Key:Value:NumInfected) added to the report. For example, with a Risk property key assigned the values of LOW and HIGH there would then be four additional columns (Risk:LOW:NumIndividuals, Risk:LOW:NumInfected, Risk:HIGH:NumIndividuals, Risk:HIGH:NumInfected). An empty array equals no additional columns added. |
{
"Custom_Node_Events": [
"Node_Event_1",
"Node_Event_2"
],
"Report_Node_Event_Recorder": 1,
"Report_Node_Event_Recorder_Events": [
"Node_Event_1",
"Node_Event_2"
],
"Report_Node_Event_Recorder_Ignore_Events_In_List": 0,
"Report_Node_Event_Recorder_Node_Properties": [
"Geographic"
],
"Report_Node_Event_Recorder_Stats_By_IPs": [
"Risk"
]
}
|
|||||||||||||||
Report_Relationship_End |
boolean |
0 |
1 |
0 |
Enables or disables the RelationshipEnd.csv output report. For HIV simulations, there will be no additional columns. |
{
"Report_Relationship_End": 0
}
|
|||||||||||||||
Report_Relationship_Start |
boolean |
0 |
1 |
0 |
Enables or disables the RelationshipStart.csv output report. For HIV simulations, there will be some additional columns. |
{
"Report_Relationship_Start": 0
}
|
|||||||||||||||
Report_Relationship_Start_Individual_Properties |
array of strings |
NA |
NA |
[] |
Specifies an array of (optional) individual property keys, as defined in IndividualProperties in the demographics file, to be added to the RelationshipStart.csv output report. |
{
"Report_Relationship_Start_Individual_Properties": [
"CascadeState",
"Risk",
"HasSTI"
]
}
|
|||||||||||||||
Report_Surveillance_Event_Recorder |
boolean |
0 |
1 |
0 |
Enables or disables the ReportSurveillanceEventRecorder.csv output report. When enabled (set to 1) reports will be generated for the broadcasted valid coordinator events, as specified in Report_Surveillance_Event_Recorder_Events. Note: This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Coordinator_Events": [
"Start_ACF",
"Start_SIA_2",
"Start_SIA_4",
"Ind_Start_SIA_2",
"Ind_Start_SIA_4",
"Respond_To_Surveillance"
],
"Report_Surveillance_Event_Recorder": 1,
"Report_Surveillance_Event_Recorder_Events": [
"Respond_To_Surveillance"
]
}
|
|||||||||||||||
Report_Surveillance_Event_Recorder_Events |
array of strings |
NA |
NA |
NA |
The list of events to include or exclude in the ReportSurveillanceEventRecorder.csv output report, based on how Report_Surveillance_Event_Recorder_Ignore_Events_In_List is set. This list must not be empty and is dependent upon Report_Surveillance_Event_Recorder being enabled. Note: This configuration parameter is currently in beta release and has not yet been fully tested. |
{
"Custom_Coordinator_Events": [
"Start_ACF",
"Start_SIA_2",
"Start_SIA_4",
"Ind_Start_SIA_2",
"Ind_Start_SIA_4",
"Respond_To_Surveillance"
],
"Report_Surveillance_Event_Recorder": 1,
"Report_Surveillance_Event_Recorder_Events": [
"Respond_To_Surveillance"
]
}
|
|||||||||||||||
Report_Surveillance_Event_Recorder_Ignore_Events_In_List |
boolean |
0 |
1 |
0 |
If set to false (0), only the events listed in the Report_Surveillance_Event_Recorder_Events array will be included in the ReportSurveillanceEventRecorder.csv output report. If set to true (1), only the events listed in the array will be excluded, and all other events will be included. If you want to return all events from the simulation, leave the events array empty. Note: This configuration parameter is currently in beta release and has not yet been fully tested.
|
{
"Custom_Coordinator_Events": [
"Start_ACF",
"Start_SIA_2",
"Start_SIA_4",
"Ind_Start_SIA_2",
"Ind_Start_SIA_4",
"Respond_To_Surveillance"
],
"Report_Surveillance_Event_Recorder": 1,
"Report_Surveillance_Event_Recorder_Events": [
"Respond_To_Surveillance"
],
"Report_Surveillance_Event_Recorder_Ignore_Events_In_List": 0
}
|
|||||||||||||||
Report_Surveillance_Event_Recorder_Stats_By_IPs |
array of strings |
NA |
NA |
[] |
Specifies an array of (optional) individual property keys, as defined in IndividualProperties in the demographics file, to be added to the ReportSurveillanceEventRecorder.csv output report. For each key:value pair there will be two additional columns (Key:Value:NumIndividuals, Key:Value:NumInfected) added to the report. For example, with a Risk property key assigned the values of LOW and HIGH there would then be four additional columns (Risk:LOW:NumIndividuals, Risk:LOW:NumInfected, Risk:HIGH:NumIndividuals, Risk:HIGH:NumInfected). An empty array equals no additional columns added. |
{
"Custom_Coordinator_Events": [
"Start_ACF",
"Start_SIA_2",
"Start_SIA_4",
"Ind_Start_SIA_2",
"Ind_Start_SIA_4",
"Respond_To_Surveillance"
],
"Report_Surveillance_Event_Recorder": 1,
"Report_Surveillance_Event_Recorder_Events": [
"Respond_To_Surveillance"
],
"Report_Surveillance_Event_Recorder_Stats_By_IPs": []
}
|
|||||||||||||||
Report_Transmission |
boolean |
0 |
1 |
0 |
Enables or disables the TransmissionReport.csv output report. For HIV simulations, there will be some additional columns. |
{
"Report_Transmission": 0
}
|
|||||||||||||||
Report_Transmission_Individual_Properties |
array of strings |
NA |
NA |
[] |
Specifies an array of (optional) individual property keys, as defined in IndividualProperties in the demographics file, to be added to the TransmissionReport.csv output report. |
{
"Report_Transmission_Individual_Properties": [
"Accessibility",
"InterventionStatus"
]
}
|
|||||||||||||||
Spatial_Output_Channels |
array of strings |
NA |
NA |
[] |
An array of channel names for spatial output by node and time step. The data from each channel will be written to a separate binary file. Enable_Spatial_Output must be set to true (1). Possible values are:
|
{
"Spatial_Output_Channels": [
"Prevalence",
"New_Infections"
]
}
|