Extraire les plans d’eau (Outils Image Analyst)

Résumé

Recherche les plans d’eau à l’aide des données SAR (radar à synthèse d’ouverture) en entrée et d’un modèle numérique d’élévation (MNE).

L’outil utilise la rétrodiffusion radar en entrée pour déterminer si les pixels doivent être classés en tant que plans d’eau ; il crée ensuite des polygones pour les plans d’eau. L’outil crée également des polygones pour des zones qui ne sont pas des plans d’eau, qui seront considérées comme des terrains.

Illustration

! Illustration de l’outil Extraire les plans d’eau

Utilisation

Calibrez les données radar en entrée sur gamma zéro à l’aide de l’outil Apply Radiometric Calibration (Appliquer le calibrage radiométrique). Cela optimise la délimitation et la classification, particulièrement dans les scènes radar de grande envergure.
Il se peut que les données radar en entrée ne soient pas alignées sur la classe d’entités en sortie. Si les données radar en entrée ne sont pas orthorectifiées, l’outil transforme la valeur du paramètre Output Feature Class (Classe d’entités en sortie) en fonction du paramètre DEM Raster (Raster MNE). En l’absence de MNE, l’outil exécute une transformation à l’aide d’une surface ellipsoïdale. Pour une transformation optimale de la valeur du paramètre Output Feature Class (Classe d’entités en sortie), indiquez un MNE en entrée pour le paramètre DEM Raster (Raster MNE). Le MNE en entrée doit utiliser le système de coordonnées géographiques WGS84 (EPSG:4326).
Cet outil peut également être utilisé pour créer des polygones d’eau ou de terre à entrer dans d’autres outils SAR, tels que Detect Bright Ocean Objects (Détecter les objets océaniques clairs) et Detect Dark Ocean Areas (Détecter les zones océaniques sombres).

Etiqueter	Explication	Type de données
Données radar en entrée	Données radar en entrée.	Raster Dataset; Raster Layer
Classe d’entités en sortie	Classe d’entités surfaciques en sortie qui décrit les polygones d’eau et de terre.	Feature Class
Superficie minimale (Facultatif)	Superficie minimale à extraire en tant que plan d’eau. La valeur par défaut est 50 000 mètres carrés.	Areal Unit
Raster MNA (Facultatif)	MNE en entrée. Si les données radar en entrée ne sont pas orthorectifiées, ce MNE est utilisé pour orthorectifier le résultat en sortie. Ce MNE permet également d’optimiser la construction de polygones.	Mosaic Layer; Raster Layer
Appliquer une correction géodésique (Facultatif)	Indique si le système de référence verticale du MNE en entrée est transformé en hauteur ellipsoïdale. La plupart des jeux de données d’altitude étant référencés par rapport à la hauteur orthométrique au niveau de la mer, une correction est nécessaire dans ce cas pour effectuer la conversion en hauteur ellipsoïdale. Activé—Une correction de géoïde sera effectuée pour convertir la hauteur orthométrique en hauteur ellipsoïdale (en fonction de la géoïde EGM96). Il s’agit de l’option par défaut. Décoché—Aucune correction de géoïde ne sera effectuée. Utilisez cette option uniquement si le MNE est exprimé en hauteur ellipsoïdale.	Boolean

ExtractWater(in_radar_data, out_feature_class, {min_area}, {in_dem_raster}, {geoid})

Nom	Explication	Type de données
in_radar_data	Données radar en entrée.	Raster Dataset; Raster Layer
out_feature_class	Classe d’entités surfaciques en sortie qui décrit les polygones d’eau et de terre.	Feature Class
min_area (Facultatif)	Superficie minimale à extraire en tant que plan d’eau. La valeur par défaut est 50 000 mètres carrés.	Areal Unit
in_dem_raster (Facultatif)	MNE en entrée. Si les données radar en entrée ne sont pas orthorectifiées, ce MNE est utilisé pour orthorectifier le résultat en sortie. Ce MNE permet également d’optimiser la construction de polygones.	Mosaic Layer; Raster Layer
geoid (Facultatif)	Indique si le système de référence verticale du MNE en entrée est transformé en hauteur ellipsoïdale. La plupart des jeux de données d’altitude étant référencés par rapport à la hauteur orthométrique au niveau de la mer, une correction est nécessaire dans ce cas pour effectuer la conversion en hauteur ellipsoïdale. `GEOID`—Une correction de géoïde sera effectuée pour convertir la hauteur orthométrique en hauteur ellipsoïdale (en fonction de la géoïde EGM96). Il s’agit de l’option par défaut. `NONE`—Aucune correction de géoïde ne sera effectuée. Utilisez cette option uniquement si le MNE est exprimé en hauteur ellipsoïdale.	Boolean

Exemple de code

Exemple 1 d’utilisation de la fonction ExtractWater (fenêtre Python)

Cet exemple extrait les polygones d’eau supérieurs à 1 kilomètre carré.

import arcpy
arcpy.env.workspace = r"C:\Data\SAR"

arcpy.ia.ExtractWater("LowNoise_manifest_CalG0_TNR.crf",
    "LowNoise_manifest_CalG0_TNR_Water.shp", "1 SquareKilometer",
    "dem_COP30_ortho.tif", "GEOID")

Exemple 2 d’utilisation de la fonction ExtractWater (script autonome)

Cet exemple extrait les polygones d’eau supérieurs à 1 kilomètre carré.

# Import system modules
import arcpy
from arcpy.ia import *

# Set local variables
in_radar=r"C:\SAR\Low Noise_manifest_CalG0_TNR.crf"
out_radar=r"C:\SAR\Low Noise_manifest_CalG0_TNR_Water.shp"
min_area="1 SquareKilometer"
in_dem_raster=r"C:\DEM\dem_COP30_ortho.tif"
geoid="GEOID"

# Run
arcpy.ia.ExtractWater(in_radar, out_radar, min_area, in_dem_raster, geoid)

Environnements

Compression, Espace de travail courant, NoData, Mot-clé CONFIG en sortie, Facteur de traitement parallèle, Pyramide, Statistiques raster, Méthode de rééchantillonnage, Espace de travail temporaire, Raster de capture, Taille de tuile

Informations de licence

Basic: Requiert Image Analyst
Standard: Requiert Image Analyst
Advanced: Requiert Image Analyst