DENSITY

Description

Converts a point layer to a raster representative of either the density per square unit of the points or the density of an attribute (z-value) of the points.

Parameters

Name	Type	Caption	Length	Value range
FILI *	String	Input file name	1 - 192
FILO	String	Output file name	0 - 192
DBVS *	Integer	Input vector segment	1 - 1
DBIB	Integer	Input bitmap segment	0 - 1
DBOC	Integer	Output raster channel	0 - 1
UNITS	String	Density units	0 - 17	See Details Default: Square Kilometers
SAMPRAD *	Float	Sampling radius	1 - 1	0.0 -
MAXNEIGH	Integer	Maximum number of neighbors	0 - 1	1 - Default: 10
NODATVAL	Float	No Data value	0 - 1	Default: -1e+008
PIXRES	Float	Output pixel resolution (m)	0 - 2
DENSTYPE	String	Density type	0 - 9	POINT | ATTRIBUTE Default: POINT
FLDNME	String	Attribute field name	0 - 64
REPORT	String	Report mode	0 - 192	Quick links
MONITOR	String	Monitor mode	0 - 3	ON, OFF Default: ON

* Required parameter

Parameter descriptions

FILI

Specifies the name of the PCIDSK file that contains the input point layer.

FILO

Specifies the name of the PCIDSK image file to receive the output raster channel. If the output file is not specified, it will be assumed to be the same as FILI. If the specified output file exists, its projection must be the same as FILI.

If FILO does not exist, a new PCIDSK file will be created. By default, the georeferencing information from FILI will be copied to the new FILO. If an output pixel resolution is specified and is different from that of the input file, the extents of the output file will be different.

Output channels should be of type 32R.

DBVS

Specifies the vector segment that contains the input point layer.

DBIB

Specifies the bitmap segment to restrict the region when generating the weighted average. The results will be generated inside the bitmap segment (value 1) and pixels falling outside the bitmap (value 0) will be given a "No Data" value.

The Bitmap layer also defines the geoereferencing of the output raster, if it is used.

DBOC

Specifies the output raster channel to receive converted point layer.

If the output file already exists, the output channel must be specified and must already exist.

If the output file does not exist, this parameter is ignored.

The output channel must be 32-bit real (CHN_32R).

UNITS

Specifies the units for the calculated density.

SAMPRAD

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

MAXNEIGH

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.

NODATVAL

Specifies a "No Data" (background) value for all channels.

If this parameter is not specified, the No Data value for each channel defaults to "-1e+008".

Areas with the "No Data" value are excluded from processing.

PIXRES

Specifies the pixel resolution (X,Y) for the output raster channel.

If this parameter is not specified, the projection information is taken from the georeferencing segment of the input file. The pixel resolution (size) is used to determine the number of pixels and lines in the output file. Decreasing the pixel size results in a larger output file and increased computation time.

This parameter applies only when a new output file (FILO) is being created.

DENSTYPE

Specifies whether to calculate the density for points or for an attribute.

If POINT is specified, the FLDNME (Attribute) value is ignored.

FLDNME

Specifies the name of the attribute whose value is to be used to grid the polygons. If this parameter is specified as (Z-COORD), the z-coordinate of the first vertex of each vector shape is used. If the specified attribute does not exist and it is not Z-COORD, the ShapeID of the vector shapes are used for gridding.

This parameter is not used if the density type (DENSTYPE) is set to POINT.

REPORT

Specifies where to direct the generated report.

Available options are:

• TERM: generates a report on the terminal (default)
• DISK: generates a report on file "IMPRPT.LST"
• OFF: turns off report generation
• <filename>: appends a report to the specified file

MONITOR

The program progress can be monitored by printing the percentage of processing completed. A system parameter, MONITOR, controls this activity.

Available options are:

• ON: Turns the monitor ON (default)
• OFF: Turns the monitor OFF (recommended if running in batch or background mode)

Details

DENSITY generates a surface by applying a sampling radius to each point in the input point layer. No output values are calculated for areas lying outside the sampling radius.

The value for each pixel in the output raster is calculated based on the value of each point whose sampling radius overlaps the center of that pixel. You can specify the size of the sampling radius (SAMPRAD).

The density function is able to generate a surface representative of the density per square unit of the points or of the density of an attribute; for example, population.

If the number of points influencing the pixel is 1, then:

density is Z/PI*d^2

If the number of points influencing a pixel is greater than 1, then:

density is Z(i)/PI*d(i)^2

Example

A point layer is stored in segment 32 of the file 'irvine.pix'. Density is calculated in 'Square Meters,' along with the default sample radius and maximum neighbors. The output raster is saved in channel 1 of type 32R.

EASI>fili	=	"IRVINE.PIX"
EASI>filo	=	"OIRVINE.PIX"	! output file will be created
EASI>dbvs	=	32	! vector segment containing point layer
EASI>dbib	=		! no bitmap mask
EASI>dboc	=	1	! output raster channel
EASI>units	=	"Square Meters"	! density units
EASI>samprad	=	100	! sampling radius
EASI>maxneigh	=		! default, 10
EASI>nodatval	=		! default, -1e+008
EASI>pixres	=	30,30	! pixel resolution 30x30m
EASI>denstype	=		! default, POINT
EASI>fldnme	=		! ignored if DENSTYPE is POINT

EASI>RUN DENSITY