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 seis tipos de entrada: curvas de nivel, puntos, sumideros, arroyos, lagos y límites. 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> 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 <#> 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> -
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 ENFORCE ON DATATYPE CONTOUR ITERATIONS 40 ROUGHNESS_PENALTY 0.00000000000 DISCRETE_ERROR_FACTOR 1.00000000000 VERTICAL_STANDARD_ERROR 0.00000000000 TOLERANCES 2.50000000000 100.00000000000 ZLIMITS -2000.00000000000 13000.00000000000 EXTENT -810480.62500000000 8321785.00000000000 810480.62500000000 10140379.00000000000 CELL_SIZE 1800.00000000000 MARGIN 20 OUT_STREAM OUT_SINK 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. | Feature Class |
out_sink_features (Opcional) |
Clase de entidad de salida de las entidades de punto de sumidero restantes. | 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")
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 la entrada de datos 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)
# Save the output
outTTRByFile.save("C:/sapyexamples/output/ttrbyfout02")