Skip to content

carbonplan/ocr

Open Climate Risk (OCR) Platform

CI GitHub Workflow Status Deploy Status Code Coverage Status pre-commit.ci status
License License
Docs Documentation Status

A scalable platform for analyzing and visualizing climate-related risks at a building-level resolution across the Continental United States (CONUS)

Quick Start

Installation

Important

We use pixi to manage our development environment, which you'll need to install before you can get started with the project.

# Clone the repository
git clone https://github.com/carbonplan/ocr.git
cd ocr

# Install dependencies with pixi
pixi install

# Activate the environment
pixi shell

Development

Running Tests

# Run all tests
pixi run tests

# Run specific test file
pixi run pytest tests/test_datasets.py

# Run integration tests
pixi run tests-integration

Code Quality

# Format code
pixi run format

# Run linting
pixi run lint

We welcome contributions! Please see our contributing guide for detailed instructions on:

  • Setting up your development environment

  • Running tests and quality checks

  • Submitting pull requests

  • Documentation - Full documentation

  • Issues - Report bugs or request features via GitHub Issues

  • Discussions - Join the conversation in GitHub Discussions

Data Access

Our processed input datasets and pipeline outputs can be accessed on Source Coop. Details on how to use the data can be found in our technical documentation.

Important

Our codebase and technical documentation make frequent reference to our data catalog, which relies on privately hosted data. Operationalizing our codebase without access to these data will currently require an update to the catalog. See #367 for more detail.

License

Important

OCR code is licensed under the MIT License - see the LICENSE file for details. See the data access page for information on the licenses for the various datasets.

About

Open Climate Risk Platform

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

No packages published

Contributors 9