Mine Disturbance Monitor
Monitor surface disturbance at mining sites using multi-temporal optical/SAR/DEM data. Detect bare land, pits, dumps, roads, and vegetation removal. Track disturbance objects across years, identify disturbances outside mine boundaries (compliance concern), and generate area statistics with evidence.
Trigger
Use when the user wants to:
- Monitor mine surface disturbance over multiple years
- Detect bare land / pit / dump / road / vegetation removal expansion
- Identify disturbances outside mine permit boundaries
- Track disturbance object status (new / expanding / stable / reclaimed)
- Generate disturbance area statistics by year and type
CLI Usage
python scripts/mine_disturbance_monitor.py \
--mine-boundary mine_boundary.geojson \
--years 2020 2021 2022 2023 \
--image-dir ./imagery \
--disturbance-types pit dump road bare \
--min-area 100 \
--buffer 500 \
--output-dir ./disturbance-output
Parameters
| Parameter | Required | Default | Description |
|---|---|---|---|
--mine-boundary |
Yes | — | Mine permit boundary (GeoJSON) |
--years |
Yes | — | List of years to analyze |
--image-dir |
Yes | — | Directory with per-year imagery (YYYY.tif) |
--disturbance-types |
No | pit dump road bare | Disturbance types to detect |
--compare-dem |
No | — | Optional DEM for pit/dump classification |
--min-area |
No | 100 | Minimum disturbance area (m²) |
--buffer |
No | 0 | Buffer distance around boundary (m) |
--output-dir |
No | disturbance-output | Output directory |
--version |
No | — | Show version |
Output
| File | Description |
|---|---|
disturbance_by_year.geojson |
All disturbance objects with year, type, area, status |
disturbance_type.tif |
Raster map of disturbance types |
outside_boundary.geojson |
Disturbances outside mine boundary (compliance) |
summary.xlsx |
Area statistics by year and type |
Exit Codes
| Code | Meaning |
|---|---|
| 0 | Success |
| 2 | Argument error |
| 3 | Dependency missing |
| 6 | Validation error |
| 7 | Processing failure |
数据下载
本 skill 可自动从 Microsoft Planetary Computer 下载数据 (无需 API key):
python mine_disturbance_monitor.py --bbox 116,39,117,40 --date-range 2024-06-01,2024-06-30 --output-dir <tmp>
--bbox W,S,E,N: WGS-84 边界框 (西, 南, 东, 北)--date-range START,END: 日期范围 (YYYY-MM-DD,YYYY-MM-DD)--aoi-file <path.geojson>: 替代 --bbox 的 GeoJSON 多边形--cache-dir <path>: 缓存目录 (默认 ~/.geoskill_cache)
当用户只给 --bbox + --date-range (没有 --image) 时，skill 自动下载数据。
当用户给 --image 时，走原文件路径 (向后兼容)。