Documentation¶

The metawards program and associated Python module is composed of six main units;

  • The metawards command line program, which is what most people would use to run metawards. This program comes with full help that is provided by typing metawards --help.

  • The metawards top-level Python module, which is what you should use if you want to write new Python programs that integrate metawards functionality. These could include plugging metawards as a model into a higher-level statictical analysis package.

  • The metawards.iterators module, which contains all of the package-supplied iterators that are used to advance the model infection from day to day. These are used to customise exactly how an infection progresses, and how control measures are applied. This is described in the tutorial.

  • The metawards.extractors module, which contains all of the package-supplied extractors that are used to extract and output data gathered live during a model run and write them to files. These are used to customise exactly what information is gathered, how it is processed, and where it is written as the infection progresses. You can see how to use these to customise output in the tutorial.

  • The metawards.mixers module, which contains all of the package-supplied mixers that are used to merge and mix values calculated across multiple demographic sub-networks. These are used to customise exactly how different demographics interact and how the disease should move between demographics. You can see how to use mixers in the tutorial.

  • The metawards.movers module, which contains all of package-supplied movers that are used to move individuals between different demographics during an outbreak (e.g. move between home and hospital, work and holiday etc.). You can see how to use movers in the tutorial.

  • The metawards.analysis contains analysis functions that can be used to process the results of a metawards run to generate insights and useful graphics.

  • The metawards.utils utility Python module which contains lots of functions that are used by metawards to build and perform model runs. These functions are internal to metawards and are not designed to be used outside of this program.

  • The metawards.themes module contains the themes that are used to style the console output and spinners used by MetaWards. Choose the theme using the --theme option, e.g. --theme default or --theme simple.