Resumen
Convierte entidades multiparche en un dataset ráster.
Ilustración
Uso
El ráster de salida almacena los valores Z de las entidades multiparche de entrada en cada ubicación de centro de celda. Para determinar el valor Z para cada celda, se extiende una línea vertical desde la ubicación de centro de celda hasta intersecar con las entidades multiparche de entrada. El valor Z máximo de los puntos de intersección se asigna al ráster de salida. Una celda de salida recibirá un valor si el centro de celda cae dentro de la huella de una o varias entidades multiparche de entrada; de lo contrario, se le asignará NoData.
Los triángulos verticales, esencialmente paredes verticales sin tejado, se excluyen de la rasterización, por lo que no se representarán en el ráster de salida.
El Tamaño de celda de salida se puede definir mediante un valor numérico u obtenerse desde un dataset ráster existente. Si el tamaño de celda no se ha especificado explícitamente como el valor del parámetro, se deriva del entorno Tamaño de celda si se ha especificado. Si no se ha especificado el tamaño de celda del parámetro ni el tamaño de celda del entorno, pero se ha configurado el entorno Ráster de alineación, se usa el tamaño de celda del ráster de alineación. Si no se especifica nada, el tamaño de celda se calcula a partir de la anchura o la altura menor de la extensión dividida por 250, donde la extensión se encuentra en el Sistema de coordenadas de salida especificado en el entorno.
Si el tamaño de celda se ha especificado usando un valor numérico, la herramienta lo utilizará directamente para el ráster de salida.
Si el tamaño de celda se ha especificado mediante un dataset ráster, el parámetro mostrará la ruta del dataset ráster en lugar del valor del tamaño de celda. El tamaño de celda de ese dataset ráster se usa directamente en el análisis, siempre que la referencia espacial del dataset sea la misma que la referencia espacial de salida. Si la referencia espacial del dataset es diferente, se proyecta en función del Método de proyección de tamaño de celda seleccionado.
Esta herramienta le permite copiar entidades de edificios en 3D (como multiparches) de un espacio urbano en un Modelo digital de elevación (DEM). Para llevarlo a cabo, primero debe utilizar esta herramienta para convertir las entidades multiparche en un ráster. A continuación, use la herramienta Mosaico para crear un mosaico de los ráster de edificios con el ráster DEM. Con el ráster de elevación obtenido puede ejecutar otras herramientas que funcionen con los datos ráster para solucionar problemas de análisis en un espacio urbano. Por ejemplo, puede ejecutar la herramienta Cuenca visual para calcular la visibilidad o las herramientas de radiación solar para calcular el potencial de energía solar en el techo de los edificios en un entorno urbano.
De forma predeterminada, esta herramienta aprovecha los procesadores multinúcleo. El número máximo de núcleos que se pueden utilizar es cuatro.
Para emplear menos núcleos, utilice la configuración de entorno Factor de procesamiento en paralelo.
Sintaxis
arcpy.conversion.MultipatchToRaster(in_multipatch_features, out_raster, {cell_size})
Parámetro | Explicación | Tipo de datos |
in_multipatch_features | Las entidades multiparche de entrada que se convertirán a un ráster. | Feature Layer |
out_raster | El dataset ráster de salida que se creará. Será del tipo punto flotante. Si el ráster de salida no se va a guardar en una geodatabase, especifique .tif para formato de archivo TIFF, .CRF para un formato de archivo CRF, .img para un formato de archivo ERDAS IMAGINE o ninguna extensión para el formato ráster de cuadrícula de Esri. | Raster Dataset |
cell_size (Opcional) | Tamaño de celda del ráster de salida que se crea. Este parámetro se puede definir mediante un valor numérico u obtenerse desde un dataset ráster existente. Si el tamaño de celda no se ha especificado explícitamente como el valor del parámetro, se usa el valor del tamaño de celda del entorno, en caso de que se haya especificado; de lo contrario, se utilizan reglas adicionales para calcularlo a partir de las demás entradas. Consulte Usos para obtener más detalles. | Analysis Cell Size |
Muestra de código
En este ejemplo se convierte un shapefile de multiparche en un ráster y se guarda el ráster de salida en formato IMG.
import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.MultipatchToRaster_conversion("buildings.shp",
"c:/output/outbuildings.img", 0.25)
En este ejemplo se convierte un shapefile de multiparche en un ráster y se guarda el ráster de salida en formato TIFF.
# Name: MultipatchToRaster_Ex_02.py
# Description: Converts multipatch features to a raster dataset.
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inFeatures = "buildings.shp"
outRaster = "c:/output/outbuildings.tif"
cellSize = 0.5
# Execute MultipatchToRaster
arcpy.MultipatchToRaster_conversion(inFeatures, outRaster, cellSize)
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí