Disponible con una licencia de Spatial Analyst.
Disponible con una licencia de 3D Analyst.
Resumen
Interpola una superficie de ráster hidrológicamente correcta a partir de datos de punto, línea y polígono mediante el uso de parámetros especificados en un archivo.
Uso
El archivo de parámetros se estructura con los dataset de entrada que se incluyen en primer lugar, seguido por varias configuraciones de parámetro y luego las opciones de salida.
Los datos de entrada identifican los dataset de entrada y, según corresponda, los campos. Hay nueve tipos de entrada: curvas de nivel, puntos, sumideros, arroyos, lagos, límites, acantilados, polígonos de exclusión y polígonos costeros. Puede utilizar tantas entradas como desee, dentro de lo razonable. El orden en el que se introducen las entradas no tiene ninguna relación con el resultado. <Path> indica una ruta a un dataset, <Item> indica un nombre de un campo y <#> indica un valor que se introducirá.
La siguiente tabla incluye todos los parámetros, la definición de cada uno y su sintaxis.
Parámetro Definición Sintaxis Datasets de entrada:
Curvas de nivel
Dataset de línea de curvas de nivel con elemento que contiene valores de altura.
Curvas de nivel <Ruta> <Elemento> Puntos
Dataset de punto con elemento que contiene valores de altura.
Punto <Ruta> <Elemento> Sumideros
Dataset de punto que contiene ubicaciones de sumideros. Si el dataset tiene valores de elevación para los sumideros, especifique el nombre del campo como el <Elemento>. Si solo se utilizarán ubicaciones de sumideros, utilice NONE para <Elemento>.
Sumidero <Ruta> <Elemento> Arroyos
Dataset de línea de corriente. Los valores de altura no son necesarios.
Arroyo <Ruta> Lagos
Dataset de polígono de lago. Los valores de altura no son necesarios.
Lago <Ruta> Límite
Dataset de polígono de límite. Los valores de altura no son necesarios.
Límite <Ruta> Acantilado
Dataset de línea de los acantilados. No hay opción de Campo para Acantilado.
Acantilado <Ruta> Exclusión
Dataset de polígono de exclusión de las áreas en las que se deben ignorar los datos de entrada. No hay opción de Campo para Exclusión.
Exclusión <Ruta> Costa
Dataset de polígono de costa que contiene el contorno de un área costera. No hay opción de Campo para Costa.
Límite <Ruta> Configuración de parámetros:
Aplicar
Controla si se aplica la aplicación de drenaje.
ENFORCE <ON | OFF | ON_WITH_SINK> Tipo de datos
Tipo primario de datos de entrada
DATATYPE <CONTOUR | SPOT> Iteraciones
La cantidad máxima de iteraciones que realiza el algoritmo.
ITERATIONS <#> Penalización por rugosidad
La medida de rugosidad de la superficie.
ROUGHNESS_PENALTY <#> Penalización por rugosidad en curvatura de perfil
La penalización por rugosidad de la curvatura de perfil es una penalización adaptable a nivel local que se puede utilizar para reemplazar parcialmente la curvatura total.
PROFILE_PENALTY <#> Factor del error de discretización
La cantidad para ajustar el suavizado de datos de los datos de entrada en un ráster.
DISCRETE_ERROR_FACTOR <#> Error estándar vertical
La cantidad de errores aleatorios en los valores z de los datos de entrada.
VERTICAL_STANDARD_ERROR <#> Tolerancias
La primera refleja la precisión de los datos de elevación en relación con el drenaje de la superficie y la otra impide el espacio de drenaje a través de barreras altas poco realistas.
TOLERANCES <#> <#> Límites Z
Límites de altura superior e inferior.
ZLIMITS <#> <#> Extensión
x mínima, y mínima, x máxima e y máxima y límites de coordenadas.
EXTENT <#> <#> <#> <#> Tamaño de celda
La resolución del ráster de salida final.
CELL_SIZE <#> Margen
Distancia en celdas para interpolar más allá de la extensión de salida especificada y el límite.
MARGIN <#> Salidas:
Entidades de arroyo de salida
La clase de entidad de línea de salida de las entidades de polilínea de arroyo y de las entidades de línea de cresta.
OUT_STREAM Entidades de sumidero de salida
La clase de entidad de punto de salida de las entidades de punto de sumidero restantes.
OUT_SINK Archivo de diagnóstico de salida
La ubicación y el nombre del archivo de diagnóstico.
OUT_DIAGNOSTICS <Path> Entidades de punto residual de salida
La clase de entidad de puntos de salida de todos los residuales de elevación grandes según las escalas proporcionadas por el error de discretización local.
OUT_RESIDUALS Entidades de puntos de acantilado y de arroyo de salida
La clase de entidad de puntos de salida de ubicaciones donde ocurren posibles errores en corrientes y acantilados.
OUT_STREAM_CLIFF_ERRORS Entidades de punto error de curvas de nivel de salida
La clase de entidad de puntos de salida de posibles errores relativos a los datos de curvas de nivel de entrada.
OUT_CONTOUR_ERRORS Para los formatos de datos que admiten valores nulos, como las clases de entidad de geodatabase de archivos, se ignorará un valor nulo cuando se utilice como entrada.
No especifique rutas para los datasets de entidades de salida opcionales en el archivo de parámetros. Utilice Entidades de polilínea de arroyo de salida y Entidades de punto de sumideros restantes de salida en el cuadro de diálogo de la herramienta para identificar estas salidas.
El contenido de un archivo de parámetros a modo de ejemplo es:
Contour D:\data\contours2\arc HEIGHT Point D:\data\points2\point SPOTS Sink D:\data\sinks_200.shp Stream D:\data\streams\arc Lake D:\data\lakes\polygon Boundary D:\data\clipcov\polygon Cliff D:\data\cliffs.shp ENFORCE ON DATATYPE CONTOUR ITERATIONS 40 ROUGHNESS_PENALTY 0.0 PROFILE_PENALTY 0.5 DISCRETE_ERROR_FACTOR 1.0 VERTICAL_STANDARD_ERROR 0.0 TOLERANCES 2.5 100.0 ZLIMITS -2000.0 13000.0 EXTENT -810480.625 8321785.0 810480.625 10140379.0 CELL_SIZE 1800.00000000000 MARGIN 20 OUT_DIAGNOSTICS D:\data\ttr_diag.txtConsulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.
Sintaxis
TopoToRasterByFile(in_parameter_file, {out_stream_features}, {out_sink_features}, {out_residual_feature}, {out_stream_cliff_error_feature}, {out_contour_error_feature})| Parámetro | Explicación | Tipo de datos |
in_parameter_file | El archivo de texto ASCII de entrada que contiene las entradas y los parámetros que se utilizarán en la interpolación. Por lo común, el archivo se crea a partir de una ejecución previa de De topo a ráster con el archivo de parámetros de salida opcional especificado. Para evaluar el resultado del cambio de parámetros, es más fácil editar este archivo y volver a ejecutar la interpolación, que emitir correctamente la herramienta De topo a ráster cada vez. | File |
out_stream_features (Opcional) | Clase de entidad de salida de las entidades de polilínea de arroyo. Las entidades de polilínea se codifican de la siguiente forma: 1. Línea de corriente de entrada no está sobre un acantilado. 2. Línea de corriente de entrada sobre un acantilado (cascada). 3. Aplicación de drenaje despejando un sumidero espurio. 4. Línea de transmisión determinada desde la esquina de curvas de nivel. 5. Línea de cresta determinada desde la esquina de curvas de nivel. 6. Código no utilizado. 7. Condiciones laterales de línea de transmisión de datos. 8. Código no utilizado. 9. Línea que indica grandes márgenes en datos de elevación. | Feature Class |
out_sink_features (Opcional) | Clase de entidad de salida de las entidades de punto de sumidero restantes. | Feature Class |
out_residual_feature (Opcional) | La clase de entidad de puntos de salida de todos los residuales de elevación grandes según las escalas proporcionadas por el error de discretización local. Todos los valores residuales en escalas mayores que 10 se deben revisar por posibles errores en los datos de entrada de arroyos y de elevación. Los valores residuales en escala grande indican conflictos entre los datos de entrada de elevación y los datos de línea de transmisión. Esos valores también pueden estar asociados con aplicaciones automáticas de drenaje deficientes. Estos conflictos se pueden resolver proporcionando datos adicionales de elevación del punto o de la línea de corriente lineal después de la primera verificación y corrección de errores en los datos de entrada existentes. Los valores residuales sin escala generalmente indican errores de elevación de entrada. | Feature Class |
out_stream_cliff_error_feature (Opcional) | La clase de entidad de puntos de salida de ubicaciones donde ocurren posibles errores en corrientes y acantilados. Las ubicaciones donde las corrientes tienen bucles cerrados, afluentes y corrientes sobre acantilados se pueden identificar desde la clase de entidad de puntos. Los acantilados con celdas vecinas inconsistentes, con lados altos y bajos del acantilado, también se indican. Este puede ser un buen indicador de acantilados con dirección incorrecta. Los puntos se codifican de la siguiente manera: 1. Circuito real en la red de línea de transmisión de datos. 2. El circuito en la red de corriente según se codifica en el ráster de salida. 3. El circuito en la red de corrientes a través de la conexión de los lagos. 4. Punto de bifurcaciones de ríos. 5. Transmisión en un acantilado (cataratas). 6. Puntos que indican varios flujos de salida de corrientes desde los lagos. 7. Código no utilizado. 8. Puntos junto a acantilados con alturas inconsistentes con dirección de acantilado. 9. Código no utilizado. 10. Bifurcaciones de ríos circulares eliminadas. 11. Bifurcaciones de ríos sin corriente que fluye hacia adentro. 12. Bifurcaciones de ríos rasterizadas en celda de salida diferentes al lugar donde ocurren las bifurcaciones de ríos de la línea de transmisión de datos. 13. Error al procesar las condiciones laterales: un indicador de datos de línea de transmisión muy complejos. | Feature Class |
out_contour_error_feature (Opcional) | La clase de entidad de puntos de salida de posibles errores relativos a los datos de curvas de nivel de entrada. Curvas de nivel con inclinación en altura que excede cinco veces la desviación estándar de los valores de curvas de nivel según se representan en el ráster de salida se reportan a esta clase de entidad. Las curvas de nivel que se unen con otras curvas con una elevación diferente se etiquetan en esta clase de entidad por el código 1; esta es una señal clara de un error de etiqueta de curvas de nivel. | Feature Class |
Valor de retorno
| Nombre | Explicación | Tipo de datos |
| out_surface_raster | Ráster de superficie interpolado de salida. Siempre es un ráster de punto flotante. | Raster |
Muestra de código
En este ejemplo se crea un ráster de superficie TIFF hidrológicamente correcta a partir de un archivo de parámetros que define los datos de punto, línea y polígono de entrada.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outTTRByFile = TopoToRasterByFile("topotorasterbyfile.txt",
"C:/sapyexamples/output/out_streams.shp", "#",
"C:/sapyexamples/output/out_resids.shp")
outTTRByFile.save("C:/sapyexamples/output/ttrbyfout.tif")En este ejemplo se crea un ráster de superficie de cuadrícula hidrológicamente correcta a partir de un archivo de parámetros que define los datos de entrada de punto, línea y polígono.
# Name: TopoToRasterByFile_Ex_02.py
# Description: Interpolates a hydrologically correct
# surface from point, line, and polygon data using
# parameters specified in a file.
# 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
inParameterFile = "topotorasterbyfile.txt"
# Execute TopoToRasterByFile
outTTRByFile = TopoToRasterByFile(inParameterFile)
# Save the output
outTTRByFile.save("C:/sapyexamples/output/ttrbyfout02")Entornos
Información de licenciamiento
- Basic: Requiere Spatial Analyst o 3D Analyst
- Standard: Requiere Spatial Analyst o 3D Analyst
- Advanced: Requiere Spatial Analyst o 3D Analyst