Raster To Multipoint (3D Analyst)

Summary

Converts raster cell centers into multipoint features whose Z values reflect the raster cell value.

Usage

Syntax

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

The input raster.

Raster Layer
out_feature_class

The output feature class.

Feature Class
out_vip_table
(Optional)

The histogram table to be produced when VIP Histogram is specified for the Method parameter.

Table
method
(Optional)

The thinning method applied to generate the multipoint feature class.

  • NO_THINThe full resolution data will be output into a new multipoint feature class.
  • ZTOLERANCEThe maximum allowable difference in (z units) between the height of the input raster and the height of the output multipoint feature class. By default, the z tolerance is 1/10 of the z range of the input raster. The larger the tolerance, the more thinning, the fewer points output.
  • KERNELDefines the number of cells for a window. The default is 3, which translates into a 3 by 3 set of cells in the input raster. The individual cell values in each of these windows are evaluated. Then just one or two cells are chosen, depending on the KERNEL selection method. The larger the kernel size, the more thinning will be carried out, and the fewer points output.
  • VIPSelects a percentage of points from the input raster based on their significance. The significance is assessed using a roving 3 by 3 window.
  • VIP_HISTOGRAMCreates a table to view the actual significance values and the corresponding number of points associated with those values.
String
kernel_method
(Optional)

The selection method used for creating points when kernel thinning is specified in the Method parameter.

  • MINA point is created at the cell with the smallest elevation value found in the kernel neighborhood. This is the default.
  • MAXA point is created at the cell with the largest elevation value found in the kernel neighborhood.
  • MINMAXTwo points are created at the cells with the smallest and largest elevation values found in the kernel neighborhood.
  • MEANA point is created at the cell whose elevation value is closest to the average of the cells in the kernel neighborhood.
String
z_factor
(Optional)

The factor used for multiplying the elevation of the raster. Generally used to convert units between feet and meters.

Double

Code Sample

RasterToMultipoint example 1 (Python window)

The following sample demonstrates the use of this tool in the Python window:

import arcpy
from arcpy import env

arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.RasterToMultipoint_3d("elevation.tif", "","elev_VIP.dbf", "VIP_HISTOGRAM", "", "1")
RasterToMultipoint example 2 (stand-alone script)

The following sample demonstrates the use of this tool in a stand-alone Python script:

'''*********************************************************************
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

Environments

Related Topics

Licensing Information

ArcView: Requires 3D Analyst
ArcEditor: Requires 3D Analyst
ArcInfo: Requires 3D Analyst

6/10/2013