De ráster a multipunto (3D Analyst)

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.

Sintaxis

arcpy.3d.RasterToMultipoint(in_raster, out_feature_class, {out_vip_table}, {method}, {kernel_method}, {z_factor}, {thinning_value})
ParámetroExplicaciónTipo 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á esta herramienta.

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.

  • NO_THINNo se aplicará ninguna simplificación. Esta es la opción predeterminada.
  • ZTOLERANCEExporta solo las celdas que son necesarias para mantener una superficie dentro de un rango Z especificado para el ráster de entrada.
  • KERNELDivide el ráster en teselas del mismo tamaño según el valor de simplificación especificado y, a continuación, selecciona una o dos celdas que coinciden con los criterios definidos mediante el método kernel indicado.
  • VIPUtiliza una ventana de colector de datos de 3 x 3 celdas que se utiliza para crear el plano tridimensional que mejor se ajusta. A cada celda se le asigna una puntuación de importancia según la desviación absoluta respecto a este plano. A continuación se utiliza un histograma de estas puntuaciones para determinar las celdas que se exportarán según el percentil indicado en el parámetro Valor de simplificación.
  • VIP_HISTOGRAMCrea una tabla a fin de ver los valores de importancia reales y la correspondiente cantidad de puntos asociados con esos valores.
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.

  • MINSe crea un punto en la celda con el valor de elevación más pequeño que se encuentra en la vecindad kernel. Esta es la opción predeterminada.
  • MAXSe crea un punto en la celda con el valor de elevación más grande que se encuentra en la vecindad kernel.
  • MINMAXSe crean dos puntos en las celdas con los valores Z más grandes y más pequeños encontrados en la vecindad kernel.
  • MEANSe crea un punto en la celda cuyo valor de elevación es más cercano al promedio de las celdas en la vecindad kernel.
String
z_factor
(Opcional)

El factor por el que se multiplicarán los valores z. Esto se utiliza generalmente para convertir las unidades lineales Z para que coincidan con las unidades lineales XY. El valor predeterminado es 1, que no altera los valores de elevación. Este parámetro está deshabilitado 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.

  • Tolerancia Z: la diferencia máxima permitida (en unidades z) entre el ráster de entrada y la superficie creada a partir de la clase de entidad multipunto de salida. Al seleccionar este método, el valor de simplificación adopta de forma predeterminada una décima parte del rango z del ráster de entrada.
  • Kernel: la cantidad de celdas ráster a lo largo del borde de cada tesela. Este valor adopta de forma predeterminada 3, lo que significa que el ráster se dividiría en ventanas de 3 x 3 celdas.
  • VIP: el rango de percentiles del histograma de puntuaciones de importancia. Se adopta de forma predeterminada el valor 5,0, lo que significa que se exportarán las celdas cuya puntuación se sitúe dentro del primer 5% del histograma.
Double

Muestra de código

Ejemplo 1 de RasterToMultipoint (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.RasterToMultipoint_3d("elevation.tif", out_vip_table="elev_VIP.dbf", 
                            method="VIP_HISTOGRAM", z_factor=1)
Ejemplo 2 de RasterToMultipoint (secuencia de comandos independiente)

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

Información de licenciamiento

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