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ámetroDefiniciónSintaxis

    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.txt

  • Consulte 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á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.

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

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

Temas relacionados