Detectar áreas oceánicas oscuras (Image Analyst)

Disponible con licencia de Image Analyst.

Resumen

Identifica posibles píxeles oscuros pertenecientes a vertidos de petróleo o algas, y agrupa estos píxeles, al tiempo que enmascara los datos del radar de apertura sintética (SAR) fuera de la región de interés.

La herramienta filtra los clústeres utilizando el parámetro Área mínima y crea el resultado como un ráster binario. Un valor de 1 corresponde a zonas oscuras detectadas y se simboliza con un color aleatorio. Un valor de 0 indica que no se han detectado zonas oscuras y se simboliza con transparencia total.

Tanto los datos de radar ortorrectificados como los no ortorrectificados son entradas válidas. Los datos de radar no ortorrectificados dan lugar a un filtrado de artefactos de acimut mejorado debido a que los datos están en coordenadas de radar.

Uso

  • Optimice la detección de áreas calibrando los datos de radar de entrada a gamma cero mediante la herramienta Aplicar calibración radiométrica. Esto resulta especialmente eficaz en las escenas de radar de mayor tamaño.

  • Para asegurarse de que solamente se detectan áreas en el océano, proporcione un valor para el parámetro Entidades de máscara y utilice el parámetro Tipo de entidad para especificar si la máscara es agua o tierra. Si lo desea, proporcione un valor de parámetro Ráster DEM y la herramienta utilizará la elevación para determinar los píxeles de tierra y agua. Cualquiera de estos métodos puede utilizarse para crear una máscara de terreno.

    Si se proporcionan los valores de los parámetros Entidades de máscara y Ráster DEM, se utilizará el parámetro Entidades de máscara para crear la máscara.

    Ilustración de la herramienta Detectar zonas oceánicas oscuras
    Se muestran las máscaras de agua y tierra para las zonas oceánicas oscuras.

Parámetros

EtiquetaExplicaciónTipo de datos
Datos de radar de entrada

Los datos de radar de entrada.

Raster Dataset; Raster Layer
Ráster de salida

La trama binaria de salida de las zonas oceánicas oscuras detectadas. Un valor de 1 corresponde a una zona oscura detectada.

Raster Dataset; Raster Layer
Área mínima
(Opcional)

El área mínima que debe detectarse.

El tamaño no puede ser negativo. El valor predeterminado es 10.000 metros cuadrados.

Areal Unit
Entidades de máscara
(Opcional)

Una entidad de polígono terrestre o acuático. Este polígono se utilizará para crear una máscara.

Feature Class; Feature Layer
Tipo de entidad
(Opcional)

Especifica el tipo de polígono que representa el valor del parámetro Entidades de máscara. Este parámetro es necesario si se especifica el parámetro Entidades de máscara.

  • Polígono de tierraLa entrada de la máscara es un polígono terrestre. Se creará una máscara invertida utilizando esta entrada.
  • Polígono de aguaLa máscara de entrada es un polígono de agua. Se creará una máscara utilizando esta entrada.
String
Ráster DEM
(Opcional)

El DEM de entrada.

Si los datos de radar de entrada no están ortorrectificados, se utilizará este MDE para ortorrectificarlos.

Si no se proporciona el valor del parámetro Entidades de máscara, este MDE también se utilizará para crear una máscara de terreno.

Raster Dataset; Mosaic Layer; Raster Layer
Aplicar corrección geoide
(Opcional)

Especifica si el sistema de referencia vertical del DEM de entrada se transformará a altura elipsoidal. La mayoría de los datasets de elevación hacen referencia a altura ortométrica a nivel del mar, por lo que es necesario realizar una corrección en estos casos para convertirla a altura elipsoidal.

  • Activada: se realizará una corrección geoide para convertir la altura ortométrica en altura elipsoidal (basándose en el geoide EGM96). Esta es la opción predeterminada.
  • Desactivada: no se realizará ninguna corrección geoide. Utilice esta opción solamente si el DEM ya está proporcionado en altura elipsoidal.

Boolean
Tolerancia de máscara
(Opcional)

La distancia de influencia que rodea la máscara creada a partir del parámetro Entidades de máscara o del parámetro Ráster DEM. La distancia no puede ser negativa. El valor predeterminado es 100 metros.

Linear Unit

DetectDarkOceanAreas(in_radar_data, out_raster, {min_area}, {mask_features}, {feature_type}, {in_dem_raster}, {geoid}, {mask_tolerance})
NombreExplicaciónTipo de datos
in_radar_data

Los datos de radar de entrada.

Raster Dataset; Raster Layer
out_raster

La trama binaria de salida de las zonas oceánicas oscuras detectadas. Un valor de 1 corresponde a una zona oscura detectada.

Raster Dataset; Raster Layer
min_area
(Opcional)

El área mínima que debe detectarse.

El tamaño no puede ser negativo. El valor predeterminado es 10.000 metros cuadrados.

Areal Unit
mask_features
(Opcional)

Una entidad de polígono terrestre o acuático. Este polígono se utilizará para crear una máscara.

Feature Class; Feature Layer
feature_type
(Opcional)

Especifica el tipo de polígono que representa el valor del parámetro mask_features. Este parámetro se requiere si se especifica el parámetro mask_features.

  • LANDLa entrada de la máscara es un polígono terrestre. Se creará una máscara invertida utilizando esta entrada.
  • WATERLa máscara de entrada es un polígono de agua. Se creará una máscara utilizando esta entrada.
String
in_dem_raster
(Opcional)

El DEM de entrada.

Si los datos de radar de entrada no están ortorrectificados, se utilizará este MDE para ortorrectificarlos.

Si no se proporciona el valor del parámetro mask_features, este MDE también se utilizará para crear una máscara de terreno.

Raster Dataset; Mosaic Layer; Raster Layer
geoid
(Opcional)

Especifica si el sistema de referencia vertical del DEM de entrada se transformará a altura elipsoidal. La mayoría de los datasets de elevación hacen referencia a altura ortométrica a nivel del mar, por lo que es necesario realizar una corrección en estos casos para convertirla a altura elipsoidal.

  • GEOIDSe realizará una corrección geoide para convertir la altura ortométrica en altura elipsoidal (basándose en el geoide EGM96). Esta es la opción predeterminada.
  • NONENo se realizará ninguna corrección geoide. Utilice esta opción solamente si el DEM ya está proporcionado en altura elipsoidal.
Boolean
mask_tolerance
(Opcional)

La distancia de influencia que rodea la máscara creada a partir del parámetro mask_features o el parámetro in_dem_raster. La distancia no puede ser negativa. El valor predeterminado es 100 metros.

Linear Unit

Muestra de código

Ejemplo 1 de DetectDarkOceanAreas (ventana de Python)

Este ejemplo detecta zonas oceánicas oscuras utilizando una máscara de tierra.

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")
Ejemplo 2 de DetectDarkOceanAreas (secuencia de comandos independiente)

Este ejemplo detecta zonas oceánicas oscuras utilizando una máscara de tierra.

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

Información de licenciamiento

  • Basic: Requiere Image Analyst
  • Standard: Requiere Image Analyst
  • Advanced: Requiere Image Analyst

Temas relacionados