Directory `Data_all_players` contains the data that was given to the participants at the beginning of the Challenge (day 50 after detection of the first case) and during the subsequent periods (days 80 and 110).
-`initial_data` was provided at day 50 and contained:
- a map of the fictitious island (administrative divisions and landcover, shapefiles: `Island_ADMIN` and `Island_LANDCOVER`)
- a list of all officially registered pig farms (`herds.csv`) with their characteristics (this list was built by removing from the original input file in `model/data` 10% of small herds, and re-numbering the farms)
- the wild boar hunting bags by administrative division of the island (`WB_HundintBag.csv`)
- the list of trade movements between farms from 59 days before the detection of the first case up to day 50 (`moves.csv`)
- a description of data structure (`DataDoc_Player.pdf`)
-`DAY_50`, `DAY_80`, `DAY_110` all have the same structure and contain reports at the specified date (after the detection of the first case):
-`DAY<N>.pdf`, the situation report and proposed control measures or specific questions to the participants
-`herds_day_<N>.csv`, an updated list of pig farms (possibly with unregistered pig farms discovered since last situation report)
-`moves_Players_day_<N>.csv`, an updated list of trade movements
-`TimeSeries_day_<N>.csv`, the updated time series representing epidemiological events (detections, cullings, etc.) and their nature (pig farm vs. wild boar, detection method, etc.). From day 80, this time series was also provided with subsets (in the fenced area, in the buffer around the fences, and outside).
-`TimeSeries_hunt_negative_test_day_<N>.csv`, a specific file for wild boar that tested negative after being shot by hunters (large file)
- additional figures (cumulative incidence, maps) to illustrate the evolution of the situation, possibly with small errors.
Running model M0
...
...
@@ -49,7 +62,7 @@ Running model M0
1. Install EMULSION
The installation procedure for EMULSION is fully described on [the software website](https://sourcesup.renater.fr/www/emulsion-public/Install.html). All simulations were carried out under Linux. Install version 1.1rc5 which was used to produce the synthetic data used for the ASF Challenge and discussed in our papers. Ensure that your `PYTHONPATH` variable is set properly (i.e. containing current repository `.`).
The installation procedure for EMULSION is fully described on [the software website](https://sourcesup.renater.fr/www/emulsion-public/Install.html). All simulations were carried out under Linux with Python 3.8 and `numpy` 1.18. **Install EMULSION version 1.1rc5** which was used to produce the synthetic data used for the ASF Challenge and discussed in the article. Ensure that your `PYTHONPATH` variable is set properly (i.e. containing current repository `.`) as explained in the installation instructions.
2. Clone the git repository and move into the `model/` directory:
...
...
@@ -71,5 +84,19 @@ Running model M0
4. Run simulations
The parameter values defined by default in the model file (`ppa.yaml`) already correspond to the initial conditions and to the control measures implemented in the trajectory selected for the Challenge.
Hence, to reproduce this trajectory, use the following command (1 stochatic repetition with the specified random seed):
:warning: COMING SOON...
```bash
# assuming that you are currently located in directory 'model':
emulsion run ppa.yaml -r 1 --seed 23289
```
This will produce 3 files in directory `outputs/`:
- `log.txt` which contains each change occurring in epidemiological units and was used to produce the time series given to the Challenge participants
- `herd_status.txt` which tracks pig farms in protection/surveillance areas or traced as suspicious trade contacts
- `wildboars.txt` which contains statistics on wild boar per 15x15 km$`^2`$ tile
These files should be the same as those are already provided in directory `outputs/challenge`.
