{"id":30895493,"url":"https://github.com/ladybug-tools/ladybug-geometry","last_synced_at":"2026-02-17T01:03:37.455Z","repository":{"id":34909129,"uuid":"155406129","full_name":"ladybug-tools/ladybug-geometry","owner":"ladybug-tools","description":"🐞 📦 A library with geometry objects used throughout the Ladybug Tools core libraries","archived":false,"fork":false,"pushed_at":"2026-02-10T00:12:18.000Z","size":3213,"stargazers_count":29,"open_issues_count":2,"forks_count":24,"subscribers_count":3,"default_branch":"master","last_synced_at":"2026-02-10T06:00:44.243Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.ladybug.tools/ladybug-geometry/docs/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ladybug-tools.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2018-10-30T15:10:02.000Z","updated_at":"2026-02-10T00:10:04.000Z","dependencies_parsed_at":"2026-01-31T01:07:16.894Z","dependency_job_id":null,"html_url":"https://github.com/ladybug-tools/ladybug-geometry","commit_stats":{"total_commits":363,"total_committers":10,"mean_commits":36.3,"dds":0.4573002754820936,"last_synced_commit":"48c0b7f0c2b899764532de9ee67af8956c5a6e60"},"previous_names":[],"tags_count":196,"template":false,"template_full_name":null,"purl":"pkg:github/ladybug-tools/ladybug-geometry","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ladybug-tools%2Fladybug-geometry","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ladybug-tools%2Fladybug-geometry/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ladybug-tools%2Fladybug-geometry/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ladybug-tools%2Fladybug-geometry/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ladybug-tools","download_url":"https://codeload.github.com/ladybug-tools/ladybug-geometry/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ladybug-tools%2Fladybug-geometry/sbom","scorecard":{"id":576895,"data":{"date":"2025-08-11","repo":{"name":"github.com/ladybug-tools/ladybug-geometry","commit":"c177f20f7e7597b2a4810717b943ee5293eca021"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.8,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/28 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/ci.yaml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Maintained","score":5,"reason":"6 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 5","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/ladybug-tools/ladybug-geometry/ci.yaml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/ladybug-tools/ladybug-geometry/ci.yaml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/ladybug-tools/ladybug-geometry/ci.yaml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:37: update your workflow using https://app.stepsecurity.io/secureworkflow/ladybug-tools/ladybug-geometry/ci.yaml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/ladybug-tools/ladybug-geometry/ci.yaml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:92: update your workflow using https://app.stepsecurity.io/secureworkflow/ladybug-tools/ladybug-geometry/ci.yaml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:94: update your workflow using https://app.stepsecurity.io/secureworkflow/ladybug-tools/ladybug-geometry/ci.yaml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yaml:105: update your workflow using https://app.stepsecurity.io/secureworkflow/ladybug-tools/ladybug-geometry/ci.yaml/master?enable=pin","Warn: pipCommand not pinned by hash: .github/workflows/ci.yaml:24","Warn: pipCommand not pinned by hash: .github/workflows/ci.yaml:25","Warn: pipCommand not pinned by hash: .github/workflows/ci.yaml:46","Warn: pipCommand not pinned by hash: .github/workflows/ci.yaml:47","Warn: npmCommand not pinned by hash: .github/workflows/ci.yaml:51","Warn: pipCommand not pinned by hash: .github/workflows/ci.yaml:99","Warn: pipCommand not pinned by hash: .github/workflows/ci.yaml:100","Info:   0 out of   7 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   1 third-party GitHubAction dependencies pinned","Info:   0 out of   6 pipCommand dependencies pinned","Info:   0 out of   1 npmCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: GNU Affero General Public License v3.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Vulnerabilities","score":5,"reason":"5 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: PYSEC-2013-22 / GHSA-27x4-j476-jp5f","Warn: Project is vulnerable to: PYSEC-2025-49 / GHSA-5rjg-fvgr-3xxf","Warn: Project is vulnerable to: GHSA-cx63-2mw6-8hw5","Warn: Project is vulnerable to: PYSEC-2022-43012 / GHSA-r9hx-vwmv-q579","Warn: Project is vulnerable to: PYSEC-2022-43017 / GHSA-qwmp-2cf2-g9g6"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/ci.yaml:29"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 30 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-20T18:05:35.717Z","repository_id":34909129,"created_at":"2025-08-20T18:05:35.717Z","updated_at":"2025-08-20T18:05:35.717Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29528263,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-17T00:57:22.232Z","status":"ssl_error","status_checked_at":"2026-02-17T00:54:25.811Z","response_time":115,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-09-08T22:06:42.645Z","updated_at":"2026-02-17T01:03:37.426Z","avatar_url":"https://github.com/ladybug-tools.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n![Ladybug](http://www.ladybug.tools/assets/img/ladybug.png)\n\n[![Build Status](https://github.com/ladybug-tools/ladybug-geometry/workflows/CI/badge.svg)](https://github.com/ladybug-tools/ladybug-geometry/actions)\n[![Coverage Status](https://coveralls.io/repos/github/ladybug-tools/ladybug-geometry/badge.svg?branch=master)](https://coveralls.io/github/ladybug-tools/ladybug-geometry?branch=master)\n\n[![Python 3.7](https://img.shields.io/badge/python-3.7-blue.svg)](https://www.python.org/downloads/release/python-370/) [![Python 2.7](https://img.shields.io/badge/python-2.7-green.svg)](https://www.python.org/downloads/release/python-270/) [![IronPython](https://img.shields.io/badge/ironpython-2.7-red.svg)](https://github.com/IronLanguages/ironpython2/releases/tag/ipy-2.7.8/)\n\n# ladybug-geometry\n\nLadybug geometry is a Python library that houses geometry objects and geometry\ncomputations methods used throughout the Ladybug Tools core libraries.\n\nThe library is designed to work with a wide range of Python environments and\nit returns consistent results between them (cPython 2 and 3, IronPython 2).\n\n## Installation\n\n`pip install -U ladybug-geometry`\n\n## [API Documentation](https://www.ladybug.tools/ladybug-geometry/docs/)\n\n## Currently Supported Capabilities of this Library\n\n- Perform Vector Math (Dot, Cross, Angle, Normalize)\n- Calculate Bounding Box for any Geometry (Min, Max, Center)\n- Subdivide Lines and Arcs\n- Compute Perimeter and Area of Planar Geometry\n- Check Concavity and Clockwise Ordering of 2D Geometry\n- Triangulate Planar Geometry\n- Compute Mesh Face Areas, Centroids, and Normals\n- Move Any Geometry\n- Rotate Any Geometry Around an Axis (or in the XY plane)\n- Mirror (Reflect) Any Geometry Over a Plane\n- Scale Any Geometry from a Base Point\n- Check if a 2D Point Inside 2D Polygon\n- Compute [Pole of Inaccessibility](https://en.wikipedia.org/wiki/Pole_of_inaccessibility) for any 2D Polygon\n- Check the Relationship Between 2D Polygons within a Tolerance (inside, outside, overlap)\n- Group 2D Polygons According to Overlaps\n- Perform 2D Polygon Boolean Operations (Union, Intersection, Difference)\n- Intersect Colinear 2D Polygon Segments with one Another (for matching lengths)\n- Join Line Segments into Polylines\n- Calculate 3D Face Plane and Normal from Vertices\n- Compute 3D Face Intersection with a Ray or Line\n- Generate a Quad Mesh Grid from a 3D Face\n- Generate Sub-faces Based on Ratio with a Face (used for window generation)\n- Generate Contours and Contour Fins from a Face (used to generate louvers, fins and overhangs)\n- Split, Union, or Intersect 3D Coplanar Faces with one Another (for matching areas)\n- Solve Adjacencies by Matching 3D Face Geometries\n- Join 3D Faces into 3D Polyfaces\n- Check if a 3D PolyFace is a Closed Solid\n- Ensure All Faces of a Solid 3D PolyFace Point Outwards\n- Compute the Volume of a Closed 3D Polyface\n- Check if a Point is Inside a Closed 3D Polyface\n\n## Officially Unsupported Capabilities for which One Must Rely on CAD Interfaces\n\n- Conversion of Curved 3D Surfaces to Planar 3D Faces\n- Fancier Meshing (eg. gridded meshing that completely fills the base surface)\n- Solid Boolean Unions (this should not be needed for anything in Ladybug Tools)\n\n## Acknowledgements\n\nThis library was built by combining capabilities of several different open-source\n(MIT Licensed) projects, establishing a set of standardized geometry objects that\nallowed them all to talk to one another, and adding several other capabilities\nwith new code. We as a community owe a huge amount of thanks to the open source projects\nthat provided many of the starting capabilities of this package and we are indebted\nto the developers who made their work available under an MIT license for the betterment\nof geometry computation everywhere. Where possible, you will find detailed lists of\nreferences in the docstrings of this package's source code. A summary of the key\nsources that were used to build this library are as follows:\n\n- [euclid](https://pypi.org/project/euclid/)\n- [earcut](https://github.com/mapbox/earcut) and [earcut-python](https://github.com/joshuaskelly/earcut-python)\n- [polybooljs](https://github.com/velipso/polybooljs) and [pypolybool](https://github.com/KaivnD/pypolybool)\n- [polylabel](https://github.com/Twista/python-polylabel)\n- [pySTL](https://github.com/proverbialsunrise/pySTL)\n- A countless number of [StackOverflow](https://stackoverflow.com/) experts who answered various geometry questions\n- A countless number of [Wikipedia](https://www.wikipedia.org/) authors who described various geometry algorithms\n\n## Reasons for this Library\n\nWe initially debated whether the burden of geometry computation should be placed largely\non the CAD environments in which Ladybug Tools operates or whether it should be included\nin a dedicated core Python library like this one.\n\nAs we developed the core libraries, it became clear that there are large advantages\nto having it in the core including:\n\n1. Standardized compatibility of geometry between different CAD plugins (eg. Rhino, Revit), simulation engines (eg. E+, Radiance), and file formats (eg. gbXML, GEM).\n2. The ability to perform geometry operations from the core library CLI without the need for CAD software.\n3. Improved performance (since a dedicated library could be tailored to the use cases of Ladybug Tools).\n4. Reliability and maintain-ability in the face of changes to CAD environments and changing Python conventions.\n\nItems 1 and 4 above proved to be particularly important and so the decision was made\nthat the Ladybug Tools core libraries would have its own geometry library that was\ndistinct from CAD plugins.\n\nBefore committing to write our own library, we looked into using or tweaking other\ncomprehensive open source geometry libraries for the core including:\n\n- [Rhino3dm](https://github.com/mcneel/rhino3dm)\n- [Blender API (bpy)](https://docs.blender.org/api/current/)\n- [Boost Geometry](https://www.boost.org/doc/libs/1_78_0/libs/geometry/doc/html/index.html)\n- [Topologic](https://topologic.app/Software/)\n\nHowever, Rhino3dm lacks basic geometry computation. The Blender library had many capabilities\nbut it only works in Python3 and this could break certain CAD workflows that rely on\nIronPython. Boost Geometry (the geometry library used by the OpenStudio SDK) also had a\nlot of functionality but it clearly has C dependencies, making it unusable from IronPython.\nTopologic also appeared to have C dependencies, though the most relevant issue was\nthat its dual license could create challenges for certain use cases of Ladybug Tools.\n\nAfter considering the situation further, we realized that many of the capabilities that\nwe needed could be achieved by building off the work of various open source MIT-licensed\nprojects as long as we committed to using planar geometry. Since all of the geometry\nultimately going to the engines (Radiance, E+) is planar, we made the decision that\nthe core libraries will primarily support planar objects with no NURBS support and\nvery limited support for Arcs, Circles, Spheres, Cylinders and Cones.\n\nThus this repository was born!\n\n## Local Development\n\n1. Clone this repo locally\n```console\ngit clone git@github.com:ladybug-tools/ladybug-geometry.git\n\n# or\n\ngit clone https://github.com/ladybug-tools/ladybug-geometry.git\n```\n\n2. Install dependencies:\n```console\ncd ladybug-geometry\npip install -r dev-requirements.txt\npip install -r requirements.txt\n```\n\n3. Run Tests:\n```console\npython -m pytests tests/\n```\n\n4. Generate Documentation:\n```console\nsphinx-apidoc -f -e -d 4 -o ./docs ./ladybug_geometry\nsphinx-build -b html ./docs ./docs/_build/docs\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fladybug-tools%2Fladybug-geometry","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fladybug-tools%2Fladybug-geometry","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fladybug-tools%2Fladybug-geometry/lists"}