This section describes Pykaryote’s built in command line tools.
Simulations are controlled by settings in a configuration file. The default settings are in pykaryote/configs/master.cfg. Do not edit this file. The default configuration file used by Pykaryote’s command line tools is pykaryote/configs/sim.cfg. You are free to make a copy of this file and edit it.
For more information on configuration files and detailed descriptions of each setting, see Simulation Configuration Files.
The most basic usage of pykaryote is to run a single simulation. When a simulation is run, data is collected and saved. That data can then be analyzed and graphed.
Due to the random nature of the model, the results of a simulation vary from run to run, even when the same configuration options are used. For this reason, it is a good idea to run a simulation multiple times and then look at the average of those runs. Pykaryote includes tools to do so.
Research with Pykaryote involves exploring the results of different configuration options. With this in mind, Pykaryote has the ability to run different versions of a simulation where a setting is varied each run. This is called a comparison.
For instance, a comparison could be run with the default configuration file, but using values of 0.0001, 0.001, 0.01, and 0.1 for strong_chance. Of course, comparisons can be averaged over multiple runs just like simulations.
Comparisons are configured using a separate configuration file. The default configuration file is located in pykaryote/configs/cmp.cfg. For a description of the comparison configuration file format, see Comparison Configuration Files.
Pykaryote comes with several command line tools.
Pykaryote also ships with a number of deprecated scripts. They have been replaced by petri but are included for backwards compatibility.