POTMAPSTAT

Convert points to raster, based on statistical techniques


EnvironmentsPYTHON :: EASI :: MODELER
Batch ModeYes
Quick linksDescription :: Parameters :: Parameter descriptions :: Details

Back to top

Description


POTMAPSTAT (potential mapping statistics) converts a vector point segment to a surface representative of a statistical model of a selected attribute, referred to as a z-value, of the points. Because an averaging technique is used, this function does not create any new values greater than the maximum value of the input data or less than the minimum value of the input data. This function considers the input point data to be a sample data set as defined by the study of statistics.
Back to top

Parameters


Name Type Length Value range
InputPoints: Input vector segment * Vector port 1 - 1  
Bitmap: Input bitmap segment Bitmap port 0 - 1  
InputArea: Georeferencing segment GEO port 0 - 1  
Output: Output raster channel Raster port 0 - 1  
Sampling Radius * Float 1 - 1  
Maximum Neighbors Integer 0 - 1 1 -
Default: 10
No Data Value Float 0 - 1 Default: 0.0
Pixel X Size Float 0 - 1  
Pixel Y Size Float 0 - 1  
Statistic String 0 - 1 POINT | ATTRIBUTE
Default: POINT
Attribute String 0 - 1  
Output Raster Type String 0 - 1 8U | 16U | 16S | 32R
Default: 32R
Function String 0 - 1 Default: Sum
Report String 0 - 192 See parameter description

* Required parameter
Back to top

Parameter descriptions

InputPoints: Input vector segment

Specifies the vector segment that contains the points to convert.

Bitmap: Input bitmap segment

Specifies the bitmap segment that restricts the region to process when generating the weighted average. The results will be generated inside the bitmap segment (value 1); any pixels falling outside the bitmap (value 0) will be assigned a "No Data" value.

InputArea: Georeferencing segment

Specifies the georeferencing of the output raster channel, including the projection, geographic extents, and resolution of the resulting output channel.

If this parameter is not set, the projection of the output channel will be the same as that of the input point segment. The geographic extents of the raster channel will be based on the extents of the point segment and the pixel X and Y size parameters.

Output: Output raster channel

Specifies the output raster channel to receive converted points.

If the output file already exists, this parameter must be specified and must exist. If the output file does not exist, this parameter is ignored.

Sampling Radius

Specifies the length of the sampling radius, in meters. The sampling radius is centered on each point in the raster channel to determine which points are used in the calculation.

Maximum Neighbors

Specifies the maximum number of points closest to the center of the pixel and whose radii overlap the center of the pixel to be considered in calculating an output value.

When points represent statistical data values such as population or income, the number of neighboring points should be greater than when the point data represents a non-statistical and continuous nature, such as elevation.

No Data Value

Specifies the No Data (background) value. Any output pixels that did not receive a calculated value are assigned a No Data value and are excluded from processing. This value should fall within the allowable range for the output raster type.

If this parameter is not specified, the No Data value for each channel defaults to "0.0"

Pixel X Size

Specifies the horizontal (X) pixel size, in meters, for the output raster layer projection.

If a georeferencing segment (InputArea) is specified, this parameter ignored.

Pixel Y Size

Specifies the vertical (Y) pixel size, in meters, for the output raster layer projection.

If a georeferencing segment (InputArea) is specified, this parameter ignored.

Statistic

Specifies whether to use an attribute to generate the raster, or if the statistic is based on the number of points within the sample radius.

Available options are:

Attribute

Specifies the attribute field name to use to generate the raster; for example, PixelValue.

If the density type (DENSTYP) parameter is 'ATTRIBUTE', this parameter must be specified.

Output Raster Type

Specifies the data type for the output image channel.

Valid data types are:
Note: If the specified output channel already exists, the data type from that output channel will be used instead of the one specified here.

Function

Specifies the function to use to generate the output raster.

The potential mapping function can generate the following six statistical models:

See the Details section for more information.

Report

Specifies where to direct the generated report.

Available options are:

Back to top

Details

This weighted-averaging technique generates a surface by applying a sampling radius to each point in the data segment. No output values are calculated for areas lying outside the sampling radius; these will be assigned a "No Data" value. The value of each raster pixel is calculated based on the value of each point whose sampling radius overlaps the center of the pixel.

You can specify the size of the sampling radius as well as the number of points closest to the center of the quad cell to be considered in the calculation of an output value Depending on the size of the radius, very different surfaces can be generated. A classification scheme can be applied to the output. This function is most appropriate for interval or ratio point data that represents a non-continuous phenomenon. Non-continuous phenomena is data typified by a high degree of variance and uneven distribution and is highly applicable to demographic and socioeconomic statistics such as population or income.

Statistical models

The potential mapping function can generate the following six statistical models:

© PCI Geomatics Enterprises, Inc.®, 2026. All rights reserved.