Climakitae

Enable a transition from climate vulnerability assessments to decision support for investor-owned utilities and other stakeholders.
https://github.com/cal-adapt/climakitae

Category: Climate Change
Sub Category: Climate Data Processing and Analysis

Keywords from Contributors

pangeo

Last synced: about 20 hours ago
JSON representation

Repository metadata

A Python toolkit for retrieving, visualizing, and performing scientific analyses with data from the Cal-Adapt Analytics Engine.

README.md

Climakitae

codecov
CI
docs
PyPI version
Python
License
Code style: black
DOI:10.5281/zenodo.18111935

A powerful Python toolkit for climate data analysis and retrieval from the Cal-Adapt Analytics Engine (AE).

Climakitae provides intuitive tools for accessing, analyzing, and visualizing downscaled CMIP6 data, enabling researchers and practitioners to perform comprehensive climate impact assessments for California.

[!WARNING]
This package is under active development. APIs may change between versions.

Key Features

  • 🌑️ Comprehensive Climate Data Access: Retrieve climate variables from hosted climate model, weather station, and renewable energy datasets
  • πŸ“Š Downscaled Climate Models: Access dynamical (WRF) and statistical (LOCA2) downscaling methods
  • πŸ—ΊοΈ Spatial Analysis Tools: Built-in support for geographic subsetting and spatial aggregation
  • πŸ“ˆ Climate Indices: Calculate heat indices, warming levels, and extreme event metrics
  • πŸ”§ Flexible Data Export: Export to NetCDF, CSV, and Zarr

About Cal-Adapt

Climakitae is developed as part of the Cal-Adapt Analytics Engine, a platform for California climate data and tools. Cal-Adapt provides access to cutting-edge climate science to support adaptation planning and decision-making.

Getting Started

Installation

Climakitae requires Python 3.12 or 3.13. We recommend uv on Linux/macOS and conda on Windows or when native geospatial dependencies cause trouble.

Quick install of the latest release:

# with uv
uv pip install climakitae

# with conda
conda create -n climakitae python=3.13 -y
conda activate climakitae
pip install climakitae

For editable installs, developer dependencies, and platform-specific tips, see the Installation Guide on the wiki.

Basic Usage

from climakitae.new_core.user_interface import ClimateData

# Retrieve monthly max temperature for Los Angeles in 2015
data = (
    ClimateData()
    .catalog("cadcat")
    .activity_id("WRF")
    .institution_id("UCLA")
    .table_id("mon")
    .grid_label("d03")
    .variable("t2max")
    .processes({
        "time_slice": ("2015-01-01", "2015-12-31"),
        "clip": "Los Angeles",
    })
    .get()
)

# Data is returned as a lazy xarray Dataset
print(data)

The legacy climakitae.core.data_interface.get_data API is still supported for backward compatibility, but new work should use ClimateData from climakitae.new_core.

Documentation

Resource Description
Installation Guide Casual, power-user, and developer installs
AE Navigation Guide Interactive notebook tutorial
API Reference Complete API documentation
AE Notebooks Sample notebooks and scripts
Contributing Development guidelines

Contributing

We welcome contributions! Please see our contributing guidelines for details on:

  • πŸ› Reporting bugs
  • πŸ’‘ Requesting features
  • πŸ”§ Submitting code changes
  • πŸ“– Improving documentation

For setting up a development environment (editable install, tests, formatters), see the Installation Guide on the wiki.

When opening a pull request, please tag at least two project maintainers for review.

License

This project is licensed under the BSD 3-Clause License - see the LICENSE file for details.

Support


Contributors

Contributors


Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 2 days ago

Total Commits: 5,305
Total Committers: 21
Avg Commits per committer: 252.619
Development Distribution Score (DDS): 0.81

Commits in past year: 1,741
Committers in past year: 10
Avg Commits per committer in past year: 174.1
Development Distribution Score (DDS) in past year: 0.784

Name Email Commits
claalmve c****9@b****u 1009
Nicole Keeney n****y@g****m 948
neilSchroeder n****r@g****m 726
Ana Ordonez a****z@e****m 581
Eric Lehmer e****r@b****u 440
neilSchroeder n****r@g****m 381
name v****a@e****m 376
Victoria Ford f****o@g****m 318
naomi t****g 139
Tianchi-Liu l****c@b****u 92
Cora Kingdon c****n@b****u 89
bethem b****h@e****m 58
Brian Galey b****y@g****m 39
Nabig Chaudhry n****g@l****v 33
Will Krantz k****w@g****m 24
Owen Doherty o****y@g****m 22
Grace Di Cecco 3****o 12
Calvin Chen c****n@C****l 9
Brian Galey b****y@b****u 5
copilot-swe-agent[bot] 1****t 3
dependabot[bot] 4****] 1

Committer domains:


Issue and Pull Request metadata

Last synced: 2 days ago

Total issues: 64
Total pull requests: 686
Average time to close issues: 2 months
Average time to close pull requests: 9 days
Total issue authors: 16
Total pull request authors: 13
Average comments per issue: 1.45
Average comments per pull request: 1.18
Merged pull request: 520
Bot issues: 0
Bot pull requests: 1

Past year issues: 10
Past year pull requests: 84
Past year average time to close issues: 10 days
Past year average time to close pull requests: 11 days
Past year issue authors: 3
Past year pull request authors: 7
Past year average comments per issue: 0.5
Past year average comments per pull request: 1.85
Past year merged pull request: 66
Past year bot issues: 0
Past year bot pull requests: 1

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/cal-adapt/climakitae

