rsplot 0.2.7__tar.gz → 0.3.0__tar.gz

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

@@ -280,4 +280,7 @@ tags
 logs/
 .vscode/
 .claude
+docs/
 tests/
+skills/
+tools/

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rsplot
-Version: 0.2.7
+Version: 0.3.0
 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
@@ -227,8 +227,8 @@ Description-Content-Type: text/markdown
 
 # 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
+`rsplot` is an Agent-oriented command-line tool for plotting remote-sensing,
+reconstructed, and air-quality data. It provides a small, stable CLI surface for
 [tianpu-agent](https://git.lug.ustc.edu.cn/yaoyhu/tianpu-agent).
 
 
@@ -282,6 +282,7 @@ hcho = "/path/to/HCHO"
 guokong = "/path/to/guokong_combine"
 era5 = "/path/to/era5"
 forecast = "/path/to/forecast"
+reconstruct = "/path/to/reconstruct"
 
 # Optional satellite basemap key. Leave commented unless you have a real key.
 # [tianditu]
@@ -307,6 +308,7 @@ 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_DATA_DIR_RECONSTRUCT="/path/to/reconstruct"
 export RSPLOT_HCHO_CMAP_FILE="/path/to/256x3_rgb_table.txt"
 ```
 
@@ -334,24 +336,63 @@ 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.
+# Reconstructed-grid input is China standard time; rsplot converts it to the
+# matching UTC archive filename. This reads 2026051100.nc.
+rsplot reconstruct 安徽 2026051108 --var PM2.5 \
+  -o reconstruct_anhui_pm25.png
+
+# Date-only input selects the latest complete hour in that China-time day.
+rsplot reconstruct 合肥 20260511 --var O3 --res 0.01 \
+  -o reconstruct_hefei_o3.png
+
+# Forecast input is China standard time; rsplot converts it
+# to the matching UTC archive initialization hour before reading.
 rsplot forecast 安徽 2026063000 --lead 24 --var O3 -o forecast_anhui_o3.png
 
-# Date-only forecast input automatically selects the latest initialized hour.
+# Date-only input selects the latest initialization within that China-time day.
 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 ERA5 2 m temperature. Input hours are China standard time; rsplot
+# converts them to the matching UTC archive day and hour automatically.
+rsplot meteo 南京 2026051115 --temp-level 2m -o meteo_nanjing_t2m.png
+
+# Plot black 850 hPa wind arrows; length represents speed and no wind
+# colorbar is drawn. The reference arrow gives the speed scale.
+rsplot meteo 南京 2026051115 --wind-level 850 -o meteo_nanjing_wind850.png
+
+# Overlay black wind arrows on a temperature background. Only the temperature
+# colorbar is drawn.
+rsplot meteo 南京 2026051115 --temp-level 850 \
+  --wind-level 850 -o meteo_nanjing_t850_wind850.png
+
+# Overlay station observations with black wind arrows.
+rsplot meteo 南京 2026051115 --station-var O3 \
+  --wind-level 850 -o meteo_nanjing_o3_wind850.png
+
+# Temperature, stations, and wind can be combined. The two colorbars describe
+# temperature and station concentration; wind magnitude is encoded by length.
+rsplot meteo 南京 2026051115 --temp-level 850 --station-var O3 \
+  --wind-level 850 -o meteo_nanjing_t850_o3_wind850.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
+# Plot one station's hourly observations over the latest seven days.
+rsplot trend 3347A 20260520 --days 7 --var O3 -o trend_3347A_o3_7d.png
+
+# A single day and an explicit date range are also supported.
+rsplot trend 3347A 20260520 --days 1 --var O3 -o trend_3347A_o3_day.png
+rsplot trend 3347A 20260501-20260507 --var PM2.5 -o trend_3347A_pm25.png
+
+# Plot all regional stations as grey lines plus the hourly station mean.
+rsplot trend 重庆 20260520 --days 7 --var O3 --region -o trend_chongqing_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
+# Plot only the regional mean and highlight one or more explicit stations.
+rsplot trend 重庆 20260520 --days 7 --var O3 --region --view mean \
+  --focus-station 3347A --threshold 200 -o trend_chongqing_focus.png
 
 # Overlay satellite raster data and station observations.
 rsplot overlay 合肥 2026041415 -p no2 --var NO2 -o overlay_hefei_no2.png
@@ -367,7 +408,9 @@ rsplot fnr 合肥 20260114 --voc-threshold 0.8 --nox-threshold 1.8 --display-max
 ```
 
 When `-o/--output` is provided, `rsplot` writes the image to that path and also
-writes a JSON sidecar with the same base name.
+writes a JSON sidecar with the same base name. Reconstructed-grid JSON records
+both the China-time input and matched UTC archive hour, source file, native and
+output resolution, regional statistics, administrative summaries, and hotspots.
 
 ## License
 

{rsplot-0.2.7 → rsplot-0.3.0}/README.md

@@ -1,7 +1,7 @@
 # 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
+`rsplot` is an Agent-oriented command-line tool for plotting remote-sensing,
+reconstructed, and air-quality data. It provides a small, stable CLI surface for
 [tianpu-agent](https://git.lug.ustc.edu.cn/yaoyhu/tianpu-agent).
 
 
@@ -55,6 +55,7 @@ hcho = "/path/to/HCHO"
 guokong = "/path/to/guokong_combine"
 era5 = "/path/to/era5"
 forecast = "/path/to/forecast"
+reconstruct = "/path/to/reconstruct"
 
 # Optional satellite basemap key. Leave commented unless you have a real key.
 # [tianditu]
@@ -80,6 +81,7 @@ 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_DATA_DIR_RECONSTRUCT="/path/to/reconstruct"
 export RSPLOT_HCHO_CMAP_FILE="/path/to/256x3_rgb_table.txt"
 ```
 
@@ -107,24 +109,63 @@ 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.
+# Reconstructed-grid input is China standard time; rsplot converts it to the
+# matching UTC archive filename. This reads 2026051100.nc.
+rsplot reconstruct 安徽 2026051108 --var PM2.5 \
+  -o reconstruct_anhui_pm25.png
+
+# Date-only input selects the latest complete hour in that China-time day.
+rsplot reconstruct 合肥 20260511 --var O3 --res 0.01 \
+  -o reconstruct_hefei_o3.png
+
+# Forecast input is China standard time; rsplot converts it
+# to the matching UTC archive initialization hour before reading.
 rsplot forecast 安徽 2026063000 --lead 24 --var O3 -o forecast_anhui_o3.png
 
-# Date-only forecast input automatically selects the latest initialized hour.
+# Date-only input selects the latest initialization within that China-time day.
 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 ERA5 2 m temperature. Input hours are China standard time; rsplot
+# converts them to the matching UTC archive day and hour automatically.
+rsplot meteo 南京 2026051115 --temp-level 2m -o meteo_nanjing_t2m.png
+
+# Plot black 850 hPa wind arrows; length represents speed and no wind
+# colorbar is drawn. The reference arrow gives the speed scale.
+rsplot meteo 南京 2026051115 --wind-level 850 -o meteo_nanjing_wind850.png
+
+# Overlay black wind arrows on a temperature background. Only the temperature
+# colorbar is drawn.
+rsplot meteo 南京 2026051115 --temp-level 850 \
+  --wind-level 850 -o meteo_nanjing_t850_wind850.png
+
+# Overlay station observations with black wind arrows.
+rsplot meteo 南京 2026051115 --station-var O3 \
+  --wind-level 850 -o meteo_nanjing_o3_wind850.png
+
+# Temperature, stations, and wind can be combined. The two colorbars describe
+# temperature and station concentration; wind magnitude is encoded by length.
+rsplot meteo 南京 2026051115 --temp-level 850 --station-var O3 \
+  --wind-level 850 -o meteo_nanjing_t850_o3_wind850.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
+# Plot one station's hourly observations over the latest seven days.
+rsplot trend 3347A 20260520 --days 7 --var O3 -o trend_3347A_o3_7d.png
+
+# A single day and an explicit date range are also supported.
+rsplot trend 3347A 20260520 --days 1 --var O3 -o trend_3347A_o3_day.png
+rsplot trend 3347A 20260501-20260507 --var PM2.5 -o trend_3347A_pm25.png
+
+# Plot all regional stations as grey lines plus the hourly station mean.
+rsplot trend 重庆 20260520 --days 7 --var O3 --region -o trend_chongqing_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
+# Plot only the regional mean and highlight one or more explicit stations.
+rsplot trend 重庆 20260520 --days 7 --var O3 --region --view mean \
+  --focus-station 3347A --threshold 200 -o trend_chongqing_focus.png
 
 # Overlay satellite raster data and station observations.
 rsplot overlay 合肥 2026041415 -p no2 --var NO2 -o overlay_hefei_no2.png
@@ -140,7 +181,9 @@ rsplot fnr 合肥 20260114 --voc-threshold 0.8 --nox-threshold 1.8 --display-max
 ```
 
 When `-o/--output` is provided, `rsplot` writes the image to that path and also
-writes a JSON sidecar with the same base name.
+writes a JSON sidecar with the same base name. Reconstructed-grid JSON records
+both the China-time input and matched UTC archive hour, source file, native and
+output resolution, regional statistics, administrative summaries, and hotspots.
 
 ## License
 

{rsplot-0.2.7 → rsplot-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "rsplot"
-version = "0.2.7"
+version = "0.3.0"
 description = "CLI tool for plotting Remote Sensing data, designed for Agent."
 authors = [
     { name = "Yaoyao Hu", email = "yaoyhu@mail.ustc.edu.cn" },
@@ -58,3 +58,9 @@ ignore = ["E501", "RUF001", "RUF002"]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
+
+[dependency-groups]
+dev = [
+    "pytest>=9.1.1",
+    "ruff>=0.15.21",
+]

rsplot-0.3.0/src/rsplot/__init__.py

@@ -0,0 +1,10 @@
+"""rsplot — CLI tool for plotting Remote Sensing data, designed for agent."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("rsplot")
+except PackageNotFoundError:  # pragma: no cover - source tree without install
+    __version__ = "unknown"
+
+__all__ = ["__version__"]