De terreno a ráster (3D Analyst)—ArcGIS Pro

Resumen

Interpola un ráster usando los valores z de un dataset de terreno.

Uso

Para extraer un subconjunto del terreno, defina la extensión usando la configuración del entorno de geoprocesamiento.

Parámetros

Etiqueta	Explicación	Tipo de datos
Terreno de entrada	El dataset de terreno que se va a procesar.	Terrain Layer
Ráster de salida	Ubicación y nombre del ráster de salida. Al almacenar un dataset ráster en una geodatabase o en una carpeta como una Cuadrícula de Esri, no agregue una extensión de archivo al nombre del dataset ráster. Se puede indicar una extensión de archivo para definir el formato del ráster al almacenarlo en una carpeta, como .tif para generar un GeoTIFF o .img para generar un archivo con el formato ERDAS IMAGINE. Si el ráster se almacena como un archivo TIFF o en una geodatabase, su tipo de compresión de ráster y la calidad se pueden especificar utilizando la configuración del entorno de geoprocesamiento.	Raster Dataset
Tipo de datos de salida (Opcional)	Especifica el tipo de valores numéricos almacenados en el ráster de salida. Flotante—El ráster de salida utilizará un punto flotante de 32 bits, que admite valores que oscilan de -3,402823466e+38 a 3,402823466e+38. Esta es la opción predeterminada. Entero—El ráster de salida utilizará una profundidad de bit de enteros apropiada. Esta opción redondea los valores z al número entero más cercano y escribe el número entero en cada valor de celda ráster.	String
Método (Opcional)	Método de interpolación que se utilizará para calcular los valores de las celdas. Lineal—Aplica un peso basado en la distancia al valor Z de cada nodo del triángulo que abarca el centro de una celda dada y, a continuación, suma los valores ponderados para asignar el valor de celda. Esta es la opción predeterminada. Vecinos naturales—Aplica un esquema de pesos basado en el área que utiliza polígonos Voronoi para determinar los valores de celda.	String
Distancia de Muestra (Opcional)	El método de muestreo y distancia utilizados para definir el tamaño de celda del ráster de salida. Observaciones—Define el número de celdas que divide el lado más largo del ráster de salida. Este método se utiliza de manera predeterminada con el valor de 250. Tamaño de celda—Define el tamaño de celda del ráster de salida.	String
Resolución de nivel de pirámide (Opcional)	La tolerancia Z o la resolución del tamaño de la ventana del nivel de pirámide de terreno que se utilizará. El valor predeterminado es 0, o resolución completa.	Double
Valor de muestra	El valor que corresponde a la Distancia de muestra para especificar el tamaño de celda del ráster de salida.	Double

arcpy.ddd.TerrainToRaster(in_terrain, out_raster, {data_type}, {method}, {sample_distance}, {pyramid_level_resolution}, sample_value)

Nombre	Explicación	Tipo de datos
in_terrain	El dataset de terreno que se va a procesar.	Terrain Layer
out_raster	Ubicación y nombre del ráster de salida. Al almacenar un dataset ráster en una geodatabase o en una carpeta como una Cuadrícula de Esri, no agregue una extensión de archivo al nombre del dataset ráster. Se puede indicar una extensión de archivo para definir el formato del ráster al almacenarlo en una carpeta, como .tif para generar un GeoTIFF o .img para generar un archivo con el formato ERDAS IMAGINE. Si el ráster se almacena como un archivo TIFF o en una geodatabase, su tipo de compresión de ráster y la calidad se pueden especificar utilizando la configuración del entorno de geoprocesamiento.	Raster Dataset
data_type (Opcional)	Especifica el tipo de valores numéricos almacenados en el ráster de salida. FLOAT—El ráster de salida utilizará un punto flotante de 32 bits, que admite valores que oscilan de -3,402823466e+38 a 3,402823466e+38. Esta es la opción predeterminada. INT—El ráster de salida utilizará una profundidad de bit de enteros apropiada. Esta opción redondea los valores z al número entero más cercano y escribe el número entero en cada valor de celda ráster.	String
method (Opcional)	Método de interpolación que se utilizará para calcular los valores de las celdas. LINEAR—Aplica un peso basado en la distancia al valor Z de cada nodo del triángulo que abarca el centro de una celda dada y, a continuación, suma los valores ponderados para asignar el valor de celda. Esta es la opción predeterminada. NATURAL_NEIGHBORS—Aplica un esquema de pesos basado en el área que utiliza polígonos Voronoi para determinar los valores de celda.	String
sample_distance sampling_method distance (Opcional)	El método de muestreo y distancia utilizados para definir el tamaño de celda del ráster de salida. OBSERVATIONS—Define el número de celdas que divide el lado más largo del ráster de salida. Este método se utiliza de manera predeterminada con el valor de 250. CELLSIZE—Define el tamaño de celda del ráster de salida.	String
pyramid_level_resolution (Opcional)	La tolerancia Z o la resolución del tamaño de la ventana del nivel de pirámide de terreno que se utilizará. El valor predeterminado es 0, o resolución completa.	Double
sample_value	El valor que corresponde a la Distancia de muestra para especificar el tamaño de celda del ráster de salida.	Double

Muestra de código

Ejemplo 1 de TerrainToRaster (ventana de Python)

En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python.

arcpy.env.workspace = "C:/data"
arcpy.TerrainToRaster_3d("sample.gdb/featuredataset/terrain", "terrain.tif", 
                         data_type="FLOAT", method="LINEAR", 
                         sample_distance="CELLSIZE 10", pyramid_level_resolution=2.5)

Ejemplo 2 de TerrainToRaster (script independiente)

En el siguiente ejemplo se muestra cómo usar esta herramienta en un script independiente de Python.

'''*********************************************************************
Name: TerrainToRaster Example
Description: This script demonstrates how to use the 
             TerrainToRaster tool.
             
**********************************************************************'''
# Import system modules
import arcpy

# Set environment setting
arcpy.env.workspace = "C:/data"

# Set Local Variables
terrain = "sample.gdb/featuredataset/terrain"
bitType = "INT"
method = "LINEAR"
sampling = "CELLSIZE 10"
pyrLvl = 2.5
outRas = arcpy.CreateUniqueName("terrain_level.img")

#Execute TerrainToRaster
arcpy.ddd.TerrainToRaster(terrain, outRas, bitType, 
                          method, sampling, pyrLvl)

Entornos

Espacio de trabajo actual, Sistema de coordenadas de salida, Extensión, Alinear ráster, Pirámide, Compresión, Palabra clave CONFIG de salida, Auto ejecución, Estadísticas de ráster, Uso de memoria de terreno

Casos especiales

Información de licenciamiento

Basic: Requiere 3D Analyst
Standard: Requiere 3D Analyst
Advanced: Requiere 3D Analyst