Ajuste de corrientes (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Resumen

Alinea los puntos de fluidez a la celda de acumulación de flujo más alta dentro de una distancia específica.

Uso

  • La herramienta Alinear punto de fluidez se utiliza para asegurar la selección de puntos de flujo acumulado alto cuando se delinean cuencas de drenaje al utilizar la herramienta Cuenca hidrográfica. Alinear punto de fluidez buscará, dentro de una distancia de alineación alrededor de los puntos de fluidez especificados, la celda de flujo acumulado más alto y moverá el punto de fluidez a esa ubicación.

  • Si los datos de punto de fluidez de entrada son una clase de entidad de punto, se convertirán a un ráster internamente para el procesamiento.

  • La salida es un ráster entero cuando las ubicaciones originales del punto de fluidez se han alineado a ubicaciones de flujo acumulado más alto.

  • Cuando sólo hay una ubicación de punto de fluidez de entrada, la extensión de la salida es la del ráster de acumulación. Si existe más de una ubicación de punto de fluidez, la extensión de la salida se determina mediante las configuraciones del entorno Extensión de salida.

  • Al especificar las ubicaciones de punto de fluidez de entrada como datos de entidad, el campo predeterminado será el primer campo válido disponible. Si no existen campos válidos, el campo ObjectID (por ejemplo, OID o FID) será el valor predeterminado.

  • Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.

Sintaxis

SnapPourPoint(in_pour_point_data, in_accumulation_raster, snap_distance, {pour_point_field})
ParámetroExplicaciónTipo de datos
in_pour_point_data

Las ubicaciones de punto de fluidez de entrada que se alinearán.

Para un ráster de entrada, todas las celdas que no son NoData (es decir, que tienen un valor) se considerarán puntos de fluidez y se alinearán.

Para una entidad de punto de entrada, esto especifica las ubicaciones de las celdas que se alinearán.

Raster Layer; Feature Layer
in_accumulation_raster

El ráster de acumulación de flujo de entrada.

Puede crearse con la herramienta Acumulación de flujo.

Raster Layer
snap_distance

Distancia máxima, en unidades de mapa, para buscar una celda de flujo acumulado más alto.

Double
pour_point_field
(Opcional)

El campo que se utiliza para asignar los valores a las ubicaciones de punto de fluidez.

Si el dataset de punto de fluidez es un ráster, use Value.

Si el dataset de punto de fluidez es una entidad, use un campo numérico. Si el campo contiene valores de punto flotante, se truncarán en enteros.

Field

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

La salida es un ráster de punto de fluidez de salida donde las ubicaciones originales del punto de fluidez se han alineado a las ubicaciones del flujo acumulado más alto.

Esta salida es siempre de tipo entero.

Raster

Muestra de código

Ejemplo 1 de SnapPourPoint (ventana de Python)

Este ejemplo ajusta las corrientes a las celdas de la acumulación de flujo más alta dentro de una distancia específica.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outSnapPour = SnapPourPoint("pourpoint", "flowaccumulation.img", 5,"VALUE") 
outSnapPour.save("c:/sapyexamples/output/outsnpprpnt01")
Ejemplo 2 de SnapPourPoint (secuencia de comandos independiente)

Este ejemplo ajusta las corrientes a las celdas de la acumulación de flujo más alta dentro de una distancia específica.

# Name: SnapPourPoints_Ex_02.py
# Description: Snaps pour points to the cell of highest 
#              flow accumulation within a specified distance.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inPourPoint = "pourpoint"
inFlowAccum = "flowaccumulation.img"
tolerance = 5
pourField = "VALUE"

# Execute SnapPourPoints
outSnapPour = SnapPourPoint(inPourPoint, inFlowAccum, tolerance, 
                            pourField) 

# Save the output 
outSnapPour.save("c:/sapyexamples/output/outsnpprpnt02")

Información de licenciamiento

  • Basic: Requiere Spatial Analyst
  • Standard: Requiere Spatial Analyst
  • Advanced: Requiere Spatial Analyst

Temas relacionados