CRCENTROID

Description

CRCENTROID is a vector and thematic raster operation that generates a point location (x-coordinate and y-coordinate) for each shape or pixel value in the input layer.

Parameters

Name	Type	Length	Value range
Input: Input file name  *	Vector or Raster port	1 -
OutputPoints: Centroids: Output file name	Vector port	0 -
Source Attributes	String	0 - 1	COPY, JOIN Default: COPY
Centroid	String	0 - 1	Default: Polygons
Report	String	0 - 192	See parameter description

* Required parameter

Parameter descriptions

Input: Input file name

Specifies the name of the file that contains the input vector or thematic raster data from which the centroids will be generated.

OutputPoints: Centroids: Output file name

Specifies the name of the PCIDSK image file that receives the point layer (centroids) generated from the input layer.

Source Attributes

Specifies whether the attributes from the source layer are copied or joined to the point (centroid) layer.

Centroid

Specifies whether the centroid is to be generated for polygons only or for all shapes. This parameter is only used when the input is a vector layer.

Valid values are: "Polygons only" or "All Shapes". "Polygons only" is the default.

Report

Specifies where to direct the generated report.

Available options are:

• LOG: generates a report on the terminal (default)
• <modulename.RPT>: appends a report to the module's RPT file
• DISK: generates a report on file "IMPRPT.LST"

Details

CRCENTROID generates centroids from a vector layer or thematic raster layer.

For vector layers, CRCENTROID creates centroids for polygons only or for all shapes in the layer. If the shape is a point, the resulting centroid is the same as the point. If the shape is a line, the resulting centroid is a point at the center of the line (not necessarily on a vertex of the shape). The generated coordinates are of the same projection as the input polygon layer. The point layer has only one attribute, which is the shape ID of the shape from which the point is generated. The attributes of the source shape are joined or copied to the corresponding point in the point layer.

For thematic rasters, a point is generated for each attribute record. The centroid is contained in the biggest contiguous area. If you want a centroid for each contiguous area of pixels, use RAS2PNT.