Top Issue Authors

  • elehmer (14)
  • vicford (12)
  • neilSchroeder (10)
  • acordonez (8)
  • zladwp (4)
  • claalmve (3)
  • dlebauer (2)
  • rd1l (2)
  • nathancoliver (2)
  • janluong (1)
  • nicolejkeeney (1)
  • mirachokshi (1)
  • alwils916 (1)
  • rgalanakis (1)
  • thenaomig (1)

Top Pull Request Authors

  • claalmve (222)
  • elehmer (148)
  • nicolejkeeney (92)
  • neilSchroeder (85)
  • acordonez (55)
  • vicford (34)
  • Tianchi-Liu (26)
  • wkrantz (7)
  • thenaomig (7)
  • vdmachuca (6)
  • gdicecco (2)
  • dependabot[bot] (1)
  • corakingdon (1)

Top Issue Labels

  • bug (31)
  • enhancement (9)
  • environment (3)
  • Release 1.2.0 (2)
  • Release 1.2.2 (2)
  • question (1)
  • cloud (1)

Top Pull Request Labels

  • Advanced Testing (54)
  • backburner (10)
  • bug (2)
  • Urgent (2)
  • enhancement (2)
  • dependencies (1)
  • github_actions (1)

Package metadata

proxy.golang.org: github.com/cal-adapt/climakitae

  • Homepage:
  • Documentation: https://pkg.go.dev/github.com/cal-adapt/climakitae#section-documentation
  • Licenses: bsd-3-clause
  • Latest release: v1.5.10 (published 29 days ago)
  • Last Synced: 2026-10-27T03:06:50.672Z (2 days ago)
  • Versions: 17
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Rankings:
    • Dependent packages count: 5.103%
    • Average: 5.274%
    • Dependent repos count: 5.445%
pypi.org: climakitae

Climate data analysis toolkit

  • Homepage: https://github.com/cal-adapt/climakitae
  • Documentation: https://cal-adapt.github.io/climakitae/dev/
  • Licenses: BSD-3-Clause
  • Latest release: 1.5.10 (published 29 days ago)
  • Last Synced: 2026-10-27T03:06:49.308Z (2 days ago)
  • Versions: 22
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 534 Last month
  • Rankings:
    • Dependent packages count: 10.329%
    • Average: 34.233%
    • Dependent repos count: 58.137%
  • Maintainers (1)

Dependencies

setup.py pypi
.github/workflows/ci-not-main-pr.yml actions
  • actions/checkout v3 composite
  • actions/checkout v4 composite
  • actions/setup-python v5 composite
  • psf/black 26.3.0 composite
pyproject.toml pypi
  • aiobotocore <=2.22.0
  • boto3 <=1.37.3
  • dask *
  • dask-gateway *
  • dask-geopandas *
  • fastparquet ==2025.12.0
  • fsspec *
  • geopandas *
  • geopy *
  • icechunk >=1.1.15
  • intake *
  • intake-esm <=2023.11.10
  • intake-geopandas *
  • intake-xarray *
  • iprogress >=0.4
  • ipython *
  • ipywidgets >=8.1.8
  • matplotlib *
  • numcodecs <=0.14.1
  • numpy *
  • pandas <3.0
  • param *
  • psutil *
  • pydantic >=2.0,<2.13
  • pyproj *
  • pytz *
  • rioxarray *
  • s3fs *
  • scipy *
  • setuptools <81
  • shapely *
  • statsmodels *
  • timezonefinder *
  • tqdm *
  • xarray *
  • xclim >0.56.0
  • xmip *
  • xsdba *
.github/workflows/docs-coverage-check.yml actions
  • actions/checkout v4 composite
.github/workflows/ci-main.yml actions
  • actions/checkout v3 composite
  • actions/checkout v4 composite
  • actions/setup-python v5 composite
  • codecov/codecov-action v5 composite
  • psf/black 26.3.0 composite
.github/workflows/ci-not-main.yml actions
  • actions/checkout v3 composite
  • psf/black 26.3.0 composite
.github/workflows/docs-mkdocs.yml actions
  • actions/checkout v4 composite
  • actions/setup-python v5 composite
.github/workflows/publish.yml actions
  • actions/checkout v4 composite
  • actions/download-artifact v4 composite
  • actions/setup-python v5 composite
  • actions/upload-artifact v4 composite
  • pypa/gh-action-pypi-publish release/v1 composite
.github/workflows/send-issues-to-slack.yml actions
  • archive/github-actions-slack v2.0.0 composite
.binder/environment.yml conda
  • black
  • bokeh
  • cartopy
  • cftime
  • dask
  • dask-core
  • fiona
  • flake8
  • geopandas
  • git
  • griffe
  • h5netcdf
  • intake
  • intake-xarray
  • ipykernel
  • ipython
  • ipywidgets
  • isort
  • jupyterlab
  • matplotlib
  • mike
  • mkdocs
  • mkdocs-material
  • mkdocstrings-python
  • netcdf4
  • notebook
  • numpy
  • pandas
  • pip
  • pyproj
  • pytest
  • pytest-xdist
  • python 3.12
  • requests
  • scipy
  • seaborn
  • shapely
  • xarray
  • zarr
.github/workflows/docs-check.yml actions
  • actions/checkout v4 composite
  • actions/setup-python v5 composite
  • lycheeverse/lychee-action v2 composite
docs-mkdocs/requirements-mkdocs.txt pypi
  • mike >=2.0
  • mkdocs >=1.6
  • mkdocs-material >=9.6
  • mkdocstrings-python >=1.0
  • pymdown-extensions >=10.15

Score: 13.176936786329488