# Caribou

Caribou is a Grasshopper plugin 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 (search “Caribou”) or on Food4Rhino.

Documentation & Support

Caribou’s documentation lives on this website and on YouTube.

Support can be requested, or feedback provided, by opening a discussion on GitHub. 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 <relation> type data
• 🕘 Integration with Rhino’s EarthAnchorPoint
• 🕘 Customisable projection methods

Changelog

See CHANGELOG.md.

Recognition

Thanks to:

• Timothy Logan, author of Elk, for LatLon conversion math and for an example of feature-picker form.
• Dimitrie Stefanescu and the authors of the GrasshopperAsyncComponent repo.
• Povl Filip Sonne-Frederiksen, author of the Yak package manager action.