reticuler 1.1

Simulations of spatial networks growth

Reticuler

Python package to simulate the growth of spatial networks in nature.

Documentation

Setup

External dependencies:

FreeFEM++ - PDE solver

Package installation

pip install reticuler

Usage

During the installation four command line scripts are installed:

• reticulate - runs the simulation
• reticulate_back - runs the the Backward Evolution Algorithm
• clip_ret - clips the network to one of the growth thresholds (maximum forward evolution step, length, height, evolution time, or BEA step)
• plot_ret - plots the network based on the .json file from the simulation

To use just type in the command line: reticulate -h

Typical network growth simulation:

• output file: test,
• growth threshold type: maximum network height,
• growth threshold: 2

reticulate -out test --growth_params {\"growth_thresh_type\":1,\"growth_thresh\":2}

How to cite

Through history to growth dynamics: backward evolution of spatial networks, S. Żukowski, P. Morawiecki, H. Seybold, P. Szymczak, Sci. Rep. 12, 20407 (2022). https://doi.org/10.1038/s41598-022-24656-x

References

Bifurcation dynamics of natural drainage networks, A. Petroff, O. Devauchelle, H. Seybold, and D. H. Rothman. Philos. Trans. Royal Soc. A 371, no. 2004 (2013): 20120365.