Détecter les objets océaniques clairs (Outils Image Analyst)

Résumé

Détecte les objets clairs potentiels fabriqués par l’homme, tels que les navires, plateformes pétrolières et éoliennes, tout en masquant les données SAR en dehors de la région d’intérêt.

L’outil agrège les pixels, filtre les agrégats selon les paramètres de largeurs minimale et maximale, et génère en sortie les résultats dans une classe d’entités. La classe d’entités en sortie peut être spécifiée sous la forme d’une emprise ou d’un périmètre autour du polygone pour les objets détectés.

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). Ceci optimise la détection des objets, 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).
Pour détecter uniquement les objets situés dans l’océan, 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.

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 en sortie des objets océaniques clairs détectés.	Feature Class
Type en sortie (Facultatif)	Spécifie le type de limite à utiliser pour la classe d’entités en sortie. Emprise—L’emprise minimale de l’objet détecté est utilisée. Il s’agit de l’option par défaut. Périmètre—Un contour du périmètre de l’objet détecté est utilisé.	String
Largeur d’objet minimale (Facultatif)	Largeur minimale d’un objet à détecter. La largeur doit être positive. La valeur par défaut est de 10 mètres.	Linear Unit
Largeur d’objet maximale (Facultatif)	Largeur maximale d’un objet à détecter. La largeur doit être positive. La valeur par défaut est 100 mètres.	Linear Unit
Longueur d’objet minimale (Facultatif)	Longueur minimale d’un objet à détecter. La longueur doit être positive. La valeur par défaut est 50 mètres.	Linear Unit
Longueur d’objet maximale (Facultatif)	Longueur maximale d’un objet à détecter. La longueur doit être positive. La valeur par défaut est de 500 mètres.	Linear 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 MNE (Facultatif)	DEM 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. 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

DetectBrightOceanObjects(in_radar_data, out_feature_class, {out_type}, {min_object_width}, {max_object_width}, {min_object_length}, {max_object_length}, {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_feature_class	Classe d’entités en sortie des objets océaniques clairs détectés.	Feature Class
out_type (Facultatif)	Spécifie le type de limite à utiliser pour la classe d’entités en sortie. `BOUNDS`—L’emprise minimale de l’objet détecté est utilisée. Il s’agit de l’option par défaut. `PERIMETER`—Un contour du périmètre de l’objet détecté est utilisé.	String
min_object_width (Facultatif)	Largeur minimale d’un objet à détecter. La largeur doit être positive. La valeur par défaut est de 10 mètres.	Linear Unit
max_object_width (Facultatif)	Largeur maximale d’un objet à détecter. La largeur doit être positive. La valeur par défaut est 100 mètres.	Linear Unit
min_object_length (Facultatif)	Longueur minimale d’un objet à détecter. La longueur doit être positive. La valeur par défaut est 50 mètres.	Linear Unit
max_object_length (Facultatif)	Longueur maximale d’un objet à détecter. La longueur doit être positive. La valeur par défaut est de 500 mètres.	Linear 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 les données radar en entrée ne sont pas orthorectifiées, ce MNE est utilisé pour orthorectifier le résultat en sortie. 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 DetectBrightOceanObjects (fenêtre Python)

Cet exemple illustre l’utilisation de l’outil pour détecter des objets océaniques clairs avec un masque d’eau.

import arcpy
arcpy.ia.DetectBrightOceanObjects(
    r"C:\Data\SAR\Spotlight High_ICEYE_GRD_SLH_50153_20210405T124010_CalG0.crf",
    r"C:\Output\Ocean.gdb\DetectBrightOceanObjects", "BOUNDS",
    "50 Meters", "500 Meters", "50 Meters", "500 Meters", "MPA Water Polygon",
    "Water", r"C:\Data\DEM\dem_COP30_ortho.tif", "GEOID", "100 Meters")

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

Cet exemple illustre l’utilisation de l’outil pour détecter des objets océaniques clairs avec un masque d’eau.

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

# Set local variables
in_radar_data= r"C:\Data\SAR\IW_manifest_CalG0.crf"
out_feature_class = r"C:\Output\Ocean.gdb\DetectBrightOceanObjects"
out_type = "BOUNDS"
min_object_width = "50 Meters"
max_object_width = "500 Meters"
min_object_length = "50 Meters"
max_object_length = "500 Meters"
mask_features = "MPA Water Polygon"
feature_type = "Water"
in_dem_raster = r"C:\Data\DEM\dem_COP30_ortho.tif"
geoid = "GEOID"
mask_tolerance = "100 Meters"

# Run
arcpy.ia.DetectBrightOceanObjects(in_radar_data, out_feature_class, out_type,
                    min_object_width, max_object_width, min_object_length,
                    max_object_length, mask_features, feature_type, in_dem_raster,
                    geoid, mask_tolerance)

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