Detectar objetos oceánicos luminosos (Image Analyst)

Disponible con licencia de Image Analyst.

Resumen

Detecta posibles objetos brillantes fabricados por el hombre -como barcos, plataformas petrolíferas y molinos de viento- al tiempo que enmascara los datos del radar de apertura sintética (SAR) fuera de la región de interés.

La herramienta agrupa los píxeles en clústeres y los filtra con arreglo a los parámetros de longitud y anchura máxima y mínima, y genera los resultados en una clase de entidad. La clase de entidad de salida puede especificarse con un rectángulo de selección o un perímetro alrededor del polígono para los objetos detectados.

Uso

  • Calibre los datos de radar de entrada a gamma cero mediante la herramienta Aplicar calibración radiométrica. Así se optimiza la detección de objetos, especialmente en grandes escenas de radar.

  • Los datos de radar de entrada podrían no alinearse con la clase de entidades de salida. Si los datos de rada de entrada no se ortorrectifican, la herramienta transforma el valor del parámetro Clase de entidad de salida mediante el uso del parámetro Ráster DEM. Si no se proporciona un DEM, la herramienta utiliza una superficie elipsoidal para llevar a cabo la transformación. Para que se haga una transformación óptima del valor del parámetro Clase de entidad de salida, proporcione un DEM de entrada en el parámetro Ráster DEM. El DEM de entrada debe estar en el sistema de coordenadas geográficas WGS84 (EPSG:4326).

  • Para asegurarse de que solamente se detectan objetos 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.

    Máscara de agua y suelo para objetos oceánicos luminosos

Parámetros

EtiquetaExplicaciónTipo de datos
Datos de radar de entrada

Los datos de radar de entrada.

Raster Dataset; Raster Layer
Clase de entidad de salida

Clase de entidad de salida de los objetos oceánicos luminosos detectados.

Feature Class
Tipo de Salida
(Opcional)

Especifica el tipo de límite que se utilizará para la clase de entidad de salida.

  • Cuadro de delimitaciónSe utilizará el cuadro delimitador mínimo del objeto detectado. Esta es la opción predeterminada.
  • PerímetroSe utilizará un contorno del perímetro del objeto detectado.
String
Ancho de objeto mínimo
(Opcional)

La anchura mínima de un objeto que se va a detectar. La anchura debe ser un valor positivo.

El valor predeterminado son 10 metros.

Linear Unit
Ancho de objeto máximo
(Opcional)

La anchura máxima de un objeto que se va a detectar. La anchura debe ser un valor positivo.

El valor predeterminado es 100 metros.

Linear Unit
Longitud de objeto mínima
(Opcional)

La longitud mínima de un objeto que se va a detectar. La longitud debe ser un valor positivo.

El valor predeterminado es 50 metros.

Linear Unit
Longitud de objeto máxima
(Opcional)

La longitud máxima de un objeto que se va a detectar. La longitud debe ser un valor positivo.

El valor predeterminado es 500 metros.

Linear 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 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.

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

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})
NombreExplicaciónTipo de datos
in_radar_data

Los datos de radar de entrada.

Raster Dataset; Raster Layer
out_feature_class

Clase de entidad de salida de los objetos oceánicos luminosos detectados.

Feature Class
out_type
(Opcional)

Especifica el tipo de límite que se utilizará para la clase de entidad de salida.

  • BOUNDSSe utilizará el cuadro delimitador mínimo del objeto detectado. Esta es la opción predeterminada.
  • PERIMETERSe utilizará un contorno del perímetro del objeto detectado.

String
min_object_width
(Opcional)

La anchura mínima de un objeto que se va a detectar. La anchura debe ser un valor positivo.

El valor predeterminado son 10 metros.

Linear Unit
max_object_width
(Opcional)

La anchura máxima de un objeto que se va a detectar. La anchura debe ser un valor positivo.

El valor predeterminado es 100 metros.

Linear Unit
min_object_length
(Opcional)

La longitud mínima de un objeto que se va a detectar. La longitud debe ser un valor positivo.

El valor predeterminado es 50 metros.

Linear Unit
max_object_length
(Opcional)

La longitud máxima de un objeto que se va a detectar. La longitud debe ser un valor positivo.

El valor predeterminado es 500 metros.

Linear Unit
mask_features
(Opcional)

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

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.

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 DetectBrightOceanObjects (ventana de Python)

En este ejemplo se encuentran objetos oceánicos luminosos por medio de una máscara acuática.

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")
Ejemplo 2 de DetectBrightOceanObjects (script independiente)

En este ejemplo se encuentran objetos oceánicos luminosos por medio de una máscara acuática.

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

Temas relacionados