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 válidos para esta herramienta.
Sintaxis
SnapPourPoint (in_pour_point_data, in_accumulation_raster, snap_distance, {pour_point_field})
Parámetro | Explicación | Tipo 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) | Campo utilizado para asignar valores a las ubicaciones de punto corriente. Si el dataset de punto corriente es un ráster, utilice Valor. Si el dataset de punto corriente es una entidad, utilice un campo numérico. Si el campo contiene valores de punto flotante, se truncarán en enteros. | Field |
Valor de retorno
Nombre | Explicación | Tipo 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"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute SnapPourPoints
outSnapPour = SnapPourPoint(inPourPoint, inFlowAccum, tolerance,
pourField)
# Save the output
outSnapPour.save("c:/sapyexamples/output/outsnpprpnt02")
Entornos
Información sobre licencias
- ArcGIS Desktop Basic: Requiere Spatial Analyst
- ArcGIS Desktop Standard: Requiere Spatial Analyst
- ArcGIS Desktop Advanced: Requiere Spatial Analyst