| Etiqueta | Explicación | Tipo de datos |
Entidades de curso de agua de entrada | Entidades de corriente que se ajustarán para coincidir con la resolución del ráster de entrada. | Feature Dataset |
Ráster de entrada | Ráster en función del cual se ajustarán las entidades de corriente de entrada. | Raster Dataset |
Entidades de curso de agua ajustado de salida | Representación con picos de las entidades de corriente de entrada que coinciden con la resolución del ráster de entrada. Las entidades de curso de agua de salida se agruparán en función del valor del parámetro Agrupar por campo. Además del campo especificado, si existe, la tabla de atributos también tendrá el campo siguiente: StreamLink—Id. asignado a las uniones de cursos de agua. Las uniones son secciones de un canal de agua que conectan dos confluencias sucesivas. | Feature Class |
Agrupar por campo (Opcional) | Campo que contiene los valores que se utilizarán para agrupar los cursos de agua en los valores de los parámetros Entidades de curso de agua ajustado de salida y Ráster de curso de agua ajustado de salida. Los valores del campo deben ser enteros. | Field |
Eliminar ángulos agudos (Opcional) | Especifica si se van a eliminar los ángulos agudos de las entidades de curso de agua de salida. Los ángulos agudos se representan mediante segmentos de línea de 90 grados con ancho de una celda.
| Boolean |
Campo de flujo divergente o de siguiente ruta (Opcional) | Campo del valor del parámetro Entidades de curso de agua de entrada que indica el canal principal después de dividir el caudal. El segmento de curso de agua que corresponde al canal principal debe indicarse mediante un Id. El Id. debe estar presente y aparecer en un campo denominado HydroID. | Field |
Ráster de curso de agua ajustado de salida (Opcional) | Versión ráster del valor del parámetro Entidades de curso de agua ajustado de salida. Los valores de celda corresponden a los valores del campo especificados en el valor del parámetro Agrupar por campo. | Raster Dataset |
Ráster de dirección del flujo de salida (Opcional) | Ráster en el que se alamcenará la dirección del flujo (D8) dentro de las celdas de curso de agua que coincidan con la dirección digitalizada de las entidades de curso de agua de entrada. | Raster Dataset |
Entidades de puntos de división de salida (Opcional) | Ubicaciones en las que se divide el caudal y sus nodos de conectividad asociados en las entidades de curso de agua ajustado de salida. | Feature Class |
Disponible con una licencia de Spatial Analyst.
Resumen
Ajusta la entrada de entidad de curso de agua para que coincida con la resolución de un ráster de entrada.
Uso
El parámetro Entidades de curso de agua ajustado de salida (out_stream_features en Python) representa las entidades de corrientes en el valor del parámetro Entidades de curso de agua de entrada (in_stream_features en Python) una vez que se ajusta para que coincidan con la resolución del valor del parámetro Ráster de entrada (in_raster en Python).
El proceso de ajuste garantiza que la corriente ajustada cruce por el centro todas las celdas superpuestas en el valor del parámetro Ráster de entrada mientras mantiene la trayectoria original de la corriente.
El valor del parámetro opcional Agrupar por campo (group_by_field en Python) agrupa los segmentos de curso de agua basándose en el campo seleccionado. Al valor del parámetro Entidades de curso de agua de entrada no se aplica ningún grupo de forma predeterminada, a menos que contenga corrientes que se hayan segmentado en diferentes partes, pero pertenezcan al mismo segmento del curso de agua. En este caso, se fusionarán para garantizar que se otorgue un Id. único a cada segmento de curso de agua en la salida. Si los valores de campo asignan un Id. único a cada segmento de curso de agua, no habrá ninguna agrupación.
Se puede guardar una representación de ráster de las corrientes ajustadas especificando el valor del parámetro Ráster de curso de agua ajustado de salida (out_stream_raster en Python).
El valor del parámetro opcional Agrupar por campo (group_by_field en Python) determina los valores de celda del valor del parámetro Ráster de curso de agua ajustado de salida.
La dirección del flujo de agua (D8) en cada celda de los cursos de agua ajustados se puede guardar especificando el valor del parámetro Ráster de dirección de flujo de salida (out_flow_direction_raster en Python).
Utilice el parámetro Eliminar ángulos agudos (remove_sharp_angles en Python) para garantizar que no haya líneas de ancho de una celda que formen ángulos de 90 grados en el valor del parámetro Entidades de curso de agua ajustado de salida.
Si se espera que el valor del parámetro Entidades de curso de agua de entrada (in_stream_features en Python) tenga ubicaciones en las que un curso de agua se divide en dos partes y una se considera el canal principal, el canal principal puede especificarse por medio del parámetro Campo de flujo divergente o de siguiente ruta (divergent_flow_or_next_field en Python). En este caso, el campo denominado HydroID debe estar presente en la tabla de atributos del valor del parámetro Entidades de curso de agua de entrada (in_stream_features en Python). En el caso del curso de agua que se divide en dos, el campo seleccionado debe apuntar a HydroID del curso de agua que se considera el canal principal.
El número máximo de entidades de curso de agua que la herramienta puede procesar es 2.147.483.647 (2^31 - 1).
De forma predeterminada, la extensión del análisis es la del valor del parámetro Entidades de curso de agua de entrada (in_stream_features en Python).
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.
Parámetros
AdjustStreamToRaster(in_stream_features, in_raster, out_stream_features, {group_by_field}, {remove_sharp_angles}, {divergent_flow_or_next_field}, {out_stream_raster}, {out_flow_direction_raster}, {out_split_point_features})| Nombre | Explicación | Tipo de datos |
in_stream_features | Entidades de corriente que se ajustarán para coincidir con la resolución del ráster de entrada. | Feature Dataset |
in_raster | Ráster en función del cual se ajustarán las entidades de corriente de entrada. | Raster Dataset |
out_stream_features | Representación con picos de las entidades de corriente de entrada que coinciden con la resolución del ráster de entrada. Las entidades de curso de agua de salida se agruparán en función del valor del parámetro group_by_field. Además del campo especificado, si existe, la tabla de atributos también tendrá el campo siguiente: StreamLink—Id. asignado a las uniones de cursos de agua. Las uniones son secciones de un canal de agua que conectan dos confluencias sucesivas. | Feature Class |
group_by_field (Opcional) | Campo que contiene los valores que se utilizarán para agrupar los cursos de agua en los valores de los parámetros out_stream_features y out_stream_raster. Los valores del campo deben ser enteros. | Field |
remove_sharp_angles (Opcional) | Especifica si se van a eliminar los ángulos agudos de las entidades de curso de agua de salida. Los ángulos agudos se representan mediante segmentos de línea de 90 grados con ancho de una celda.
| Boolean |
divergent_flow_or_next_field (Opcional) | Campo del valor del parámetro in_stream_features que indica el canal principal después de dividir el caudal. El segmento de curso de agua que corresponde al canal principal debe indicarse mediante un Id. El Id. debe estar presente y aparecer en un campo denominado HydroID. | Field |
out_stream_raster (Opcional) | Versión ráster del valor del parámetro out_stream_features. Los valores de celda corresponden a los valores del campo especificados en el valor del parámetro group_by_field. | Raster Dataset |
out_flow_direction_raster (Opcional) | Ráster en el que se alamcenará la dirección del flujo (D8) dentro de las celdas de curso de agua que coincidan con la dirección digitalizada de las entidades de curso de agua de entrada. | Raster Dataset |
out_split_point_features (Opcional) | Ubicaciones en las que se divide el caudal y sus nodos de conectividad asociados en las entidades de curso de agua ajustado de salida. | Feature Class |
Muestra de código
En este ejemplo, se muestra cómo utilizar AdjustStreamToRaster para generar corrientes sin ángulos agudos que coincidan con la resolución de un ráster de entrada. La salida no es agrupada de forma predeterminada.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/arcpyexamples/data.gdb"
AdjustStreamToRaster(in_stream_features="streams",
in_raster="elevation",
out_stream_features="out_stream_features",
group_by_field="NONE",
remove_sharp_angles="REMOVE",
divergent_flow_or_next_field="NONE",
out_stream_raster="out_stream_raster",
out_flow_direction_raster="out_stream_flowdir_raster",
out_split_point_features=None
)En este ejemplo, se muestra cómo utilizar AdjustStreamToRaster para generar corrientes sin ángulos agudos que coincidan con la resolución de un ráster de entrada. La salida no es agrupada de forma predeterminada.
# Name: AdjustStreamToRaster_standalone.py
# Description: Adjust the input streams features to the resolution of the input raster.
# No groupping specified, therefore, the result will have as many number of features as
# there are stream segments.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy.sa import *
# Set environment settings
arcpy.env.workspace = "C:/sapyexamples/data"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Set local variables
InStreamFeatures="streams.shp"
InRaster = "elevation.tif"
OutStreamFeatures = "out_adjusted_streams.shp"
OutStreamRaster = "out_adjusted_streams.tif"
OutFlowDirRaster = "out_streams_fdr.tif"
# Execute the tool
AdjustStreamToRaster(InStreamFeatures,
InRaster,
OutStreamFeatures,
"NONE",
"",
"NONE",
OutStreamRaster,
OutFlowDirRaster,
"")Entornos
Información de licenciamiento
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst