Vector statistics report (ReportVectorStats.csv)¶

The vector statistics report is a CSV-formatted report that provides detailed life-cycle data on the vectors in the simulation. The report may be stratified by time, node ID, and (optionally) species.

The output file is named ReportVectorStats.csv, and is produced via the libvectorstats.dll file. See Custom reporters for information on using using dynamic link library (DLL) files.

Configuration¶

To generate this report, the following parameters must be configured.

Parameter	Data type	Min	Max	Default	Description
Species_List	array of strings	NA	NA	(empty string)	The species for which to include information. If the list is empty or absent, then data for all species will be collected.
Stratify_By_Species	boolean	0	1	0	If set to true (1), then data will be stratified by species for each node.
Include_Wolbachia_Columns	boolean	0	1	0	If set to true (1), columns will be added for each type of Wolbachia. Summation of columns should be equal to VectorPopulation.
Include_Gestation_Columns	boolean	0	1	0	If set to true (1), columns will be added for feeding and gestation.

Output file data¶

The output report will contain the following information.

Stratification columns¶

Parameter	Data type	Description
Time	integer	The day of the simulation that the data was collected.
NodeID	integer	The External ID of the node that the data is being collected for.
Species	string	If Stratify_By_Species = 1, then the species column will contain the name of the species for the given row.

Data columns¶

Parameter	Data type	Description
Population	integer	The number of people in the node.
VectorPopulation	integer	The number of adult female vectors that are in the STATE_INFECTIOUS, STATE_INFECTED, and STATE_ADULT.
STATE_INFECTIOUS	integer	The number of adult female vectors that are infectious.
STATE_INFECTED	integer	The number of adult female vectors that are infected.
STATE_ADULT	integer	The number of adult female vectors.
STATE_MALE	integer	The number of adult male vectors.
STATE_IMMATURE	integer	The number of immature vectors, includes male and female.
STATE_LARVA	integer	The number of larva, includes male and female.
STATE_EGG	integer	The number of eggs, includes male and female.
NumLookingToFeed	integer	If Include_Gestation_Columns = 1, then this column contains the number of adult female vectors that were looking to feed during this time step.
NumFedCount	integer	If Include_Gestation_Columns = 1, then this column contains the number of adult female vectors that had a blood meal during this time step.
NumGestatingBegin	integer	If Include_Gestation_Columns = 1, then this column contains the number of adult female vectors that were gestating and did not die due to non-feeding mortality.
NumGestatingEnd	integer	If Include_Gestation_Columns = 1, then this column contains the number of adult female vectors that were gestating at the end of the time step.
NumAttemptFeedIndoor	integer	If Include_Gestation_Columns = 1, then this column contains the number of adult female vectors that attempt to feed indoors. This group of vectors can still die indoors before they feed on a human.
NumAttemptFeedOutdoor	integer	If Include_Gestation_Columns = 1, then this column contains the number of adult female vectors that attempt to feed outdoors. This group of vectors can still die outdoors before they feed on a human.
NumAttemptButNotFeed	integer	If Include_Gestation_Columns = 1, then this column contains the number of adult female vectors that were attempting to feed indoors or outdoors but did not die or feed on a human. They will look to feed during the next day.
NewEggsCount	integer	The number of eggs that were laid this day.
IndoorBitesCount	float	The attempted indoor human biting rate, equal to NumAttemptFeedIndoor / number of humans.
OutdoorBitesCount	float	The attempted outdoor human biting rate, equal to NumAttemptFeedOutdoor / number of humans.
NewAdults	integer	The number of female vectors that matured to adulthood this day.
DiedBeforeFeeding	integer	The number of vectors that died this time step due to local mortality, sugar feeding, outdoor area killing, etc.
DiedDuringFeedingIndoor	integer	This is the number of vectors that died indoors while attempting to feed (e.g. due to bed nets).
DiedDuringFeedingOutdoor	integer	This is the number of vectors that died outdoors while attempting to feed.
NumGestatingOnDay_0	integer	If Include_Gestation_Columns = 1, then this column contains the number of vectors that are gestating but with 0 more days before attempting to feed.
NumGestatingOnDay_1	integer	If Include_Gestation_Columns = 1, then this column contains the number of vectors that are gestating but with 1 more days before attempting to feed.
NumGestatingOnDay_2	integer	If Include_Gestation_Columns = 1, then this column contains the number of vectors that are gestating but with 2 more days before attempting to feed.
NumGestatingOnDay_3	integer	If Include_Gestation_Columns = 1, then this column contains the number of vectors that are gestating but with 3 more days before attempting to feed.
NumGestatingOnDay_4	integer	If Include_Gestation_Columns = 1, then this column contains the number of vectors that are gestating but with 4 more days before attempting to feed.
NumGestatingOnDay_5	integer	If Include_Gestation_Column = 1, then this column contains the number of vectors that are gestating but with 5 more days before attempting to feed.
NumGestatingOnDay_6	integer	If Include_Gestation_Columns = 1, then this column contains the number of vectors that are gestating but with 6 more days before attempting to feed.
NumGestatingOnDay_7	integer	If Include_Gestation_Columns = 1, then this column contains the number of vectors that are gestating but with 7 more days before attempting to feed.
VECTOR_WOLBACHIA_FREE	integer	If Include_Wolbachia_Columns = 1, then this column contains the number of adult female vectors that are Wolbachia free.
VECTOR_WOLBACHIA_A	integer	If Include_Wolbachia_Columns = 1, then this column contains the number of adult female vectors that have Wolbachia A.
VECTOR_WOLBACHIA_B	integer	If Include_Wolbachia_Columns = 1, then this column contains the number of adult female vectors that have Wolbachia B.
VECTOR_WOLBACHIA_AB	integer	If Include_Wolbachia_Columns = 1, then this column contains the number of adult female vectors that have Wolbachia AB.
MigrationFromCountLocal	integer	This is the number of adult female vectors that made a local migration trip away from this node.
MigrationFromCountRegiona	integer	This is the number of adult female vectors that made a regional migration trip away from this node.
XXX_AvailableHabitat	integer	If Stratify_By_Species = 1, then this column title does not have the species name in it. If Stratify_By_Species = 0, then there is a column for each species. This column contains the number of larva that the habitat could add (e.g. number of spots open); equal to current capacity - current larval count.
XXX_EggCrowdingCorrection	float	If Stratify_By_Species = 1, then this column title does not have the species name in it. If Stratify_By_Species = 0, then there is a column for each species. This column contains the probability that eggs die due to overcrowding.

