dubins
Overview
This software finds the shortest paths between configurations for the Dubins’ car [Dubins57], the forward only car-like vehicle with a constrained turning radius. A good description of the equations and basic strategies for doing this are described in section 15.3.1 “Dubins Curves” of the book “Planning Algorithms” [LaValle06].
The approach used to find paths is based on the algebraic solutions published in [Shkel01]. However, rather than using angular symmetries to improve performance, the simpler approach to test all possible solutions is used here.
This code is primarily a Cython wrapper of https://github.com/AndrewWalker/Dubins-Curves
Installing
You can install the latest stable version from PyPI
$ pip install dubins
Or, you can install the latest development version from GitHub
$ pip install git+git://github.com/AndrewWalker/pydubins.git
Example
Discrete Sampling of a Dubin’s path at finite step sizes
import dubins
q0 = (x0, y0, theta0)
q1 = (x1, y1, theta1)
turning_radius = 1.0
step_size = 0.5
path = dubins.shortest_path(q0, q1, turning_radius)
configurations, _ = path.sample_many(step_size)
Acknowledgements
This work was completed as part of [Walker11].
Francis Valentinis
Royce Smart - who tested early versions of this code while completing his PhD thesis [Smart08].
References
Dubins, L. E. (July 1957). “On Curves of Minimal Length with a Constraint on Average Curvature, and with Prescribed Initial and Terminal Positions and Tangents”. American Journal of Mathematics 79 (3): 497–516
LaValle, S. M. (2006). “Planning Algorithms”. Cambridge University Press
Shkel, A. M. and Lumelsky, V. (2001). “Classification of the Dubins set”. Robotics and Autonomous Systems 34 (2001) 179–202
Walker, A. (2011). “Hard Real-Time Motion Planning for Autonomous Vehicles”, PhD thesis, Swinburne University.
Royce, S. (2008). “Evolutionary Control of Autonomous Underwater Vehicles”. PhD thesis, RMIT
Metadata
Release files for dubins 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| dubins-1.0.1.tar.gz | 46.1 kB | Without provenance | Details |
Release files / dubins-1.0.1.tar.gz
| Download URL | dubins-1.0.1.tar.gz |
|---|---|
| Size | 46.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2b761b8f9f6d4270867377c18b93d74c63ed4650c98dca485ed81323861f4934
|
|
BLAKE2b-256 checksum How to use checksums |
078cf9bbfd5c015ccbd792c9bf11f331ed63bb26b3602b41e22c1099360bfe5a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for dubins 1.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.