Metadata-Version: 2.4
Name: cedarkit
Version: 2026.7.0
Summary: A toolkit for meteorological data processing and visualization at CEMC/CMA.
Author-email: Wang Dapeng <perillaroc@gmail.com>
License: Apache-2.0
Project-URL: Homepage, https://github.com/cemc-oper/cedarkit
Project-URL: Repository, https://github.com/cemc-oper/cedarkit.git
Keywords: meteorology,data,graphic,cemc,cedarkit
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: reki~=2026.7
Requires-Dist: cedarkit-comp~=2026.7
Requires-Dist: cedarkit-plots~=2026.7
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Dynamic: license-file

# cedarkit

![Maturity-Sandbox](https://img.shields.io/badge/Maturity-Sandbox-F9D71C)

`cedarkit` is the **meta package** of the cedarkit tool suite: it contains no
code itself, but aggregates the component packages of the suite through its
dependencies, so a single installation provides the complete data processing
and visualization toolchain.

The design follows ECMWF's [earthkit](https://github.com/ecmwf/earthkit) meta
package: this distribution ships no Python modules
(`[tool.setuptools] packages = []`). The `cedarkit` namespace is provided by
the component packages (`cedarkit-comp`, `cedarkit-plots`) as PEP 420
namespace packages.

## Components

| Package | Namespace | Description |
| --- | --- | --- |
| [reki](https://github.com/cemc-oper/reki) | `reki` | Data access and preparation (GRIB2/GrADS/NetCDF/CMADaaS), local file finding on CMA-HPC |
| [cedarkit-comp](https://github.com/cemc-oper/cedarkit-comp) | `cedarkit.comp` | Meteorological computation utilities (smoothing, grid calculations, ...) |
| [cedarkit-plots](https://github.com/cemc-oper/cedarkit-plots) | `cedarkit.plots` | Plotting primitives: Panel, Chart, map domains, styles, colormaps |

## Installation

```bash
pip install cedarkit
```

## Usage

```python
import reki
from cedarkit.comp.smooth import smth9
from cedarkit.plots.chart import Panel
```

## Development

In this monorepo, the component packages are referenced as local editable
paths via `[tool.uv.sources]`:

```bash
uv pip install -e ".[test]"
pytest
```

The version is generated from git tags by `setuptools_scm` and written to
`cedarkit/_version.py` at build time (used for build-time version stamping
only; not shipped with the package).

## LICENSE

Apache License 2.0