Example¶

The following are examples of ReportVectorStats.csv files.

This example includes Wolbachia columns:

Time	NodeID	Species	Population	VectorPopulation	STATE_INFECTIOUS	STATE_INFECTED	STATE_ADULT	STATE_MALE	STATE_IMMATURE	STATE_LARVA	STATE_EGG	NewEggsCount	IndoorBitesCount	OutdoorBitesCount	NewAdults	DiedBeforeFeeding	DiedDuringFeedingIndoor	DiedDuringFeedingOutdoor	VECTOR_WOLBACHIA_FREE	VECTOR_WOLBACHIA_A	AvailableHabitat	EggCrowdingCorrection
1090	340461476	gambiae	1006	137761	0	0	137761	94934	66786	750588	7347200	3673600	36	0	16617	3187	3735	0	0	137761	133589	0.00369227
1090	340461476	funestus	1006	15087	1046	4154	9887	20019	21079	199318	646560	323280	4	0	2297	1409	504	0	15087	0	28207.7	0.0303043
1090	340461476	arabiensis	1006	66443	4091	17158	45194	85890	59681	675110	3041320	1520660	8	8	14939	5604	874	835	66443	0	120649	0.00733782
1091	340461476	gambiae	1006	130357	0	0	130357	88112	92801	776704	9562200	4781100	60	0	2079	3399	6084	0	0	130357	88014	0.0181823
1091	340461476	funestus	1006	15105	1085	4173	9847	20045	21686	201860	682600	341300	5	0	1970	1409	543	0	15105	0	25100	0.0436274
1091	340461476	arabiensis	1006	59130	3910	18471	36749	79380	83556	698246	2917760	1458880	13	13	1882	6274	1464	1457	59130	0	80000.2	0.03967
1092	340461476	gambiae	1005	132460	0	0	132460	88570	66236	790744	7076400	3538200	35	0	8914	3261	3550	0	0	132460	137920	0.00920437
1092	340461476	funestus	1005	15247	1115	4153	9979	20213	19276	203645	645520	322760	4	0	2074	1412	520	0	15247	0	27113	0.0367712
1092	340461476	arabiensis	1005	59697	3918	17626	38153	79699	59964	711281	2852680	1426340	8	8	7824	5569	851	837	59697	0	124516	0.0274184

This table includes gestation columns:

Time	NodeID	Population	VectorPopulation	STATE_INFECTIOUS	STATE_INFECTED	STATE_ADULT	STATE_MALE	STATE_IMMATURE	STATE_LARVA	STATE_EGG	NumLookingToFeed	NumFedCount	NumGestatingBegin	NumGestatingEnd	NumAttemptFeedIndoor	NumAttemptFeedOutdoor	NumAttemptButNotFeed	NewEggsCount	IndoorBitesCount	OutdoorBitesCount	NewAdults	DiedBeforeFeeding	DiedDuringFeedingIndoor	DiedDuringFeedingOutdoor	NumGestatingOnDay_0	NumGestatingOnDay_1	NumGestatingOnDay_2	NumGestatingOnDay_3	NumGestatingOnDay_4	NumGestatingOnDay_5	NumGestatingOnDay_6	NumGestatingOnDay_7	MigrationFromCountLocal	MigrationFromCountRegional	arabiensis_AvailableHabitat	arabiensis_EggCrowdingCorrection
350	1	1000	88760	2171	16352	70237	100715	124862	1699008	1647000	29944	16393	48447	64840	8098	8154	11915	823500	8	8	12005	10422	820	816	9823	11150	12887	14587	16393	0	0	0	0	0	0	0
351	1	1000	88451	2127	16377	69947	100900	124843	1699680	1641840	29839	16278	48381	64659	8059	8021	11911	820920	8	8	11881	10540	848	802	9772	11285	12856	14468	16278	0	0	0	0	0	0	0
352	1	1000	88312	2110	16283	69919	100936	125391	1697598	1619120	29630	16020	48388	64408	7970	7859	12004	809560	7	7	11900	10433	803	803	9901	11347	12790	14350	16020	0	0	0	0	0	0	0
353	1	1000	88477	2117	16291	70069	101167	125234	1698069	1655960	29957	16285	48062	64347	8014	8127	12029	827980	8	8	12101	10293	807	836	9964	11265	12681	14152	16285	0	0	0	0	0	0	0
354	1	1000	88617	2154	16232	70231	101057	125605	1697983	1669440	30280	16509	47938	64447	8045	8214	12183	834720	8	8	11987	10259	790	798	9889	11158	12502	14389	16509	0	0	0	0	0	0	0
355	1	1000	88480	2154	16217	70109	101222	125573	1698350	1649840	30097	16393	47995	64388	8120	8083	12069	824920	8	8	12023	10525	813	822	9715	11030	12662	14588	16393	0	0	0	0	0	0	0