数据分析

Geoskill: Aquaculture Pond Mapping

试用

Identify and monitor aquaculture ponds from multi-temporal remote sensing. Detects coastal and inland ponds, computes area statistics, tracks expansion/abandonment, and analyzes conversion with wetlands/cropland. Use when mapping aquaculture distribution, monitoring pond dynamics, assessing environmental impacts, or generating pond inventories.

它能做什么

Identify and monitor aquaculture ponds from multi-temporal remote sensing. Detects coastal and inland ponds, computes area statistics, tracks expansion/abandonment, and analyzes conversion with wetlands/cropland. Use when mapping aquaculture distribution, monitoring pond dynamics, assessing environmental impacts, or generating pond inventories.

技能文档

Aquaculture Pond Mapping

Identifies coastal and inland aquaculture ponds from multi-temporal satellite imagery. Separates aquaculture ponds from natural water bodies and paddy fields using shape, texture, water frequency, and adjacency features. Outputs pond locations, aquaculture zones, change detection, and area statistics.

Trigger

Use when the user wants to:

  • Map aquaculture pond distribution from satellite imagery
  • Monitor pond expansion or abandonment over time
  • Detect conversion between aquaculture and wetlands/cropland
  • Generate pond inventories for fisheries management
  • Assess environmental impacts of aquaculture development
  • Identify illegal pond construction in protected areas

CLI Usage

# Basic analysis with default parameters (rules method, single year)
python scripts/aquaculture_pond_mapping.py --output-dir ./apm-output

# Multi-year analysis with custom minimum area
python scripts/aquaculture_pond_mapping.py \
  --years 2020 2021 2022 2023 \
  --min-area 1000 \
  --output-dir ./apm-output

# ML-based classification (requires training data)
python scripts/aquaculture_pond_mapping.py \
  --method ml \
  --training-data ./training_samples.geojson \
  --output-dir ./apm-output

# With custom input NDWI stack
python scripts/aquaculture_pond_mapping.py \
  --input-ndwi ./ndwi_stack.tif \
  --years 2020 2021 2022 \
  --output-dir ./apm-output

Parameters

ParameterDefaultDescription
--input-ndwiNoneInput NDWI time series GeoTIFF (multi-band, optional)
--methodrulesClassification method: rules, ml
--years[2023]Years for analysis (space-separated)
--min-area500.0Minimum pond area in m² (default: 500)
--output-dir./apm-outputOutput directory

Output

FileDescription
ponds.geojsonPoint features for detected aquaculture ponds with confidence
aquaculture_zones.geojsonPoint features for aquaculture cluster zones
change.geojsonPoint features showing new/abandoned/stable ponds
area_by_admin.csvArea statistics per classification class
accuracy.jsonClassification summary and confidence metrics
request.jsonAnalysis request metadata
dataset-manifest.jsonInput data and parameters manifest
output-manifest.jsonOutput file inventory and area statistics
qa.jsonQuality assurance checks

Classification Classes

CodeNameDescription
1aquaculture_pondManaged aquaculture pond (rectangular, embanked, clustered)
2natural_waterNatural water body (irregular shape, permanent, no embankments)
3paddy_fieldRice paddy (small, rectangular, seasonal flooding)
0non_waterNon-water or below minimum area

Change Detection Codes

CodeNameDescription
1new_pondPond present in latest period but not baseline
-1abandoned_pondPond present in baseline but not latest
0stable_pondPond present in both periods

Key Algorithms

Two-Step Classification

  1. Water Extraction: NDWI/MNDWI thresholding to identify water candidates
  2. Pond Classification: Rule-based scoring using shape, texture, water frequency, and adjacency features to separate aquaculture from natural water

Shape Features

  • Rectangularity: area / bounding box area (ponds are rectangular)
  • Compactness: 4π·area / perimeter² (moderate for ponds)
  • Aspect Ratio: elongation (ponds have moderate ratios)

Texture Features (Embankment Detection)

  • Local variance and edge density detect embankments (堤埂) around ponds
  • Higher texture scores indicate human-constructed boundaries

Water Frequency

  • Seasonal water (intermediate frequency) suggests managed aquaculture
  • Permanent water suggests natural lakes/rivers

Adjacency Features

  • Clustered ponds indicate aquaculture areas
  • Isolated water bodies more likely natural

Change Detection

  • Compares pond masks between baseline and latest periods
  • Identifies new, abandoned, and stable ponds

Exit Codes

CodeMeaning
0Success
2Argument error
3Dependency missing
6Data validation failure
7Processing failure

Limitations

  • Paddy fields and salt pans may be confused with aquaculture ponds
  • Very small ponds (< 2 pixels) may be missed
  • Seasonal drying can cause false negatives in single-date imagery
  • Cloud cover affects optical remote sensing accuracy
  • Ground truth data recommended for accuracy assessment
  • ML method requires representative training samples

References

  • McFeeters 1996 - NDWI for open water delineation
  • Xu 2006 - MNDWI for enhanced water detection
  • Two-step water-then-pond classification approach

数据下载

本 skill 可自动从 Microsoft Planetary Computer 下载数据 (无需 API key):

python aquaculture_pond_mapping.py --bbox 116,39,117,40 --date-range 2024-06-01,2024-06-30 --output-dir 
  • --bbox W,S,E,N: WGS-84 边界框 (西, 南, 东, 北)
  • --date-range START,END: 日期范围 (YYYY-MM-DD,YYYY-MM-DD)
  • --aoi-file : 替代 --bbox 的 GeoJSON 多边形
  • --cache-dir : 缓存目录 (默认 ~/.geoskill_cache)

当用户只给 --bbox + --date-range (没有 --image) 时,skill 自动下载数据。 当用户给 --image 时,走原文件路径 (向后兼容)。

相关技能

Monitor wetland extent, inundation frequency, and land cover transitions to identify degradation, recovery, and human encroachment. Use when the user wants to track wetland changes over time, assess wetland health, or detect conversion of wetlands to other land covers.

1 次安装

Identify major crop types from multi-temporal optical/SAR imagery using phenological features. Produces pixel/field-level classification, area statistics, and confidence maps. Use when mapping crop distributions, estimating planted areas, or generating agricultural intelligence from remote sensing data.

1 次安装

Detect and classify cropland changes from before/after NDVI rasters. Identifies suspected construction, water, forest, and bare soil changes and generates compliance investigation materials. Use when the user wants to check farmland for unauthorized changes, monitor cropland conversion, or generate compliance reports.

1 次安装

Monitor construction progress from multi-temporal satellite imagery. Classifies project stages (clearing, earthwork, foundation, structure, finishing, completed) using spectral indices and detects stagnation. Use when tracking infrastructure projects, auditing construction timelines, or generating progress reports from remote sensing data.

1 次安装

Multi-temporal shoreline change rate analysis. Generates transects, computes Endpoint Rate (EPR) and Linear Regression Rate (LRR), and identifies erosion hotspots. Use when monitoring coastline retreat/accretion or identifying erosion-prone segments.

1 次安装

Multi-year cropland abandonment detection using NDVI time series. Identifies suspected abandoned cropland based on consecutive years without cultivation signals. Use when screening for abandoned fields, generating field verification lists, or monitoring cultivation continuity.

1 次安装