Cropland Abandonment Detection
Detects suspected abandoned cropland from multi-year NDVI time series.
Trigger
Use when the user wants to:
- Screen for abandoned cropland
- Identify fields with consecutive years without cultivation
- Generate field verification priorities
- Monitor cultivation continuity
CLI Usage
# Basic detection
python scripts/cropland_abandonment_detection.py \
--ndvi-stack ndvi_2018_2023.tif
# With cropland mask and custom thresholds
python scripts/cropland_abandonment_detection.py \
--ndvi-stack ndvi_2018_2023.tif \
--cropland-mask cropland.tif \
--ndvi-threshold 0.25 --min-abandoned-years 3
# Specify years
python scripts/cropland_abandonment_detection.py \
--ndvi-stack ndvi_stack.tif \
--years 2018 2019 2020 2021 2022 2023
# Synthetic demo (no real stack/mask needed)
python scripts/cropland_abandonment_detection.py --synthetic --output-dir ./abandonment-output
Parameters
| Parameter | Default | Description |
|---|---|---|
--ndvi-stack |
(required unless --synthetic) |
Multi-year NDVI stack (bands=years) |
--cropland-mask |
None | Cropland mask (1=cropland) |
--years |
auto | Years for each band |
--ndvi-threshold |
0.3 | Min max-NDVI for cultivation |
--min-abandoned-years |
2 | Min consecutive fallow years |
--min-area |
0 | Minimum field area filter |
--output-dir |
./abandonment-output | Output directory |
--synthetic |
false | Run with synthetic demo data (auto-generates NDVI stack + mask) |
Output
| File | Description |
|---|---|
abandonment_status.tif |
3-band raster (abandoned, duration, start_year) |
suspected_fields.geojson |
Vector of abandoned field polygons |
report.html |
HTML summary report |
output-manifest.json |
Machine-readable manifest |
Exit Codes
| Code | Meaning |
|---|---|
| 0 | Success |
| 2 | Argument error |
| 3 | Dependency missing |
| 6 | Data validation failure |
| 7 | Processing failure |
数据下载
本 skill 可自动从 Microsoft Planetary Computer 下载数据 (无需 API key):
python cropland_abandonment_detection.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 时，走原文件路径 (向后兼容)。