Reports and other output

After the simulation finishes, a reporter extracts simulation data, aggregates it, and outputs it to a file (known as an output report). You can use any of the reporters below to get different information about your simulation, from memory usage to infection counts to parasite genetics.

General reports

Report	Description
InsetChart	Automatically generated; simulation-wide averages of key channels at each time step.
DemographicsSummary	Demographic channel data aggregated across the simulation; enabled together with BinnedReport.
BinnedReport	Channel data stratified by age bins instead of simulation-wide averages; enabled together with DemographicsSummary.
PropertyReport	Counts of individuals broken down by individual property key-value combinations.
ReportEventCounter	Counts how many times each event occurs per time step.
ReportEventRecorder	Records individual demographics and health at the time of each event.
ReportHumanMigrationTracking	Tracks human travel and migration events during simulations.
ReportInterventionPopAvg	Reports intervention usage and efficacy by population fraction.
ReportNodeDemographics	Node-level demographic snapshot at each time step.
ReportSimulationStats	Tracks performance, memory usage, and simulation object counts at each time step.
SpatialReport	Channel data broken down per geographic node in binary files.

Vector reports

Report	Description
ReportMicrosporidia	Tracks vector population counts by species and microsporidia strain across all life stages.
ReportVectorGenetics	Reports vector genome and allele combinations by state.
ReportVectorMigration	Provides detailed information on vector migration locations.
ReportVectorStats	Detailed vector life-cycle data stratified by time, node, and species.
VectorHabitatReport	Reports habitat data for vector species developmental stages.
VectorSpeciesReport	Sorts vector data into bins by species with adult vector counts.

Malaria — Population and epidemiology

Report	Description
MalariaSummaryReport	Population-level malaria summary grouped by age and parasitemia bins.
ReportMalariaFiltered	Filtered InsetChart with options for data selection by time, node, or individual property.
ReportNodeDemographicsMalaria	Extends node demographics with malaria parasite counts.
SpatialReportMalariaFiltered	Spatial malaria information with filtering and custom reporting intervals.
SqlReport	Outputs individual-level epidemiological data to a SQLite relational database.
SqlReportMalaria	Outputs malaria epidemiological data to a SQLite relational database.

Malaria — Intra-host

Report	Description
MalariaImmunityReport	Reports antibody statistics for MSP and PfEMP1 by age bins.
MalariaPatientJSONReport	Reports medical data for each individual on each day.
MalariaSurveyJSONAnalyzer	Reports individual details for each event during the reporting interval.
ReportAntibodies	Tracks antibody concentration or capacity data per individual per day.
ReportDrugStatus	Reports drug status for individuals who have taken or are awaiting treatment.
ReportInfectionDuration	Records the duration of each cleared infection along with individual demographics.
ReportInfectionStatsMalaria	Reports per-infection parasite burden (hepatocytes, IRBCs, gametocytes) at each reporting interval.
ReportMalariaFilteredIntraHost	Reports within-host disease dynamics with a focused set of intra-host channels.

Malaria — Parasite genetics (FPG)

Report	Description
ReportFpgNewInfections	Tracks detailed new human infections with parasite genetics data.
ReportFpgOutputForObservationalModel	Extracts genetic and epidemiological data on the filtered infected population for use with the FPGObservationalModel post-processing tool.
ReportNodeDemographicsMalariaGenetics	Adds specific genetic barcode infection counts to node demographics.
ReportSimpleMalariaTransmission	Tracks who transmitted malaria to whom; requires MALARIA_MECHANISTIC_MODEL_WITH_CO_TRANSMISSION.
ReportVectorStatsMalariaGenetics	Reports vector life-cycle data with genetic barcode information.
SqlReportMalariaGenetics	Outputs malaria epidemiological and genetics data to a SQLite relational database.

Other

File	Description
Error and logging files	Error output and logging information generated during a simulation run.
stdout.txt	Contains the logging output written by EMOD to standard output during a simulation run.
stderr.txt	Contains error messages written by EMOD or Python to standard error during a simulation run.
Troubleshooting	Help resolving common simulation errors.