Metadata-Version: 2.1
Name: carbon-registry-indexer
Version: 0.1.28
Summary: A Python library designed to streamline the aggregation of carbon data from multiple registries, each with its own data format, into a unified schema in CSV/Parquet formats.
Home-page: https://github.com/CarbonMarketsHQ/Carbon-Registry-Indexer
Download-URL: https://github.com/CarbonMarketsHQ/Carbon-Registry-Indexer/archive/refs/tags/v_0.1.7.tar.gz
Author: Gautam P
Author-email: gautam@carbonmarketshq.com
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Description-Content-Type: text/markdown
License-File: LICENSE

## Carbon Registry Indexer

Welcome to the CarbonMarketsHQ Data Indexer! This tool is designed to consolidate data from multiple carbon market registries into a unified schema, making it easier to analyze and utilize carbon market data. This project is open source and we welcome contributions from the community.

### Supported data sources
- [Gold Standard](https://registry.goldstandard.org/projects)
- [American Carbon Registry (ACR)](https://acr2.apx.com/mymodule/mypage.asp)
- [Climate Action Reserve (CAR)](https://thereserve2.apx.com/mymodule/mypage.asp)
- [Climate Action Data Trust (CADT)](https://observer.climateactiondata.org/)

### Installation
To install the package, you can use pip:
```
pip install carbon-registry-indexer
```

### license
All the code in this repository is MIT licensed.

### Sample Usage

```
indexer = CarbonRegistryIndexer(storage_dir='your_storage_dir'
                            azure_blob_conn_str='your_conn_str', 
                            azure_blob_container='your_container_name')
indexer.setup_storage()  # creates or purges data folder

# calls to initiate sync
indexer.sync_gold_standard()
indexer.sync_climate_action_data_trust()
indexer.sync_american_carbon_registry()
indexer.sync_climate_action_reserve()
```

### Output model

- `ProjectLocation`: Stores information about the location of a project, including country, state, and geographic identifier.
- `ProjectRating`: Captures project-level ratings from different rating entities.
- `CoBenefit`: Links a project to the UN Sustainable Development Goals (SDGs) it contributes to.
- `Project`: The core table representing a carbon project. It includes meta information about a project.
- `RelatedProject`: Captures relationships between different projects.
- `Issuance`: Represents an issuance of carbon credits from a project.
- `Label`: Defines a label associated with an issuance, specifying the crediting period and validity.
- `Unit`: Represents the life-cycle of credit units Issued, retired, cancelled, etc.
- `Governance`: Stores picklist values used for governance-related fields.
- `Estimation`: Contains estimated credit information for a project.
