Raster To Multipoint (3D Analyst)


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



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

The input raster.

Raster Layer

The output feature class.

Feature Class

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


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.

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.

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


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

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

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


Related Topics

Licensing Information

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