| Etiqueta | Explicación | Tipo de datos |
Ráster de Entrada | El ráster que se va a procesar. | Raster Layer; Mosaic Layer |
Clase de entidad de salida | La clase de entidad que generará. | Feature Class |
Tabla VIP de salida (Opcional) | La tabla del histograma que se va a reproducir cuando se especifica el Histograma VIP para el parámetro Método. | Table |
Método de simplificación (Opcional) | El método de simplificación aplicado al ráster de entrada para seleccionar un subconjunto de celdas que se exportará a la clase de entidad multipunto.
| String |
Método kernel (Opcional) | El método de selección utilizado dentro de cada vecindad kernel cuando se aplica la simplificación kernel al ráster de entrada.
| String |
Factor Z (Opcional) | El factor por el que se multiplicarán los valores z. Generalmente se utiliza para convertir unidades lineales para que coincidan con las unidades lineales x,y. El valor predeterminado es 1, que no altera los valores de elevación. Este parámetro no está disponible si la referencia espacial de la superficie de entrada tiene un datum z con una unidad lineal especificada. | Double |
Valor de simplificación
(Opcional) | El significado de este valor dependerá del Método de simplificación especificado.
| Double |
Resumen
Convierte los centros de la celda ráster en entidades multipunto 3D cuyos valores Z reflejan el valor de la celda ráster.
Uso
Plantéese utilizar esta herramienta si tiene datos de elevación ráster y necesita acceder a las prestaciones funcionales de una superficie triangulada, dado que las entidades multipunto se pueden cargar en un dataset TIN o en un dataset de terreno.
Cuando el tamaño del ráster de entrada es muy grande, considere la posibilidad de aplicar un método de simplificación para reducir el número de celdas que se exportan a la clase de entidad multipunto.
- Utilice el método de simplificación Tolerancia Z cuando sea importante conservar la precisión vertical.
- Utilice el método de simplificación Kernel cuando sea importante controlar la distancia de muestra horizontal.
- Utilice el método de simplificación VIP si los multipuntos resultantes se van a aplicar principalmente para aplicaciones de visualización. Este método es relativamente rápido, genera como salida una cantidad de puntos predecible y es apto para seleccionar picos y depresiones locales. No obstante, es sensible al ruido y podría ignorar las entidades topográficas que abarcan una extensión superior a un área de 3 x 3 celdas.
- Utilice la opción Histograma VIP como paso inicial para aplicar el método de simplificación VIP, dado que genera un histograma de las puntuaciones más importantes que le permitirán conocer la cantidad de puntos que se seleccionarían con cada uno de los valores de percentil incremental.
Parámetros
arcpy.ddd.RasterToMultipoint(in_raster, out_feature_class, {out_vip_table}, {method}, {kernel_method}, {z_factor}, {thinning_value})| Nombre | Explicación | Tipo de datos |
in_raster | El ráster que se va a procesar. | Raster Layer; Mosaic Layer |
out_feature_class | La clase de entidad que generará. | Feature Class |
out_vip_table (Opcional) | La tabla del histograma que se va a reproducir cuando se especifica el Histograma VIP para el parámetro Método. | Table |
method (Opcional) | El método de simplificación aplicado al ráster de entrada para seleccionar un subconjunto de celdas que se exportará a la clase de entidad multipunto.
| String |
kernel_method (Opcional) | El método de selección utilizado dentro de cada vecindad kernel cuando se aplica la simplificación kernel al ráster de entrada.
| String |
z_factor (Opcional) | El factor por el que se multiplicarán los valores z. Generalmente se utiliza para convertir unidades lineales para que coincidan con las unidades lineales x,y. El valor predeterminado es 1, que no altera los valores de elevación. Este parámetro no está disponible si la referencia espacial de la superficie de entrada tiene un datum z con una unidad lineal especificada. | Double |
thinning_value (Opcional) | El significado de este valor dependerá del Método de simplificación especificado.
| Double |
Muestra de código
En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python.
arcpy.env.workspace = "C:/data"
arcpy.RasterToMultipoint_3d("elevation.tif", out_vip_table="elev_VIP.dbf",
method="VIP_HISTOGRAM", z_factor=1)En el siguiente ejemplo se muestra cómo usar esta herramienta en un script independiente de Python.
'''*********************************************************************
Name: RasterToMultipoint Example
Description: This script demonstrates how to use
the RasterToMultipoint tool to create multipoint datasets
fot all IMG rasters in a target workspace.
**********************************************************************'''
# Import system modules
import arcpy
# Set default workspace
arcpy.env.workspace = "C:/data"
# Create the list of IMG rasters
rasterList = arcpy.ListRasters("*", "IMG")
# Loop the process for each raster
if rasterList:
for raster in rasterList:
# Set Local Variables
# [:-4] strips the last 4 characters (.img) from the raster name
outTbl = "VIP_" + raster[:-4] + ".dbf"
method = "VIP_HISTOGRAM"
zfactor = 1
#Execute RasterToMultipoint
arcpy.ddd.RasterToMultipoint(raster, "",outTbl, method, "", zfactor)
else:
print("There are no IMG rasters in the " + env.workspace + " directory.")Entornos
Espacio de trabajo actual, Sistema de coordenadas de salida, Extensión, Transformaciones geográficas, Resolución XY, Tolerancia XY, Resolución Z, Tolerancia Z, Dominio XY de salida, Dominio Z de salida, Palabra clave CONFIG de salida, Auto ejecución
Casos especiales
Información de licenciamiento
- Basic: Requiere 3D Analyst
- Standard: Requiere 3D Analyst
- Advanced: Requiere 3D Analyst