ReportVectorStats#

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

Configuration#

To generate this report, the following parameters must be configured in the custom_reports.json file:

Parameter

Data type

Min

Max

Default

Description

Species_List

array of strings

NA

NA

[ ]

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

NA

NA

0

If set to true (1), then data will be stratified by species for each node.

Include_Wolbachia_Columns

boolean

NA

NA

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

NA

NA

0

If set to true (1), columns will be added for feeding and gestation.

Include_Death_By_State_Columns

boolean

NA

NA

0

Adds columns for the number of vectors that died in this state during this time step as well as the average age at death. It adds two columns for each of the following states: ADULT, INFECTED, INFECTIOUS, and MALE.

{
    "Reports": [
        {
            "Species_List": [
                "arabiensis",
                "funestus"
            ],
            "Stratify_By_Species": 1,
            "Include_Wolbachia_Columns": 0,
            "Include_Gestation_Columns": 1,
            "class": "ReportVectorStats"
        }
    ],
    "Use_Defaults": 1
}

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 number of bites made on humans indoors. This includes vectors that live for another day as well as those that die trying to get away.

IndoorBitesCountInfectious

float

The number of bites made by infectious vectors on humans indoors. This includes vectors that live for another day as well as those that die trying to get away.

OutdoorBitesCount

float

The number of bites made on humans outdoors. This includes vectors that live for another day as well as those that die trying to get away.

OutdoorBitesCountInfectious

float

The number of bites made by infectious vectors on humans outdoors. This includes vectors that live for another day as well as those that die trying to get away.

UnmatedAdults

float

The number of adult females that have not mated. This can be an important statistic when the male vector population is suppressed. When the male population is low, females moving from immature to adult might not find a male to mate with for several days. The female continues to feed but she does not produce fertile eggs.

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

NumDiedInfectious

integer

If Include_Death_By_State_Columns = 1, then this column contains the number of infectious, mature, female vectors that died during this time step.

NumDiedInfected

integer

If Include_Death_By_State_Columns = 1, then this column contains the number of infected, mature, female vectors that died during this time step.

NumDiedAdults

integer

If Include_Death_By_State_Columns = 1, then this column contains the number of mature female vectors that are neither infected or infectious that died during this time step.

NumDiedMale

integer

If Include_Death_By_State_Columns = 1, then this column contains the number of mature male vectors that died during this time step.

AvgAgeAtDeathInfectious

float

If Include_Death_By_State_Columns = 1, then this column contains the average age (in days) of the the infectious, mature, female vectors that died during this time step.

AvgAgeAtDeathInfected

float

If Include_Death_By_State_Columns = 1, then this column contains the average age (in days) of the the infected, mature, female vectors that died during this time step.

AvgAgeAtDeathAdults

float

If Include_Death_By_State_Columns = 1, then this column contains the average age (in days) of the the mature, female vectors that are neither infected or infectious that died during this time step.

AvgAgeAtDeathMale

float

If Include_Death_By_State_Columns = 1, then this column contains the average age (in days) of the the mature male vectors that died during this time step.

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_Columns = 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 = 0, then this column title does not have the species name in it. If Stratify_By_Species = 1, 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 = 0, then this column title does not have the species name in it. If Stratify_By_Species = 1, 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. The examples do not include the Death By State columns.

This example includes Wolbachia columns:

STATE_ADULT

STATE_MALE

STATE_IMMATURE

STATE_LARVA

STATE_EGG

NewEggsCount

IndoorBitesCount

IndoorBitesCount-Infectious

OutdoorBitesCount

OutdoorBitesCount-Infectious

NewAdults

UnmatedAdults

DiedBeforeFeeding

DiedDuringFeedingIndoor

DiedDuringFeedingOutdoor

VECTOR_WOLBACHIA_FREE

VECTOR_WOLBACHIA_A

VECTOR_WOLBACHIA_B

VECTOR_WOLBACHIA_AB

MigrationFromCountLocal

MigrationFromCountRegional

arabiensis_AvailableHabitat

funestus_AvailableHabitat

gambiae_AvailableHabitat

arabiensis_EggCrowdingCorrection

funestus_EggCrowdingCorrection

gambiae_EggCrowdingCorrection

