{"id":28082,"library":"pyclothoids","title":"PyClothoids","description":"A library for clothoid curves (also known as Euler spirals or Cornu spirals) in Python. Current version is 0.2.0, released with support for closest point calculations, projections, and caching. The library is under active development.","status":"active","version":"0.2.0","language":"python","source_language":"en","source_url":"https://github.com/phillipd94/PyClothoids","tags":["clothoid","clothoid-curves","euler-spiral","geometry","curves","road-design"],"install":[{"cmd":"pip install pyclothoids","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"Package name is pyclothoids, not clothoid","wrong":"from clothoid import Clothoid","symbol":"Clothoid","correct":"from pyclothoids import Clothoid"}],"quickstart":{"code":"from pyclothoids import Clothoid\n\n# Create a clothoid from start and end states\nx0, y0, theta0 = 0.0, 0.0, 0.0  # start\nx1, y1, theta1 = 10.0, 5.0, 1.0  # end\n\nclothoid = Clothoid.G1Hermite(x0, y0, theta0, x1, y1, theta1)\n\n# Sample points along the clothoid\npoints = clothoid.SampleXY(100)\nprint(points)","lang":"python","description":"Create a clothoid curve using G1 Hermite interpolation and sample points."},"warnings":[{"fix":"Always use a factory class method like Clothoid.G1Hermite(...), Clothoid.G2Hermite(...), or Clothoid.BiArclength(...).","message":"The Clothoid class is not exported; use Clothoid.G1Hermite (or other class methods) to create instances. Direct instantiation with Clothoid() will fail.","severity":"gotcha","affected_versions":"all"},{"fix":"Check the changelog and adapt calls if upgrading from 0.1.x. Use the public API documented in the README.","message":"The library is not yet stable; API may change between minor versions. Version 0.2.0 introduced new methods like ClosestPoint and Distance, but existing code may break if it relied on internal attributes.","severity":"gotcha","affected_versions":"<=0.2.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Use 'from pyclothoids import Clothoid' or 'import pyclothoids'.","cause":"Incorrect import path; the module is named pyclothoids, not clothoid.","error":"ModuleNotFoundError: No module named 'clothoid'"},{"fix":"Use Clothoid.G1Hermite(...) or other class methods to instantiate.","cause":"Attempting to create a Clothoid by calling Clothoid() directly, but the class requires a factory method.","error":"TypeError: 'ClothoidType' object is not callable"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}