rsplot 0.1.0__tar.gz → 0.2.0__tar.gz

{rsplot-0.1.0 → rsplot-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rsplot
-Version: 0.1.0
+Version: 0.2.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,26 +227,77 @@ Description-Content-Type: text/markdown
 
 # rsplot
 
-rsplot is a CLI tool for plotting Remote Sensing data, designed for [TianPu Agent](https://git.lug.ustc.edu.cn/yaoyhu/tianpu-agent).
+`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).
 
-Now in early development stage, stay tuned for updates!
 
-# Quick Start
+## 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 git@git.lug.ustc.edu.cn:yaoyhu/rsplot.git
+git clone https://github.com/yaoyhu/rsplot.git
 cd rsplot
 uv sync
+uv run rsplot --help
 ```
 
+## Configuration
+
+For satellite basemaps, set a TianDiTu API key:
+
 ```bash
-uv run rsplot --help
-uv run rsplot raster --help
-uv run rsplot station --help
+export TIANDITU_API_KEY="your-key"
 ```
 
-# TODO
-- [x] Support raster plotting
-- [x] Support station plotting
-- [ ] Upload to PyPI
-- [ ] ...
+## Usage
+
+The examples below assume the command is running on a USTC server or in an
+environment with equivalent data paths configured.
+
+```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 an explicit TROPOMI date range.
+rsplot raster 长三角 20260101-20260131 -p no2 -o no2_yrd_202601.png
+
+# Plot national monitoring station observations.
+rsplot station 合肥 2026041415 --var O3 -o station_hefei_o3.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
+```
+
+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.0/README.md

@@ -0,0 +1,76 @@
+# 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
+
+For satellite basemaps, set a TianDiTu API key:
+
+```bash
+export TIANDITU_API_KEY="your-key"
+```
+
+## Usage
+
+The examples below assume the command is running on a USTC server or in an
+environment with equivalent data paths configured.
+
+```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 an explicit TROPOMI date range.
+rsplot raster 长三角 20260101-20260131 -p no2 -o no2_yrd_202601.png
+
+# Plot national monitoring station observations.
+rsplot station 合肥 2026041415 --var O3 -o station_hefei_o3.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
+```
+
+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.1.0 → rsplot-0.2.0}/pyproject.toml

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

rsplot-0.1.0/README.md

@@ -1,25 +0,0 @@
-# rsplot
-
-rsplot is a CLI tool for plotting Remote Sensing data, designed for [TianPu Agent](https://git.lug.ustc.edu.cn/yaoyhu/tianpu-agent).
-
-Now in early development stage, stay tuned for updates!
-
-# Quick Start
-
-```bash
-git clone git@git.lug.ustc.edu.cn:yaoyhu/rsplot.git
-cd rsplot
-uv sync
-```
-
-```bash
-uv run rsplot --help
-uv run rsplot raster --help
-uv run rsplot station --help
-```
-
-# TODO
-- [x] Support raster plotting
-- [x] Support station plotting
-- [ ] Upload to PyPI
-- [ ] ...