NumInfectousBitesGiven

NumInfectousBitesReceived

InfectiousBitesGivenMinusReceived

16220

36576

17593

147016

1541720

770860

8537

202

2426

75

1469

0

2788

844

245

0

137427

0

0

0

0

8991.45

4123.95

10026.9 0.00706801

0.0259187

0.00710855

277

136

141

0

14635

34183

17098

152982

958640

479320

4756

479

1366

128

1047

0

2501

517

121

15087

0

0

0

0

0

3873.64

3814.74

4504.05

0.0133491

0.0316351

0.0135903

607

295

312

13247

32339

12849

150692

1264080

632040

5812

296

1559

92

1339

0

2287

643

159

66443

0

0

0

0

0

3662.45

2833.68

4034.73

0.00908111

0.0593457

0.00962815

388

219

169

12066

30731

14408

140976

1452320

726160

6700

270

1803

76

1564

0

2100

637

171

0

130007

0

0

0

0

8211.71

3889.12

9207.12

0.00671468

0.0242195

0.00670622

346

178

168

12590

30509

10898

145816

794440

397220

4239

455

1166

129

2672

0

1969

466

134

15105

0

0

0

0

0

2797.77

3512.56

3192.74

0.0129099

0.0288083

0.0135152

584

274

310

11243

28771

10887

138512

954720

477360

5676

312

1556

128

1134

0

1928

610

153

59130

0

0

0

0

6894.61

3493.81

7625.89

0.00798359

0.049113

0.00857158

440

227

213

0

8933

26075

14491

138662

1112920

556460

5247

329

1429

92

0

0

1884

604

131

0

136952

0

0

0

0

14562.2

4190.82

16253.6

0.0172538

0.0315782

0.0171569

421

240

181

9541

25515

9959

159705

705280

352640

2854

347

746

106

1965

0

1575

286

84

12354

0

0

0

0

0

1660.21

3321.22

2031.23

0.0308546

0.035052

0.031173

453

221

232

8604

24184

14841

143138

946320

473160

5224

418

1312

111

1070

0

1549

552

130

4545

0

0

0

0

0

5737.64

3498.29

6278.16

0.00562629

0.0425362

0.00611594

529

250

279

7951

22936

16030

140226

860880

430440

4290

310

1058

86

1048

0

1454

435

117

0

137234

0

0

0

0

3113.21

3527.66

3467.57

0.014121

0.0311236

0.0146823

396

208

188

8216

22242

15596

132199

463280

231640

2584

344

685

109

1552

0

1391

299

68

15421

0

0

0

0

0

1562.56

3622.39

1707.29

0.00863056

0.0325911

0.00884764

453

214

239

6553

20374

17428

122419

854320

427160

4512

421

1178

111

248

0

1482

490

140

63235

0

0

0

0

0

3282.25

3217.14

3811.39

0.00827453

0.0702558

0.00766011

532

263

269

8015

21173

12487

118951

683640

341820

3003

376

741

94

2646

0

1204

346

76

0

136025

0

0

0

0

2047.61

3347.56

2169.57

0.00896889

0.0306045

0.00994518

470

233

237

7913

20868

8126

115273

420600

210300

3489

299

927

70

1585

0

1298

357

82

14010

0

0

0

0

0

1894.64

2482.64

2145.04

0.00736232

0.0335831

0.0070938

369

172

197

7560

20286

8209

107152

734040

367020

4018

384

1079

109

1393

0

1290

449

102

59413

0

0

0

0

0

2474.93

3355.48

2673.81

0.0110462

0.046009

0.0109935

493

241

252

7525

19644

6876

103579

476880

238440

2978

375

665

90

1292

0

1279

323

61

0

125487

0

0

0

0

1868.86

3167.59

2158.96

0.00808167

0.0314773

0.00832445

465

218

247

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

IndoorBitesCount-Infectious

OutdoorBitesCount

OutdoorBitesCount-Infectious

Unmated Adults

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

1

8

0

0

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

0

8

1

0

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

2

7

2

0

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

1

8

0

0

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

0

8

0

0

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

0

8

1

0

12023

10525

813

822

9715

11030

12662

14588

16393

0

0

0

0

0

0

0