Skip to content

Latest commit

 

History

History
78 lines (48 loc) · 2.43 KB

README.md

File metadata and controls

78 lines (48 loc) · 2.43 KB
Raw

Poietic Examples

Example models for the Poietic Flows toolkit.

To play with the examples, you need the Poietic Tool installed.

Contents

  • Thinking In Systems – flows and stocks models from the book Thinking in Systems: A Primer by Donella Meadows

Running the demos

Make sure you have the poietic command-line tool from the Poietic Tool package installed. Follow the installation instructions contained in the package.

There are two ways to run and explore the demos: use the included convenience run script or do it manually. Here are the methods described in more detail.

Convenience Script

To run the demos you can use the included convenience run script in the same directory as this README file.

For example:

./run ThinkingInSystems/Capital.poieticframe

The command will create output in the ./out directory with a CSV file containing the simulation result. If you have the optional tools installed (see below), more content, including charts and diagrams, is generated.

Recommended

Install the following tools to have additional visual content generated.

  • Gnuplot – generate charts as PNG images.
  • Graphviz – generate model diagram image.

On MacOS with Homebrew use:

brew install gnuplot graphviz

Manual Method

  1. Create a new database: poietic new
  2. Importing the demo package: poietic import Basic/Interest.poieticframe
  3. To make sure all parameter connections are correct, for some packages you might need to run poietic edit auto-parameters.
  4. Run the simulation: poietic run and see the simulation results in the standard output.

Explore the included run shell script or explore poietic --help and --help of its subcommands to learn more what can be done with the example models.

Experiment with the model by editing it. See the poietic tool documentation for more details.

Development Notes

The included demos are in early stage of development. The file format of the demos is not yet stable and might change. If you create your own derivatives, please be aware, that they might or might not work in the future.

Author