Vector life cycle stats report (ReportVectorStats.csv)¶

The vector life cycle stats report is a CSV-formatted report that provides detailed life cycle data on the vectors included in the simulation. This report is stratified by time, node ID, and optionally by species. The file name is ReportVectorStats.csv, and it is produced via the libvectorstats.dll. See Custom reporters for information on using dynamic link library (DLL) files.

Configuration¶

The following parameters need to be configured to generate the report:

Parameter name	Data type	description
Species_List	Array of strings	The species to include information on. If the list is empty or absent, then data for all species will be collected.
Stratify_By_Species	boolean	If true (set to 1) data will break out each species for each node; if set to false (0), there will be a column for each species. The default is 0.
Include_Wolbachia_Columns	boolean	Add a column for each type of Wolbachia. Summation of columns should equal VectorPopulation. default = 0.
Include_Gestation_Columns	boolean	Adds columns for feeding and gestation, default = 0.

Report structure and data channel descriptions¶

The file contains the following data channels:

Data channel	Data type	Description
Time	integer	The day of the data for the current row.
NodeID	string	The external ID of the node where the vectors live.
Species	string	If Stratify_By_Species = 1, then the Species columns will contain the name of the species for the given row.
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 in STATE_INFECTIOUS.
STATE_INFECTED	integer	The number of adult female vectors that are in STATE_INFECTED.
STATE_ADULT	integer	The number of adult female vectors that are in STATE_ADULT.
STATE_MALE	integer	The number of adult male vectors.
STATE_IMMATURE	integer	The number of vectors in the immature state, includes males and females.
STATE_LARVA	integer	The number of larva, includes males and females.
STATE_EGG	integer	The number of eggs, includes males and females.
NumLookingToFeed	integer	If Include_Gestation_Columns = 1, this column will contain the number of adult female vectors that were looking to feed this time step.
NumFedCount	integer	If Include_Gestation_Columns = 1, this column will contain the number of adult female vectors that had a blood meal this time step.
NumGestatingBegin	integer	If Include_Gestation_Columns = 1, this column will contain 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, this column will contain the number of adult female vectors that were gestating at the end of the time step.
NumAttemptFeedIndoor	integer	If Include_Gestation_Columns = 1, this column will contain 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, this column will contain 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, this column will contain 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 that day.
IndoorBitesCount	integer	The attempted indoor human biting rate. Equal to NumAttemptFeedIndoor / number of humans.
OutdoorBitesCount	integer	The attempted outdoor human biting rate. Equal toNumAttemptFeedOutdoor / number of humans.
NewAdults	integer	The number of female vectors that matured to adulthood that day.
DiedBeforeFeeding	integer	The number of vectors that died on that time step due to local mortality, sugar feeding, outdoor area killing, or other factors.
DiedDuringFeedingIndoor	integer	The number of vectors that died indoors while attempting to feed (for example, due to bed nets).
DiedDuringFeedingOutdoor	integer	The number of vectors that died outdoors while attempting to feed.
NumGestatingOnDay_0	integer	If Include_Gestation_Columns = 1, this column will contain the number of vectors that are gestating but with 0 more days before attempting to feed.
NumGestatingOnDay_1	integer	If Include_Gestation_Columns = 1, this column will contain the number of vectors that are gestating but with 1 more days before attempting to feed.
NumGestatingOnDay_2	integer	If Include_Gestation_Columns = 1, this column will contain the number of vectors that are gestating but with 2 more days before attempting to feed.
NumGestatingOnDay_3	integer	If Include_Gestation_Columns = 1, this column will contain the number of vectors that are gestating but with 3 more days before attempting to feed.
NumGestatingOnDay_4	integer	If Include_Gestation_Columns = 1, this column will contain the number of vectors that are gestating but with 4 more days before attempting to feed.
NumGestatingOnDay_5	integer	If Include_Gestation_Columns = 1, this column will contain the number of vectors that are gestating but with 5 more days before attempting to feed.
NumGestatingOnDay_6	integer	If Include_Gestation_Columns = 1, this column will contain the number of vectors that are gestating but with 6 more days before attempting to feed.
NumGestatingOnDay_7	integer	If Include_Gestation_Columns = 1, this column will contain 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, this column will contain the number of adult female vectors that are Wolbachia free.
VECTOR_WOLBACHIA_A	integer	If Include_Wolbachia_Columns = 1, this column will contain the number of adult female vectors that have Wolbachia A.
VECTOR_WOLBACHIA_B	integer	If Include_Wolbachia_Columns = 1, this column will contain the number of adult female vectors that have Wolbachia B.
VECTOR_WOLBACHIA_AB	integer	If Include_Wolbachia_Columns = 1, this column will contain the number of adult female vectors that have Wolbachia AB.
MigrationFromCountLocal	integer	The number of adult female vectors that made a local migration trip away from this node.
MigrationFromCountRegional	integer	The number of adult female vectors that made a regional migration trip away from this node.
XXX_AvailableHabitat	integer	The number of larva that the habitat could add, equal to the current capacity - current larval count.
XXX_EggCrowdingCorrection	integer	The probability that eggs die due to over crowding.

Example¶

The following are examples of ReportVectorStats.csv files.

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

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
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
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
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
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
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
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