Extraer agua (Herramientas de Image Analyst)

Resumen

Encuentra masas de agua utilizando datos de radar de apertura sintética (SAR) de entrada y un modelo digital de elevación (DEM).

La herramienta utiliza la retrodispersión del radar de entrada para determinar si los píxeles deben clasificarse como agua y, a continuación, crea polígonos para las zonas de agua. La herramienta también creará polígonos para las zonas que no sean agua, que se considerarán zonas terrestres.

Ilustración

Ilustración de la herramienta Extraer agua

Uso

Calibre los datos de radar de entrada a gamma cero mediante la herramienta [Aplicar calibración radiométrica](apply-radiometric-calibration.yml. Esto optimiza la delineación y la clasificación, sobre todo 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).
Esta herramienta también se puede utilizar para crear polígonos de agua o polígonos de tierra para introducirlos en otras herramientas SAR, como Detectar objetos oceánicos brillantes y Detectar áreas oceánicas oscuras.

Etiqueta	Explicación	Tipo de datos
Datos de radar de entrada	Los datos de radar de entrada.	Raster Dataset; Raster Layer
Clase de entidad de salida	La clase de entidad de polígono de salida que representa los polígonos de agua y tierra.	Feature Class
Área mínima (Opcional)	Superficie mínima para extraer como masa de agua. El valor predeterminado es 50 000 metros cuadrados.	Areal Unit
Ráster DEM (Opcional)	El DEM de entrada. Si los datos de radar de entrada no están ortorrectificados, se utilizará este DEM para ortorrectificar el resultado de la salida. Este DEM también se utilizará para optimizar la construcción de polígonos.	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. Activado—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. Desactivado—No se realizará ninguna corrección geoide. Utilice esta opción solamente si el DEM ya está proporcionado en altura elipsoidal.	Boolean

ExtractWater(in_radar_data, out_feature_class, {min_area}, {in_dem_raster}, {geoid})

Nombre	Explicación	Tipo de datos
in_radar_data	Los datos de radar de entrada.	Raster Dataset; Raster Layer
out_feature_class	La clase de entidad de polígono de salida que representa los polígonos de agua y tierra.	Feature Class
min_area (Opcional)	Superficie mínima para extraer como masa de agua. El valor predeterminado es 50 000 metros cuadrados.	Areal Unit
in_dem_raster (Opcional)	El DEM de entrada. Si los datos de radar de entrada no están ortorrectificados, se utilizará este DEM para ortorrectificar el resultado de la salida. Este DEM también se utilizará para optimizar la construcción de polígonos.	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. `GEOID`—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. `NONE`—No se realizará ninguna corrección geoide. Utilice esta opción solamente si el DEM ya está proporcionado en altura elipsoidal.	Boolean

Muestra de código

Ejemplo 1 de ExtractWater (ventana de Python)

Este ejemplo extrae polígonos de agua mayores de 1 kilómetro cuadrado.

import arcpy
arcpy.env.workspace = r"C:\Data\SAR"

arcpy.ia.ExtractWater("LowNoise_manifest_CalG0_TNR.crf",
    "LowNoise_manifest_CalG0_TNR_Water.shp", "1 SquareKilometer",
    "dem_COP30_ortho.tif", "GEOID")

Ejemplo 2 de ExtractWater (script independiente)

Este ejemplo extrae polígonos de agua mayores de 1 kilómetro cuadrado.

# Import system modules
import arcpy
from arcpy.ia import *

# Set local variables
in_radar=r"C:\SAR\Low Noise_manifest_CalG0_TNR.crf"
out_radar=r"C:\SAR\Low Noise_manifest_CalG0_TNR_Water.shp"
min_area="1 SquareKilometer"
in_dem_raster=r"C:\DEM\dem_COP30_ortho.tif"
geoid="GEOID"

# Run
arcpy.ia.ExtractWater(in_radar, out_radar, min_area, in_dem_raster, geoid)

Entornos

Compresión, Espacio de trabajo actual, NoData, Palabra clave CONFIG de salida, Factor de procesamiento en paralelo, Pirámide, Estadísticas de ráster, Método de remuestreo, Espacio de trabajo temporal, Alinear ráster, Tamaño de tesela

Información de licenciamiento

Basic: Requiere Image Analyst
Standard: Requiere Image Analyst
Avanzado: Requiere Image Analyst