Skip to main content

termigrad

A terminal-based ascii visualiser for the Gray Scott Reaction-Diffusion model.

Installation

pip install termigrad
termigrad -h

Features

  • Simplistic, readable, highly extensible codebase
  • Minimalist, colour ascii graphics
  • Highly customisable parameters for the Gray Scott model

Usage

Run with no arguments to start the stripes preset. Press Ctrl-C to stop.

termigrad

Options

Flag Description
--preset NAME Preset parameters to start with! Accepts any of coral, mooncake, spots, stripes, worms. Defaults to stripes.
--feed F Override the preset feed rate with custom input.
--kill K Override the preset kill rate with custom kill.
--speed X Speed multiplier, intuitively 0.5 for half speed, 2 for double, 0 for unlimited. Defaults to 1.0.
--no-colour Render in plain ASCII, without colour :<.
--version Print the version and exit.

Presets

Each preset is a feed/kill pair for the Gray-Scott model:

Preset Feed (F) Kill (k) Pattern
spots 0.0367 0.0649 Spots, mitosis
coral 0.0545 0.0620 Coral, branching
worms 0.0300 0.0620 Worms, moving structures
stripes 0.0220 0.0510 Stripes (default)
mooncake 0.0400 0.0600 Moon cake

The diffusion rates are fixed at dU = 0.160 and dV = 0.080.

For anything outside the presets, pass your own feed and kill rates:

termigrad --preset worms --feed 0.026

Colour

Output uses 24-bit colour where the terminal supports it, and falls back to plain ASCII when stdout is not a TTY. Colour is also disabled automatically when the NO_COLOR environment variable is set, or with --no-colour.

Requirements

Python 3.9 or newer, and numpy. Needs a terminal of at least 60x24 (I mean it should work no matter, but to see anything interesting requires a decently large terminal).

Metadata

Release files for termigrad 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for termigrad 0.2.0
File Size Uploaded
termigrad-0.2.0.tar.gz 17.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for termigrad 0.2.0
File Interpreter ABI Platform
termigrad-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 35.6 kB

Release files / termigrad-0.2.0.tar.gz

Download URL termigrad-0.2.0.tar.gz
Size 17.8 kB
Tags Source
SHA-256 checksum
How to use checksums
e96e139016428264d80a9051b925d830f316460454920a4fda1d5298cd7cc229
BLAKE2b-256 checksum
How to use checksums
af68b2ef7579469d05b1405be56e099fe1b396bb3bb32a84fde70366579e3c2e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Release files / termigrad-0.2.0-py3-none-any.whl

Download URL termigrad-0.2.0-py3-none-any.whl
Size 17.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e08c0340fb645a1b14e4bd2c7e1904d407e85ecb53cd37782a1a9d5143407841
BLAKE2b-256 checksum
How to use checksums
8179b6c8c5403d44a4115f77f36615c3a08ff6ba1626033cedbeaaf3ffe6b9e7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Release history Release notifications | RSS feed

0.3.0

2 release files

This release

0.2.0 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page