A CLI tool to generate a Webots world with a random line follower track.

• Installation
• Usage
  • Track: ETrack
  • Track: Grid
  • Track: Simple
  • Track: <...>
  • Friction
• Used Libraries
• Issues, Ideas And Bugs
• License
• Contribution

$ git clone https://github.com/BlueAndi/pyLineFollowerTrackGenerator.git
$ cd pyLineFollowerTrackGenerator
$ pip install .

Generate a line follower track like a 'E' with the "etrack" command.

Use ./pyLineFollowerTrackGenerator etrack --help to see all possible parameters.

Example: A arena 2 x 2 m generated with splines through 30 points. The line width is 1.5 cm by default.

$ ./pyLineFollowerTrackGenerator Parameters: etrack -a "Andreas Merkle" -d "Line follower track along a 'E'." -e [email protected] -mg cardboard -mr rubber -mp dry etrack

Files:

• etrack.wbt
• etrack.png

Geneate a line follower track in a fixed grid by coordinates in a JSON file.

Use ./pyLineFollowerTrackGenerator grid --help to see all possible parameters.

Example: A arena 3 x 3 m generated with quarter circles. The line width is 1.5 cm by default.

$ .pyLineFollowerTrackGenerator grid -a "Andreas Merkle" -d "Line follower grid track." -e [email protected] -mg cardboard -mr rubber -mp dry -s 3 grid.wbt grid_points.json

Files:

• grid_points.json
• grid.wbt
• grid.png

Generate a simple line follower track with the "simple" command.

Use ./pyLineFollowerTrackGenerator simple --help to see all possible parameters.

Example: A arena 2 x 2 m generated with splines through 12 points. The line width is 1.5 cm by default.

$ ./pyLineFollowerTrackGenerator simple simple.wbt -s=2 -np=12

Files:

• simple.wbt
• simple.png

You are invited to extend it with more different kind of tracks. ;-)

Get a list of available material pairs with their friction parameters by using

$ ./pyLineFollowerTrackGenerator friction

or get a filtered list e.g. for steel:

$ ./pyLineFollowerTrackGenerator friction steel

Specify the material for the ground and for the robot contact material, as well as the material property:

$ ./pyLineFollowerTrackGenerator simple simple.wbt -s=2 -np=12 -mg cardboard -mr rubber -mp dry

Notes:

• Static and dynamic friction are supported.
• Only symmetric friction is supported.
• If the friction has a range, the friction will be determined random (min <= friction <= max).
• Find the source for the friction parameters in friction database.
• In the Webots contact properties the friction parameters are configured.
• Details about the physical simulation are explained in the Open Physics Engine manual, which is used by Webots.

Used 3rd party libraries which are not part of the standard Python package:

If you have further ideas or you found some bugs, great! Create a issue or if you are able and willing to fix it by yourself, clone the repository and create a pull request.

The whole source code is published under the MIT license. Consider the different licenses of the used third party libraries too!

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, shall be licensed as above, without any additional terms or conditions.