lgca 0.2.0

Lattice gas automata implemented in Python.

Lattice Gas Cellular Automata

This project focuses on the declarative implementation of the popular Lattice Gas Cellular Automata listed below. Models with checked names are implemented and ready to use.

• HPP
• FHP I
• FHP II
• FHP III

Currently, all the models are fully implemented, so feel free to test them.

Application GUI

Application window when the following commands were called:

lgca --model-name=HPP --pattern=wiki --steps=640 --run

lgca --model-name=FHP_II --pattern=obstacle --steps=250 --run

Installation

Install using pip (creating a Python virtual environment first is strongly recommended).

pip install lgca

Usage

To get some information about the application just run:

lgca --help

and You should see something like below.

pygame 2.5.2 (SDL 2.28.3, Python 3.12.7)
Hello from the pygame community. https://www.pygame.org/contribute.html
Usage: lgca [OPTIONS]

  Lattice Gas Cellular Automata [X] HPP [X] FHP I [X] FHP II [X] FHP III

Options:
  -v, --value TEXT                Content value.  [default: 0]
  -n, --model-name [HPP|FHP_I|FHP_II|FHP_III]
                                  Model name.  [default: HPP]
  -w, --width INTEGER             Lattice window width.  [default: 300]
  -h, --height INTEGER            Lattice window height.  [default: 200]
  -s, --steps INTEGER             Number of steps.  [default: -1]
  -r, --run                       Run immediately.
  -d, --deterministic             Generate the same randomized result for the
                                  same params.  [default: True]
  -p, --pattern [wiki|random|alt|single|obstacle|test]
                                  Select initial state pattern.  [default:
                                  wiki]
  --help                          Show this message and exit.

So the sample usage can look like this

lgca --run

The above command should display the HPP model visualization, identical to the one on Wikipedia.

https://en.wikipedia.org/wiki/HPP_model

• To start/stop the application just press the space button.
• To reset app to the initial state press the S button.
• To quit the app pres ESC button or quit the window.

References

• Hardy, J., Pomeau, Y., & Pazzis, O.D. (1973). Time evolution of a two‐dimensional model system. I. Invariant states and time correlation functions. Journal of Mathematical Physics, 14, 1746-1759.
• Hardy, J., Pazzis, O.D., & Pomeau, Y. (1976). Molecular dynamics of a classical lattice gas: Transport properties and time correlation functions. Physical Review A, 13, 1949-1961.
• Frisch, U., Hasslacher, B., & Pomeau, Y. (1986). Lattice-gas automata for the Navier-Stokes equation. Physical review letters, 56 14, 1505-1508 .
• Frisch, U., d'Humières, D., Hasslacher, B., Lallemand, P., Pomeau, Y., & Rivet, J. (1987). Lattice Gas Hydrodynamics in Two and Three Dimensions. Complex Syst., 1.
• Wylie, B.J. (1990). Application of two-dimensional cellular automaton lattice-gas models to the simulation of hydrodynamics.
• Buick, J.M. (1997). Lattice Boltzmann methods in interfacial wave modelling.

Status