Metadata-Version: 2.4
Name: cmaq-tools
Version: 0.1.0
Summary: A Python library for extracting and processing air quality model data from AELMO NetCDF files
Project-URL: Homepage, https://github.com/zusiven/cmaq_tools
Project-URL: Repository, https://github.com/zusiven/cmaq_tools.git
Project-URL: Documentation, https://github.com/zusiven/cmaq_tools
Author: CMAQ Tools Team
License-File: LICENSE
Keywords: aelmo,air-quality,atmospheric-modeling,data-extraction,netcdf
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
Requires-Python: >=3.11
Requires-Dist: netcdf4
Requires-Dist: polars>=1.37.1
Requires-Dist: pyproj
Requires-Dist: wztools>=2026.1.6
Requires-Dist: xarray>=2025.4.0
Provides-Extra: dev
Requires-Dist: jupyter>=1.0.0; extra == 'dev'
Requires-Dist: matplotlib>=3.5.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: twine>=6.2.0; extra == 'dev'
Provides-Extra: examples
Requires-Dist: jupyter>=1.0.0; extra == 'examples'
Requires-Dist: matplotlib>=3.5.0; extra == 'examples'
Description-Content-Type: text/markdown

# CMAQ Tools

一个用于从 AELMO NetCDF 文件中提取和处理空气质量模型数据的 Python 库。

## 安装

```bash
pip install git+https://github.com/zusiven/cmaq_tools.git
```

## 使用方法

```python
from cmaq_tools import AelmoExtractor
from pathlib import Path

# 初始化提取器
extractor = AelmoExtractor(
    aelmo_path=Path("path/to/CCTM_AELMO_d01.nc"),
    cro2d_path=Path("path/to/GRIDCRO2D_d01.nc")
)

# 提取所有数据
df = extractor.extract_data()
print(df)

# 根据经纬度提取特定位置的数据
df_point = extractor.extract_data_by_lonlat(lon=114.0, lat=38.0)
print(df_point)
```

## 支持的污染物

- O3 (臭氧)
- PM2.5 (细颗粒物)
- PM10 (可吸入颗粒物)
- NO2 (二氧化氮)
- CO (一氧化碳)
- NO (一氧化氮)
- SO2 (二氧化硫)

## 依赖

- polars
- xarray
- netcdf4
- pyproj
- wztools
