rsplot 0.2.5__tar.gz → 0.2.7__tar.gz

{rsplot-0.2.5 → rsplot-0.2.7}/.gitignore

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

{rsplot-0.2.5 → rsplot-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rsplot
-Version: 0.2.5
+Version: 0.2.7
 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
@@ -280,6 +280,8 @@ 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]
@@ -303,6 +305,8 @@ 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"
 ```
 
@@ -330,9 +334,25 @@ 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
+
+# Overlay station observations on the forecast valid time.
+rsplot forecast 合肥 2026041409 --lead 6 --var O3 --station-overlay -o forecast_station_hefei_o3.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.5 → rsplot-0.2.7}/README.md

@@ -53,6 +53,8 @@ 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]
@@ -76,6 +78,8 @@ 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"
 ```
 
@@ -103,9 +107,25 @@ 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
+
+# Overlay station observations on the forecast valid time.
+rsplot forecast 合肥 2026041409 --lead 6 --var O3 --station-overlay -o forecast_station_hefei_o3.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.5 → rsplot-0.2.7}/pyproject.toml

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