RoadGen

Generate road segments in a 2D Cartesian plane.

Installation

Ensure you have Python >= 3.12 installed. Clone the repository using

git clone git@github.com:pim-n/road-gen.git
cd road-gen

git clone https://github.com/pim-n/road-gen.git
cd road-gen

then, with a virtual environment (Python >= 3.12) active:

pip install .

Within the virtual environment you can now run the road-gen command:

road-gen --help

A minimal random road needs a length L, step size \Delta s and velocity v:

road-gen random --length 1000 --ds 10 --velocity 10

or in short form

road-gen random -l 1000 -s 10 -v 10

This will show the resulting random road in a plot, but it's not saved after you close the window. To save the results, add the --save flag

road-gen random -l 1000 -s 10 -v 10 --save

which will produce 3 files starting with the unique seed number used to generate the road.

A minimal segmented road needs, besides length L, step size \Delta s and velocity v, a list of segments.

road-gen segments --segments straight turn_left straight turn_right --length 1000 --ds 10 --velocity 10

The parameter \alpha represents the concentration factor for the Dirichlet distribution.

You can reproduce results by adding a seed with the --seed flag.

For more info, see road-gen --help or road-gen random --help.

There are some Jupyter notebooks explaining roads as planar curves, as well as the actual implementation of random segmented roads and random roads from noise.