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

Disponible avec une licence Image Analyst.

Synthèse

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 des objets détectés.

Utilisation

  • Calibrez les données radar en entrée sur gamma zéro à l’aide de l’outil Appliquer un 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) à l’aide 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é 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 que seules les objets de l’océan soient détectés, spécifiez une valeur pour le paramètre Mask Features (Masquer des entités) et utilisez le paramètre Feature Type (Type d’entité) pour indiquer si le masque est un masque d’eau ou de terre. Vous pouvez également spécifier une valeur de paramètre DEM Raster (Raster MNE) ; l’outil utilise alors l’altitude pour déterminer les pixels de la terre et de l’eau. Il est possible d’utiliser l’une ou l’autre de ces méthodes pour créer un masque terrestre.

    Si les valeurs des paramètres Mask Features (Masquer des entités) et DEM Raster (Raster MNE) sont toutes deux fournies, le paramètre Mask Features (Masquer des entités) est utilisé pour créer le masque.

    Masque terrestre et d’eau pour les objets océaniques clairs

Paramètres

ÉtiquetteExplicationType 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.

  • EmpriseL’emprise minimale de l’objet détecté est utilisée. Il s’agit de l’option par défaut.
  • PérimètreUn 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
Masquer des entités
(Facultatif)

Entité surfacique de terre ou d’eau. Ce polygone est utilisé pour créer un masque.

Feature Layer
Type d’entité
(Facultatif)

Spécifie le type de polygone représenté par la valeur de paramètre Mask Features (Masquer des entités). Ce paramètre est requis si le paramètre Mask Features (Masquer des entités) est spécifié.

  • Polygone de terreL’entrée de masque correspond à un polygone de terre. Un masque inversé est créé à l’aide de cette entrée.
  • Polygone d’eauL’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 les orthorectifier.

Si la valeur du paramètre Mask Features (Masquer des entités) n’est pas fournie, ce MNE est également utilisé pour créer un masque terrestre.

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étriques en hauteur ellipsoïdale (en fonction de la géoïde EGM96). Il s’agit de l’option par défaut.
  • Désactivé : aucune correction de géoïde ne sera effectuée. Utilisez cette option uniquement si le MNE est exprimé en hauteur ellipsoïdale.

Boolean
Masquer la tolérance
(Facultatif)

Distance de la zone tampon autour du masque créée à partir du paramètre Mask Features (Masquer des entités) 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})
NomExplicationType 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.

  • BOUNDSL’emprise minimale de l’objet détecté est utilisée. Il s’agit de l’option par défaut.
  • PERIMETERUn 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 de paramètre mask_features. Ce paramètre est requis si le paramètre mask_features est spécifié.

  • LANDL’entrée de masque correspond à un polygone de terre. Un masque inversé est créé à l’aide de cette entrée.
  • WATERL’entrée de masque correspond à un polygone d’eau. Un masque est créé à l’aide de cette entrée.

String
in_dem_raster
(Facultatif)

DEM en entrée.

Si les données radar en entrée ne sont pas orthorectifiées, ce MNE est utilisé pour les orthorectifier.

Si la valeur du paramètre mask_features n’est pas fournie, ce MNE est également utilisé pour créer un masque terrestre.

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.

  • GEOIDUne 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.
  • NONEAucune 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éée à 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 l’outil 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 l’outil 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 and check out ArcGIS Image Analyst extension license
import arcpy
arcpy.CheckOutExtension("ImageAnalyst")
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"

# Execute 
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)

Rubriques connexes