Vector genetics report (ReportVectorGenetics.csv)

The vector genetics report is a CSV-formatted report that collects information on how many vectors of each genome/allele combination exist at each time, node, and vector state. Information can only be collected on one species per report.

The output file is named ReportVectorGenetics.csv, and is produced via the libvectorgenetics.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	string	NA	NA	(if not specified, the first species found will be used)	The species to include information on; the name must exist in Vector_Species_Names in the config.json file. The name will be added to the report name.
Gender	enum	NA	NA	VECTOR_FEMALE	The gender to include in the file; possible values are VECTOR_FEMALE, VECTOR_MALE, and VECTOR_BOTH_GENDERS.
Include_Vector_State_Columns	boolean	0	1	1	If set to true (1), the columns for each vector state (Eggs, Larvae, etc) will be included.
Stratify_By	enum	NA	NA	GENOME	Determines how the report will be stratified; possible values are GENOME, SPECIFIC_GENOME, and ALLELE.
Combine_Similar_Genomes	boolean	0	1	0	If set to true (1), genomes are combined for each locus (ignoring gender) if the set of alleles of the two genomes are the same. Note that ‘1-0’ is considered to be the same as ‘0-1’. Depends on Stratify_By = GENOME or SPECIFIC_GENOME.
Specific_Genome_Combinations_For_Stratification	array of strings	NA	NA	NA	If stratifying by SPECIFIC_GENOME, this is the list of genomes to stratify by. ‘*’ will list all entries at that location, and ‘?’ will combine all entries at that location. Depends on Stratify_By = SPECIFIC_GENOME.
Allele_Combinations_For_Stratification	array of strings	NA	NA	NA	If stratifying by allele, this will be the list of alleles to stratify by. Depends on Stratify_By = ALLELE.

The following is an example of an input file for this report:

{
    "ReportVectorGenetics": {
        "Enabled": 1,
        "Reports": [{
                "Species": "arabiensis"
            },
            {
                "Species": "arabiensis",
                "Include_Vector_State_Columns": 0,
                "Stratify_By": "GENOME",
                "Gender": "VECTOR_FEMALE",
                "Combine_Similar_Genomes": 1
            },
            {
                "Species": "arabiensis",
                "Include_Vector_State_Columns": 0,
                "Stratify_By": "SPECIFIC_GENOMES",
                "Gender": "VECTOR_BOTH_GENDERS",
                "Specific_Genome_Combinations_For_Stratification": [{
                        "Allele_Combination": [
                            ["X", "*"],
                            ["Aw", "Aw"],
                            ["Bw", "Bw"]
                        ]
                    },
                    {
                        "Allele_Combination": [
                            ["X", "*"],
                            ["Ad", "Ad"],
                            ["Be", "Be"]
                        ]
                    },
                    {
                        "Allele_Combination": [
                            ["X", "*"],
                            ["Ar", "*"],
                            ["Bw", "Bw"]
                        ]
                    },
                    {
                        "Allele_Combination": [
                            ["X", "*"],
                            ["Aw", "Aw"],
                            ["Br", "*"]
                        ]
                    },
                    {
                        "Species": "arabiensis",
                        "Include_Vector_State_Columns": 0,
                        "Stratify_By": "ALLELE",
                        "Gender": "VECTOR_MALE",
                        "Allele_Combinations_For_Stratification": [
                            ["Y", "Ad", "Bd"]
                        ]
                    }
                ]

            }
        ]
    }
}

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.
Alleles	string	If Stratify_By = ALLELE, then the column will be all of the possible alleles plus the values in Allele_Combinations_For_Stratification.
Genome	string	If Stratify_By = GENOME or SPECIFC_GENOME, then this is the ‘Genome’ column and for each time and NodeID, the column will contain the possible combinations of genomes.

Data columns

Parameter	Data type	Description
VectorPopulation	integer	If Gender = VECTOR_BOTH_GENDERS or VECTOR_FEMALE, then this column will contain the number of female vectors that are in the states STATE_INFECTIOUS, STATE_INFECTED, and STATE_ADULT.
STATE_INFECTIOUS	integer	If Gender is VECTOR_BOTH_GENDERS or VECTOR_FEMALE, then this column will contain the number of female vectors that are in this state.
STATE_INFECTED	integer	If Gender is VECTOR_BOTH_GENDERS or VECTOR_FEMALE, then this column will contain the number of female vectors that are in this state.
STATE_ADULT	integer	If Gender is VECTOR_BOTH_GENDERS or VECTOR_FEMALE, then this column will contain the number of female vectors that are in this state.
STATE_MALE	integer	If Gender is VECTOR_BOTH_GENDERS or VECTOR_MALE, then this column will contain the number of mature male vectors.
STATE_IMMATURE	integer	This column contains the number of vectors in the ‘immature’ state.
STATE_LARVA	integer	This column contains the number of larva.
STATE_EGG	integer	This column contains the number of eggs.

Example

The following are examples of ReportVectorGenetics.csv files.

