ReportHumanMigrationTracking
The human migration tracking report (ReportHumanMigrationTracking.csv) is a CSV-formatted report that provides details about human travel during simulations. The finished report will provide one line for each surviving individual that migrates during the simulation.
Configuration
There are no special parameters that need to be configured to generate the report. However, the simulation must have migration enabled (see the migration parameters in parameter-configuration).
Report structure and channel descriptions
The file contains the following data channels:
| Data channel | Data type | Description |
|---|---|---|
Time |
integer | The day that an individual leaves their current node. |
IndividualID |
integer | The ID of the migrating individual. |
AgeYears |
integer | The age (in years) of the migrating individual. |
Gender |
string | The gender of the individual. Possible values are M or F. |
IsAdult |
enum | Possible values are T or F; T (true) if individual's age is greater than the configuration parameter Minimum_Adult_Age_Years. |
Home_NodeID |
string | The external ID of the node the individual considers to be their 'home' node. |
From_NodeID |
string | The external ID of the node the individual is moving from. |
To_NodeID |
string | The external ID of the node the individual is moving to. |
MigrationType |
enum | The type of migration that is occurring. When the event is SimulationEnd, the values are either 'home' or 'away,' indicating if the individual was in their home node or not when the simulation ended. Otherwise, possible values are air, local, sea, regional, local, family, or intervention. |
Event |
enum | Possible values are Emigrating, NonDiseaseDeaths, DiseaseDeaths, or SimulationEnd. Emigrating means the individual is moving, SimulationEnd means the simulation has finished. |
Example
The following is an example of ReportHumanMigrationTracking.csv.
| Time | IndividualID | AgeYears | Gender | IsAdult | Home_NodeID | From_NodeID | To_NodeID | MigrationType | Event |
|---|---|---|---|---|---|---|---|---|---|
| 2 | 46 | 94.6986 | F | T | 1 | 1 | 4 | local | Emigrating |
| 4 | 108 | 35.7116 | M | T | 2 | 2 | 5 | local | Emigrating |
| 9 | 108 | 35.7253 | M | T | 2 | 5 | 2 | regional | Emigrating |
| 12 | 46 | 94.726 | F | T | 1 | 4 | 9 | regional | Emigrating |
| 13 | 46 | 94.7287 | F | T | 1 | 9 | 6 | local | Emigrating |
| 17 | 108 | 35.7472 | M | T | 2 | 2 | 5 | local | Emigrating |
| 22 | 46 | 94.7534 | F | T | 1 | 6 | 7 | regional | Emigrating |
| 23 | 108 | 35.7637 | M | T | 2 | 5 | 2 | regional | Emigrating |
| 25 | 108 | 35.7691 | M | T | 2 | 2 | 1 | local | Emigrating |
| 28 | 46 | 94.7698 | F | T | 1 | 7 | 4 | local | Emigrating |
| 35 | 46 | 94.789 | F | T | 1 | 4 | 7 | regional | Emigrating |
| 37 | 46 | 94.7945 | F | T | 1 | 7 | 4 | local | Emigrating |
| 44 | 46 | 94.8137 | F | T | 1 | 4 | 8 | regional | Emigrating |
| 100 | 1 | 38.9821 | M | T | 1 | 1 | 1 | home | SimulationEnd |
| 100 | 46 | 94.9643 | F | T | 1 | 8 | 8 | regional | SimulationEnd |
| 100 | 108 | 35.9719 | M | T | 2 | 1 | 1 | local | SimulationEnd |