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

Nivel de licencia:BasicStandardAdvanced

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

Sintaxis

TopoToRasterByFile (in_parameter_file, {out_stream_features}, {out_sink_features}, {out_residual_feature}, {out_stream_cliff_error_feature}, {out_contour_error_feature})
ParámetroExplicaciónTipo 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

NombreExplicaciónTipo de datos
out_surface_raster

Ráster de superficie interpolado de salida.

Raster

Ejemplo 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 (secuencia de comandos 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"

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

Entornos

Temas relacionados

Información sobre licencias

ArcGIS for Desktop Basic: Requiere Spatial Analyst o 3D Analyst
ArcGIS for Desktop Standard: Requiere Spatial Analyst o 3D Analyst
ArcGIS for Desktop Advanced: Requiere Spatial Analyst o 3D Analyst
5/10/2014