De ráster a multipunto—Ayuda

Resumen
Uso
Sintaxis
Muestra de código
Entornos
Información sobre licencias

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

RasterToMultipoint_3d (in_raster, out_feature_class, {out_vip_table}, {method}, {kernel_method}, {z_factor})

Parámetro	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á 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_THIN —No se aplicará ninguna simplificación. Esta es la opción predeterminada. ZTOLERANCE <value> —Exporta solo las celdas que son necesarias para mantener una superficie dentro del rango Z especificado para el ráster de entrada. El valor correspondiente refleja 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 <value> —Divide el ráster en teselas del mismo tamaño según el valor de simplificación y, a continuación, selecciona una o dos celdas que coinciden con los criterios definidos mediante el método kernel indicado. El valor correspondiente adopta de forma predeterminada 3, lo que significa que el ráster se dividiría en ventanas de 3 x 3 celdas. VIP <value> —Utiliza 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 van a exportar. El valor correspondiente refleja el rango de percentiles a lo largo del histograma de las 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. VIP_HISTOGRAM —Crea 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. MIN —Se 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. MAX —Se crea un punto en la celda con el valor de elevación más grande que se encuentra en la vecindad kernel. MINMAX —Se crean dos puntos en las celdas con los valores Z más grandes y más pequeños encontrados en la vecindad kernel. MEAN —Se 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

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.

import arcpy
from arcpy import env

arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.RasterToMultipoint_3d("elevation.tif", "","elev_VIP.dbf", "VIP_HISTOGRAM", "", "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
from arcpy import env
import exceptions

try:
    arcpy.CheckOutExtension("3D")
    # Set default workspace
    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:
        "There are no IMG rasters in the " + env.workspace + " directory."
except Exception as e:
    # Returns any other error messages
    print e.message

Entornos

Información sobre licencias

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

ArcMap

De ráster a multipunto