reticuler 2.0

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). Materials

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.