Tutorials

These tutorials will guide you all the way from a quick first run of the program to setting all the advanced options for more custom behaviour, building your skills step by step. They explore the command-line interface - an easy option for anyone, including those not as familiar with programming. Other ways of running the program are discussed in the User Guide.

All exercise files can be found in the docs/exercises directory on GitHub.

Optional Python scripts for visualisation can be found in the test directory.

Note

These tutorials have been written using a Windows 10 system with a g++ 13.1.0 compiler. The visualised data may vary slightly when using other systems or compilers due to differences in pseudo-random number generation.

• 1. Running a pre-defined set
  • 1.1 First run
  • 1.2 Simple plots: coordinates and totals (optional - python)
• 2. Running a custom set
  • 2.1 Run with custom parameters
  • 2.2 Creating a local data animation: population size (optional - python)
• 3. Setting coordinates and release sites
  • 3.1 Model introduction: Patch
  • 3.2 Model introduction: Gene drive
  • 3.3 Setting your own Patch coordinates
  • 3.4 Creating a local data animation: drive allele frequency (optional - python)
• 4. Setting the boundary type
  • 4.1 Setting the boundary type to Edge
• 5. Customising the gene drive release schedule
  • 5.1 Setting multiple release times
• 6. Setting the dispersal type
  • 6.1 Model Introduction: Dispersal
  • 6.2 Setting the dispersal type to Radial
• 7. Customising seasonality
  • 7.1 Model Introduction: Seasonality
  • 7.2 Running with default rainfall
  • 7.3 Setting a rainfall file