De topo a ráster por archivo (Spatial Analyst)

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.

Más información sobre cómo funciona De topo a ráster

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 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 <#> <#>
  Extent	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 puntos residuales 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 en arroyos y acantilados 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.txt

• 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

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Archivo de parámetros de entrada	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 a ráster cada vez.	File
Entidades de polilíneas de arroyo de salida (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
Entidades de puntos de los sumideros restantes de salida (Opcional)	Clase de entidad de salida de las entidades de punto de sumidero restantes.	Feature Class
Entidades de puntos residuales de salida (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
Entidades de puntos con error en arroyos y acantilados de salida (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
Entidades de punto error de curvas de nivel de salida (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

Etiqueta	Explicación	Tipo de datos
Ráster de superficie de salida	Ráster de superficie interpolado de salida. Siempre es un ráster de punto flotante.	Raster

Python

TopoToRasterByFile(in_parameter_file, {out_stream_features}, {out_sink_features}, {out_residual_feature}, {out_stream_cliff_error_feature}, {out_contour_error_feature})

Nombre	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 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

Ejemplo 1 de TopoToRasterByFile (ventana de Python)

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

Ejemplo 2 de TopoToRasterByFile (script independiente)

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

Auto ejecución, Espacio de trabajo actual, Valor Z de salida predeterminado, Extensión, Transformaciones geográficas, Máscara, Resolución M, Tolerancia M, Mantener el índice espacial, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, La salida tiene valores M, La salida tiene valores Z, Palabra clave CONFIG de salida, Dominio XY de salida, Dominio Z de salida, Espacio de trabajo temporal, Alinear ráster, Tamaño de tesela, Transferir descripciones de dominio de campo, Resolución XY, Tolerancia XY, Resolución Z, Tolerancia Z

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