rsplot 0.2.4__tar.gz → 0.2.6__tar.gz

{rsplot-0.2.4 → rsplot-0.2.6}/.gitignore

@@ -280,3 +280,4 @@ tags
 logs/
 .vscode/
 .claude
+tests/

{rsplot-0.2.4 → rsplot-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rsplot
-Version: 0.2.4
+Version: 0.2.6
 Summary: CLI tool for plotting Remote Sensing data, designed for Agent.
 Project-URL: Repository, https://git.lug.ustc.edu.cn/yaoyhu/rsplot
 Project-URL: GitHub, https://github.com/yaoyhu/rsplot
@@ -258,16 +258,65 @@ uv run rsplot --help
 
 ## Configuration
 
-For satellite basemaps, set a TianDiTu API key:
+`rsplot` does not ship site-specific data paths. Configure local satellite,
+station, boundary, and font paths with a TOML file:
+
+```bash
+mkdir -p ~/.config/rsplot
+cp config.example.toml ~/.config/rsplot/config.toml
+```
+
+Then edit `~/.config/rsplot/config.toml`:
+
+```toml
+[paths]
+geojson_dir = "/path/to/geojson"
+font_dir = "/path/to/fonts"
+# hcho_cmap_file = "/path/to/256x3_rgb_table.txt"
+
+[paths.data_dirs]
+no2 = "/path/to/NO2"
+o3 = "/path/to/O3"
+o3pr = "/path/to/O3PR"
+hcho = "/path/to/HCHO"
+guokong = "/path/to/guokong_combine"
+era5 = "/path/to/era5"
+forecast = "/path/to/forecast"
+
+# Optional satellite basemap key. Leave commented unless you have a real key.
+# [tianditu]
+# api_key = "your-real-key"
+```
+
+You can also point to a different config file:
+
+```bash
+export RSPLOT_CONFIG="/path/to/rsplot.toml"
+```
+
+Environment variables override TOML values:
 
 ```bash
 export TIANDITU_API_KEY="your-key"
+export RSPLOT_GEOJSON_DIR="/path/to/geojson"
+export RSPLOT_FONT_DIR="/path/to/fonts"
+export RSPLOT_DATA_DIR_NO2="/path/to/NO2"
+export RSPLOT_DATA_DIR_O3="/path/to/O3"
+export RSPLOT_DATA_DIR_O3PR="/path/to/O3PR"
+export RSPLOT_DATA_DIR_HCHO="/path/to/HCHO"
+export RSPLOT_DATA_DIR_GUOKONG="/path/to/guokong_combine"
+export RSPLOT_DATA_DIR_ERA5="/path/to/era5"
+export RSPLOT_DATA_DIR_FORECAST="/path/to/forecast"
+export RSPLOT_HCHO_CMAP_FILE="/path/to/256x3_rgb_table.txt"
 ```
 
+Command-line directory options, such as `--data-dir`, take precedence for the
+command being run. If no TianDiTu API key is configured, use `--basemap none`
+to avoid requesting satellite tiles.
+
 ## Usage
 
-The examples below assume the command is running on a USTC server or in an
-environment with equivalent data paths configured.
+The examples below assume data paths are configured and readable.
 
 ```bash
 # Show available commands and options.
@@ -285,9 +334,22 @@ rsplot raster 安徽 20260227 -p o3pr -o o3pr_anhui_20260227.png
 # Plot an explicit TROPOMI date range.
 rsplot raster 长三角 20260101-20260131 -p no2 -o no2_yrd_202601.png
 
+# Plot gridded air-quality forecast initialized at a specific hour.
+rsplot forecast 安徽 2026063000 --lead 24 --var O3 -o forecast_anhui_o3.png
+
+# Date-only forecast input automatically selects the latest initialized hour.
+rsplot forecast 合肥 20260630 --lead 72 --var PM2.5 -o forecast_hefei_pm25.png
+
 # Plot national monitoring station observations.
 rsplot station 合肥 2026041415 --var O3 -o station_hefei_o3.png
 
+# Overlay hourly ERA5 10 m wind vectors on station observations.
+# Station timestamps default to Asia/Shanghai and are matched to ERA5 UTC.
+rsplot station 合肥 2026041415 --var O3 --wind-level 10m -o station_wind_hefei_o3.png
+
+# Pressure-level wind is also supported (1000/925/850/700/500 hPa).
+rsplot station 安徽 2026041415 --var PM2.5 --wind-level 850 -o station_wind_anhui_pm25.png
+
 # Overlay satellite raster data and station observations.
 rsplot overlay 合肥 2026041415 -p no2 --var NO2 -o overlay_hefei_no2.png
 

rsplot-0.2.6/README.md

@@ -0,0 +1,144 @@
+# rsplot
+
+`rsplot` is an Agent-oriented command-line tool for plotting remote-sensing and
+air-quality data. It is designed to provide a small, stable CLI surface for
+[tianpu-agent](https://git.lug.ustc.edu.cn/yaoyhu/tianpu-agent).
+
+
+## Installation
+
+Run directly with `uvx`:
+
+```bash
+uvx rsplot --help
+```
+
+Or install it in a project environment:
+
+```bash
+uv add rsplot
+uv run rsplot --help
+```
+
+For local development:
+
+```bash
+git clone https://github.com/yaoyhu/rsplot.git
+cd rsplot
+uv sync
+uv run rsplot --help
+```
+
+## Configuration
+
+`rsplot` does not ship site-specific data paths. Configure local satellite,
+station, boundary, and font paths with a TOML file:
+
+```bash
+mkdir -p ~/.config/rsplot
+cp config.example.toml ~/.config/rsplot/config.toml
+```
+
+Then edit `~/.config/rsplot/config.toml`:
+
+```toml
+[paths]
+geojson_dir = "/path/to/geojson"
+font_dir = "/path/to/fonts"
+# hcho_cmap_file = "/path/to/256x3_rgb_table.txt"
+
+[paths.data_dirs]
+no2 = "/path/to/NO2"
+o3 = "/path/to/O3"
+o3pr = "/path/to/O3PR"
+hcho = "/path/to/HCHO"
+guokong = "/path/to/guokong_combine"
+era5 = "/path/to/era5"
+forecast = "/path/to/forecast"
+
+# Optional satellite basemap key. Leave commented unless you have a real key.
+# [tianditu]
+# api_key = "your-real-key"
+```
+
+You can also point to a different config file:
+
+```bash
+export RSPLOT_CONFIG="/path/to/rsplot.toml"
+```
+
+Environment variables override TOML values:
+
+```bash
+export TIANDITU_API_KEY="your-key"
+export RSPLOT_GEOJSON_DIR="/path/to/geojson"
+export RSPLOT_FONT_DIR="/path/to/fonts"
+export RSPLOT_DATA_DIR_NO2="/path/to/NO2"
+export RSPLOT_DATA_DIR_O3="/path/to/O3"
+export RSPLOT_DATA_DIR_O3PR="/path/to/O3PR"
+export RSPLOT_DATA_DIR_HCHO="/path/to/HCHO"
+export RSPLOT_DATA_DIR_GUOKONG="/path/to/guokong_combine"
+export RSPLOT_DATA_DIR_ERA5="/path/to/era5"
+export RSPLOT_DATA_DIR_FORECAST="/path/to/forecast"
+export RSPLOT_HCHO_CMAP_FILE="/path/to/256x3_rgb_table.txt"
+```
+
+Command-line directory options, such as `--data-dir`, take precedence for the
+command being run. If no TianDiTu API key is configured, use `--basemap none`
+to avoid requesting satellite tiles.
+
+## Usage
+
+The examples below assume data paths are configured and readable.
+
+```bash
+# Show available commands and options.
+rsplot --help
+
+# Plot a single-day TROPOMI raster.
+rsplot raster 合肥 20260115 -p no2 -o ./logs/hcho/raster_city_jiujiang_hcho.png
+
+# Plot a 30-day TROPOMI window mean.
+rsplot raster 安徽 20260131 -p hcho --days 30 -o hcho_anhui_202601.png
+
+# Plot a TROPOMI ozone-profile tropospheric column raster.
+rsplot raster 安徽 20260227 -p o3pr -o o3pr_anhui_20260227.png
+
+# Plot an explicit TROPOMI date range.
+rsplot raster 长三角 20260101-20260131 -p no2 -o no2_yrd_202601.png
+
+# Plot gridded air-quality forecast initialized at a specific hour.
+rsplot forecast 安徽 2026063000 --lead 24 --var O3 -o forecast_anhui_o3.png
+
+# Date-only forecast input automatically selects the latest initialized hour.
+rsplot forecast 合肥 20260630 --lead 72 --var PM2.5 -o forecast_hefei_pm25.png
+
+# Plot national monitoring station observations.
+rsplot station 合肥 2026041415 --var O3 -o station_hefei_o3.png
+
+# Overlay hourly ERA5 10 m wind vectors on station observations.
+# Station timestamps default to Asia/Shanghai and are matched to ERA5 UTC.
+rsplot station 合肥 2026041415 --var O3 --wind-level 10m -o station_wind_hefei_o3.png
+
+# Pressure-level wind is also supported (1000/925/850/700/500 hPa).
+rsplot station 安徽 2026041415 --var PM2.5 --wind-level 850 -o station_wind_anhui_pm25.png
+
+# Overlay satellite raster data and station observations.
+rsplot overlay 合肥 2026041415 -p no2 --var NO2 -o overlay_hefei_no2.png
+
+# Plot an FNR regime map with the default 7-day window.
+rsplot fnr 合肥 20260114 -o fnr_hefei.png
+
+# Plot an FNR regime map with an explicit date range.
+rsplot fnr 长三角 20260101-20260130 -o fnr_yrd_202601.png
+
+# Override FNR regime thresholds for agent-driven sensitivity tests.
+rsplot fnr 合肥 20260114 --voc-threshold 0.8 --nox-threshold 1.8 --display-max 5 -o fnr_hefei_sensitivity.png
+```
+
+When `-o/--output` is provided, `rsplot` writes the image to that path and also
+writes a JSON sidecar with the same base name.
+
+## License
+
+This project is distributed under the license in `LICENSE`.

{rsplot-0.2.4 → rsplot-0.2.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "rsplot"
-version = "0.2.4"
+version = "0.2.6"
 description = "CLI tool for plotting Remote Sensing data, designed for Agent."
 authors = [
     { name = "Yaoyao Hu", email = "yaoyhu@mail.ustc.edu.cn" },