This table is stratified by genome and female vectors.

Time	NodeID	Genome	VectorPopulation	STATE_INFECTIOUS	STATE_INFECTED	STATE_ADULT	STATE_IMMATURE	STATE_LARVA	STATE_EGG
0	1	X-a0-b0:X-a0-b0	293	0	0	293	0	0	8903
0	1	X-a0-b0:X-a1-b0	181	0	0	181	0	0	5797
0	1	X-a0-b0:X-a0-b1	657	0	0	657	0	0	21948
0	1	X-a0-b0:X-a1-b1	454	0	0	454	0	0	14096
0	1	X-a1-b0:X-a0-b0	194	0	0	194	0	0	6360
0	1	X-a1-b0:X-a1-b0	124	0	0	124	0	0	3934
0	1	X-a1-b0:X-a0-b1	437	0	0	437	0	0	14967
0	1	X-a1-b0:X-a1-b1	285	0	0	285	0	0	9140
0	1	X-a0-b1:X-a0-b0	638	0	0	638	0	0	22200
0	1	X-a0-b1:X-a1-b0	439	0	0	439	0	0	15429
0	1	X-a0-b1:X-a0-b1	1515	0	0	1515	0	0	50901
0	1	X-a0-b1:X-a1-b1	1039	0	0	1039	0	0	33525
0	1	X-a1-b1:X-a0-b0	435	0	0	435	0	0	15209
0	1	X-a1-b1:X-a1-b0	293	0	0	293	0	0	9808
0	1	X-a1-b1:X-a0-b1	1032	0	0	1032	0	0	34564
0	1	X-a1-b1:X-a1-b1	695	0	0	695	0	0	23311
1	1	X-a0-b0:X-a0-b0	261	0	0	261	0	5877	9167
1	1	X-a0-b0:X-a1-b0	157	0	0	157	0	3830	6470
1	1	X-a0-b0:X-a0-b1	564	0	0	564	0	14393	21121
1	1	X-a0-b0:X-a1-b1	397	0	0	397	0	9134	13920
1	1	X-a1-b0:X-a0-b0	167	0	0	167	0	4143	5533
1	1	X-a1-b0:X-a1-b0	104	0	0	104	0	2536	3779
1	1	X-a1-b0:X-a0-b1	377	0	0	377	0	9836	13234
1	1	X-a1-b0:X-a1-b1	243	0	0	243	0	6002	9229
1	1	X-a0-b1:X-a0-b0	564	0	0	564	0	14428	19047
1	1	X-a0-b1:X-a1-b0	381	0	0	381	0	10047	13371
1	1	X-a0-b1:X-a0-b1	1322	0	0	1322	0	33210	47190
1	1	X-a0-b1:X-a1-b1	898	0	0	898	0	21974	31616
1	1	X-a1-b1:X-a0-b0	381	0	0	381	0	9938	12977
1	1	X-a1-b1:X-a1-b0	257	0	0	257	0	6393	9156
1	1	X-a1-b1:X-a0-b1	886	0	0	886	0	22766	30973
1	1	X-a1-b1:X-a1-b1	604	0	0	604	0	15236	20404

This table is stratified by genome and male vectors.

Time	NodeID	Genome	STATE_MALE	STATE_IMMATURE	STATE_LARVA	STATE_EGG
728	1	X-a0-b0:Y-a1-b0	471	234	2889	76019
728	1	X-a0-b0:Y-a0-b1	472	238	2876	77305
728	1	X-a0-b0:Y-a1-b1	6139	3607	44504	1200234
728	1	X-a1-b0:Y-a1-b1	20783	12670	166170	4672298
728	1	X-a0-b1:Y-a1-b1	20879	12732	166591	4748180
728	1	Other	73196	46195	639267	18714288
729	1	X-a0-b0:Y-a1-b0	460	224	2818	76957
729	1	X-a0-b0:Y-a0-b1	461	238	2798	79896
729	1	X-a0-b0:Y-a1-b1	6076	3578	44258	1205125
729	1	X-a1-b0:Y-a1-b1	20824	12630	165392	4658639
729	1	X-a0-b1:Y-a1-b1	20801	12677	166219	4709209
729	1	Other	73268	46247	640706	18831238

This table is stratified by allele and female vectors, with vector state columns included.

Time	NodeID	Alleles	VectorPopulation
604	1	Ad	36238
604	1	Am	60886
604	1	Aw	63143
604	1	Bd	9419
604	1	Bm	13313
604	1	Bw	96119
604	1	Ce	15029
604	1	Cw	96861
604	1	De	12088
604	1	Dw	97095
604	1	X	97469
604	1	Y	0
605	1	Ad	36232
605	1	Am	60897
605	1	Aw	62762
605	1	Bd	9503
605	1	Bm	13334
605	1	Bw	95893
605	1	Ce	14964
605	1	Cw	96645
605	1	De	12253
605	1	Dw	96877
605	1	X	97250
605	1	Y	0