| Etiqueta | Explicación | Tipo 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 |
Á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 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.
| 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.
| 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 |
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.
Se muestran las máscaras de agua y tierra para las zonas oceánicas oscuras.
Parámetros
DetectDarkOceanAreas(in_radar_data, out_raster, {min_area}, {mask_features}, {feature_type}, {in_dem_raster}, {geoid}, {mask_tolerance})| Nombre | Explicación | Tipo 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 |
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 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.
| 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.
| 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
Este ejemplo detecta zonas oceánicas oscuras utilizando una máscara de tierra.
import arcpy
arcpy.env.workspace = r"C:\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")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 = r"C:\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)Entornos
Información de licenciamiento
- Basic: Requiere Image Analyst
- Standard: Requiere Image Analyst
- Advanced: Requiere Image Analyst