Skip to content

README.md

Latest commit

 

History

History
23 lines (17 loc) · 1.52 KB

README.md

File metadata and controls

23 lines (17 loc) · 1.52 KB
Raw

bml-cpp-cli is a tiny implementation of Biham-Middleton-Levine traffic model written in C++ and running in the terminal. It was made solely for fun and decorative purposes.

Currently, it only works on Linux.

Installation

Clone the repository and run the provided bml-cli binary. It was compiled using g++ 15.2.0.

Usage

Running the program is as simple as executing the provided binary. There are, however, several command line arguments to adjust the result:

  • --vertical-color or -vc: set the color of the character to be used for south-bound vehicles;
  • --horizontal-color or -hc: set the color of the character to be used for east-bound vehicles;
  • --vertical-symbol or -vs: set the character to be used for south-bound vehicles (will only take the first character from the provided string);
  • --horizontal-symbol or -hs: set the character to be used for east-bound vehicles (will only take the first character from the provided string);
  • --step-time or -st: the duration of a single simulation step in milliseconds (default 100).
  • --density or -d: the density of the vehicles on the lattice (default 0.5).

For example, running ./bml-cli -vc cyan -vs O -hc yellow -vs X -st 50 -d 0.4 will result in a cyan-yellow grid of vehicles with double the default speed and slightly lowered density.

Currently, the color options allow for input of only the basic 8 colors.