Ajustar transmisión a ráster (Herramientas 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 válidos para esta herramienta.

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. Activado—Todos los segmentos de línea que cumplan los criterios se simplificarán y los ángulos agudos se eliminarán de la salida. Esta es la opción predeterminada. Desactivado—No se modificará ningún segmento de línea y los ángulos agudos no se eliminarán de la salida.	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

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. `REMOVE`—Todos los segmentos de línea que cumplan los criterios se simplificarán y los ángulos agudos se eliminarán de la salida. Esta es la opción predeterminada. `NO_REMOVE`—No se modificará ningún segmento de línea y los ángulos agudos no se eliminarán de la salida.	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

AdjustStreamToRaster ejemplo 1 (ventana de Python)

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
                     )

AdjustStreamToRaster ejemplo 2 (script independiente)

# 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"

# Set local variables
InStreamFeatures="streams.shp"
InRaster = "elevation.tif"
OutStreamFeatures = "out_adjusted_streams.shp"
OutStreamRaster = "out_adjusted_streams.tif"
OutFlowDirRaster = "out_streams_fdr.tif"

# Run the tool
AdjustStreamToRaster(InStreamFeatures,
                     InRaster,
                     OutStreamFeatures,
                     "NONE",
                     "",
                     "NONE",
                     OutStreamRaster,
                     OutFlowDirRaster,
                     "")

Entornos

Auto ejecución, Espacio de trabajo actual, Valor Z de salida predeterminado, Extensión, Transformaciones geográficas, Resolución M, Tolerancia M, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, La salida tiene valores M, La salida tiene valores Z, Dominio M de salida, Dominio XY de salida, Dominio Z de salida, Espacio de trabajo temporal, Resolución XY, Tolerancia XY, Resolución Z, Tolerancia Z

Información de licenciamiento

Basic: Requiere Spatial Analyst
Standard: Requiere Spatial Analyst
Avanzado: Requiere Spatial Analyst

Ajustar transmisión a ráster (Herramientas de Spatial Analyst)

Resumen

Uso

Parámetros

Entornos

Información de licenciamiento

Temas relacionados