Skip to main content

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

Latest documentation Current build status license shield

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

[Dubins57]

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

[LaValle06]

LaValle, S. M. (2006). “Planning Algorithms”. Cambridge University Press

[Shkel01]

Shkel, A. M. and Lumelsky, V. (2001). “Classification of the Dubins set”. Robotics and Autonomous Systems 34 (2001) 179–202

[Walker11]

Walker, A. (2011). “Hard Real-Time Motion Planning for Autonomous Vehicles”, PhD thesis, Swinburne University.

[Smart08]

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)

Source distribution for dubins 1.0.1
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page