De topo a ráster por archivo (Spatial 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 entradas: Curvas de nivel, puntos, sumideros, arroyos, Lagos, límites, acantilados, exclusión y los 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. <Ruta> indica una ruta a un dataset, <Elemento> indica un nombre de un campo y <#> indica un valor que se escribirá.
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.
Curva 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 de la 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 <Ruta> 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 arroyos 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 -
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.txt
Sintaxis
| 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:
| 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, distributarios y corrientes sobre acantilados se pueden identificar desde la clase de entidad de punto. 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:
| 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. | Raster |
Ejemplo 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"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute TopoToRasterByFile
outTTRByFile = TopoToRasterByFile(inParameterFile, "#", "C:/sapyexamples/output/out_resids2.shp")
# Save the output
outTTRByFile.save("C:/sapyexamples/output/ttrbyfout02")