Détecter les zones océaniques sombres (Outils Image Analyst)

Résumé

Identifie les pixels sombres potentiels représentant des marées noires ou des algues et agrège ces pixels tout en masquant les données SAR en dehors de la région d’intérêt.

L’outil filtre les agrégats à l’aide du paramètre Minimum Area (Superficie minimale) et génère le résultat sous la forme d’un raster binaire. La valeur 1 correspond aux zones sombres détectées et est symbolisée dans une couleur aléatoire. La valeur 0 indique qu’aucune zone sombre n’a été détectée et est symbolisée par une transparence totale.

Les données radar, qu’elles soient orthorectifiées ou non, constituent des entrées valides. Les données radar non orthorectifiées permettent d’obtenir un filtrage amélioré des artefacts azimutaux car les données sont exprimées en coordonnées radar.

Utilisation

Optimisez la détection des zones en calibrant 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 est particulièrement efficace dans les scènes radar plus grandes.
Pour détecter uniquement les zones océaniques, spécifiez une valeur pour le paramètre Mask Features (Entités de masque) et utilisez le paramètre Feature Type (Type d’entité) pour indiquer si le masque s’applique aux étendues d’eau ou de terre. Vous pouvez également spécifier une valeur pour le paramètre DEM Raster (Raster MNE). Ainsi, l’outil utilisera l’élévation pour déterminer les pixels d’étendues d’eau et de terre. Il est possible d’utiliser l’une ou l’autre de ces méthodes pour créer un masque terrestre.

Si des valeurs sont indiquées pour le paramètre Mask Features (Entités de masque) et pour le paramètre DEM Raster (Raster MNE), le paramètre Mask Features (Entités de masque) est utilisé pour créer le masque.

Des masques d’étendue d’eau et de terre pour les zones océaniques sombres sont représentés.

Etiqueter	Explication	Type de données
Données radar en entrée	Données radar en entrée.	Raster Dataset; Raster Layer
Raster en sortie	Raster binaire en sortie contenant les zones océaniques sombres détectées. La valeur 1 correspond à une zone sombre détectée.	Raster Dataset
Superficie minimale (Facultatif)	Surface minimale qui doit être détectée. La taille ne peut pas être négative. La valeur par défaut est de 10 000 mètres carrés.	Areal Unit
Entités de masque (Facultatif)	Entité surfacique de terre ou d’eau. Ce polygone est utilisé pour créer un masque.	Feature Layer
Type d’entités (Facultatif)	Spécifie le type de polygone représenté par la valeur du paramètre Mask Features (Entités de masque). Ce paramètre est requis si la valeur du paramètre Mask Features (Entités de masque) est spécifiée. Polygone de terre—L’entrée de masque correspond à un polygone de terre. Un masque inversé est créé à l’aide de cette entrée. Polygone d’eau—L’entrée de masque correspond à un polygone d’eau. Un masque est créé à l’aide de cette entrée.	String
Raster MNA (Facultatif)	MNE en entrée. Si la valeur du paramètre Mask Features (Entités de masque) est spécifiée, ce MNE est utilisé pour la projeter en coordonnées radar. Si la valeur du paramètre Mask Features (Entités de masque) n’est pas spécifiée, ce MNE est également utilisé pour créer un masque d’étendue de terre.	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
Tolérance du masque (Facultatif)	Distance de la zone tampon autour du masque créé à partir du paramètre Mask Features (Entités de masque) ou DEM Raster (Raster MNE). Cette distance ne peut pas être négative. La valeur par défaut est 100 mètres.	Linear Unit

DetectDarkOceanAreas(in_radar_data, out_raster, {min_area}, {mask_features}, {feature_type}, {in_dem_raster}, {geoid}, {mask_tolerance})

Nom	Explication	Type de données
in_radar_data	Données radar en entrée.	Raster Dataset; Raster Layer
out_raster	Raster binaire en sortie contenant les zones océaniques sombres détectées. La valeur 1 correspond à une zone sombre détectée.	Raster Dataset
min_area (Facultatif)	Surface minimale qui doit être détectée. La taille ne peut pas être négative. La valeur par défaut est de 10 000 mètres carrés.	Areal Unit
mask_features (Facultatif)	Entité surfacique de terre ou d’eau. Ce polygone est utilisé pour créer un masque.	Feature Layer
feature_type (Facultatif)	Spécifie le type de polygone représenté par la valeur du paramètre `mask_features`. Ce paramètre est requis si la valeur du paramètre `mask_features` est spécifiée. `LAND`—L’entrée de masque correspond à un polygone de terre. Un masque inversé est créé à l’aide de cette entrée. `WATER`—L’entrée de masque correspond à un polygone d’eau. Un masque est créé à l’aide de cette entrée.	String
in_dem_raster (Facultatif)	MNE en entrée. Si la valeur du paramètre `mask_features` est spécifiée, ce MNE est utilisé pour la projeter en coordonnées radar. Si la valeur du paramètre `mask_features` n’est pas spécifiée, ce MNE est également utilisé pour créer un masque d’étendue de terre.	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
mask_tolerance (Facultatif)	Distance de la zone tampon autour du masque créé à partir du paramètre `mask_features` ou `in_dem_raster`. Cette distance ne peut pas être négative. La valeur par défaut est 100 mètres.	Linear Unit

Exemple de code

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

Cet exemple détecte les zones océaniques sombres à l’aide d’un masque des étendues de terre.

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

out = arcpy.ia.DetectDarkOceanAreas(
    "IW_manifest_CalG0", "20 SquareKilometers", "land_polygons",
    "LAND", "dem_COP30_ortho.tif", "GEOID", "100 Meters")
out.save("IW_manifest_CalG0_Dspk_DDOA.crf")

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

Cet exemple détecte les zones océaniques sombres à l’aide d’un masque des étendues de terre.

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

# Set local variables
arcpy.env.workspace = r"C:\Data\SAR"
in_radar_data="IW_manifest_CalG0"
out_raster="IW_manifest_CalG0_DDOA.crf"
min_area="20 SquareKilometers"
mask_features= "land_polygons"
feature_type="LAND"
in_dem_raster="dem_COP30_ortho.tif"
geoid="GEOID"
mask_tolerance="100 Meters"

# Run
out = arcpy.ia.DetectDarkOceanAreas(
    in_radar_data, out_raster, min_area, mask_features, feature_type,
    in_dem_raster, geoid, mask_tolerance)
out.save(out_raster)

Environnements

Compression, Espace de travail courant, NoData, Facteur de traitement parallèle, Pyramide, Statistiques raster, Méthode de rééchantillonnage, Espace de travail temporaire, Taille de tuile

Informations de licence