https://github.com/philipbelesky/caribou
Caribou is a Grasshopper plugin for parsing downloaded Open Street Map data into Rhino geometry. Caribou is currently in beta.
https://github.com/philipbelesky/caribou
grasshopper-plugin grasshopper3d open-street-map osm
Last synced: 4 months ago
JSON representation
Caribou is a Grasshopper plugin for parsing downloaded Open Street Map data into Rhino geometry. Caribou is currently in beta.
- Host: GitHub
- URL: https://github.com/philipbelesky/caribou
- Owner: philipbelesky
- License: lgpl-3.0
- Created: 2021-04-11T08:01:27.000Z (about 4 years ago)
- Default Branch: develop
- Last Pushed: 2022-12-08T15:29:40.000Z (over 2 years ago)
- Last Synced: 2025-01-12T22:47:13.584Z (5 months ago)
- Topics: grasshopper-plugin, grasshopper3d, open-street-map, osm
- Language: C#
- Homepage:
- Size: 12.9 MB
- Stars: 26
- Watchers: 3
- Forks: 3
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
- Citation: CITATION.cff
Awesome Lists containing this project
README

# Caribou
[](https://github.com/philipbelesky/Caribou/actions/workflows/dotnet-grasshopper.yml)
[](https://github.com/philipbelesky/Caribou/actions/workflows/dotnet-tests.yml)
[](https://codeclimate.com/github/philipbelesky/Caribou/maintainability)
[](https://www.codacy.com/gh/philipbelesky/Caribou/dashboard?utm_source=github.com&utm_medium=referral&utm_content=philipbelesky/Caribou&utm_campaign=Badge_Grade)Caribou is a [Grasshopper plugin](https://www.grasshopper3d.com/) for parsing downloaded Open Street Map data into Rhino geometry. Caribou is currently in an beta state, but core functionality should be stable.
### Installation
Caribou is available to download via the [Rhino Package Manager](https://www.rhino3d.com/features/package-manager/) (search *"Caribou"*) or on [Food4Rhino](https://www.food4rhino.com/en/app/caribou?lang=en).
### Documentation & Support
Caribou's documentation [lives on this website](https://caribou.philipbelesky.com) and on [YouTube](https://www.youtube.com/user/philipbelesky).
Support can be requested, or feedback provided, by [opening a discussion on GitHub](https://github.com/philipbelesky/Caribou/discussions). Issues and pull-requests are encouraged.
### Features
- ✅ Windows and MacOS are both fully supported
- ✅ Very fast parsing of even very large files
- ✅ Data-rich GUI interface provided for understanding and filtering OSM metadata
- ✅ Parsing is performed asynchronously so Grasshopper remains responsive
- ✅ Parse multiple OSM files simultaneously with de-duplication of geometry
- ✅ Allows for querying for arbitrary data outside of the primary OSM features/sub-features taxonomy
- ✅ Outputs are tree-formatted and organised per data-type to allow for downstream filtering, tagging, baking, etc### Roadmap
- 🕘 Further speed optimisations
- 🕘 Component to help construct queries for arbitrary metadata
- 🕘 Parsing of `` type data
- 🕘 Integration with Rhino's `EarthAnchorPoint`
- 🕘 Customisable projection methods### Changelog
See [CHANGELOG.md](https://github.com/philipbelesky/Caribou/blob/main/CHANGELOG.md).
### Recognition
Thanks to:
- Timothy Logan, author of [Elk](https://github.com/logant/Elk), for LatLon conversion math and for an example of feature-picker form.
- Dimitrie Stefanescu and the authors of the [GrasshopperAsyncComponent](https://github.com/specklesystems/GrasshopperAsyncComponent) repo.
- Povl Filip Sonne-Frederiksen, author of the [Yak package manager action](https://github.com/pfmephisto/rhino-yak).