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

Disponible avec une licence Image Analyst.

Synthèse

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 Surface minimale et génère le résultat sous 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 Appliquer un calibrage radiométrique. Ceci est particulièrement efficace pour les scènes radar de grande envergure.

  • Pour faire en sorte de détecter uniquement des zones océaniques, spécifiez une valeur pour le paramètre Masquer des entités et utilisez le paramètre 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 Raster MNE. L’outil utilise alors l’élévation pour identifier les pixels représentant l’eau et les terres. Il est possible d’utiliser l’une ou l’autre de ces méthodes pour créer un masque des étendues de terre.

    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.

    Illustration de l’outil Détecter les zones océaniques sombres
    Des masques des étendues de terre et d’eau sont représentés pour les zones océaniques sombres.

Paramètres

ÉtiquetteExplicationType 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; Raster Layer
Superficie minimale
(Facultatif)

Surface minimale pour laquelle procéder à la détection.

La taille ne peut pas être négative. La valeur par défaut est de 10 000 mètres carrés.

Areal Unit
Masquer des entités
(Facultatif)

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

Feature Class; 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.

Raster Dataset; 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

DetectDarkOceanAreas(in_radar_data, out_raster, {min_area}, {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_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; Raster Layer
min_area
(Facultatif)

Surface minimale pour laquelle procéder à la détection.

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 Class; 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.

Raster Dataset; 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 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 = "D:\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 and check out ArcGIS Image Analyst extension license
import arcpy
arcpy.CheckOutExtension("ImageAnalyst")
from arcpy.ia import *

# Set local variables
arcpy.env.workspace = "D:\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"

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

Informations de licence

  • Basic: Nécessite Image Analyst
  • Standard: Nécessite Image Analyst
  • Advanced: Nécessite Image Analyst

Rubriques connexes