GENERALIZEPT

 

Move the points in a coverage to remove spatial conflict with other points and/or lines.  Like GENERALIZE2 AML but works with points instead of arcs.

__________________________________________________________________________

 

GENERALIZEPT <in_cover> <out_cover> <buffer_distance> {max_distance} <cell_size> {block_line_cover} {block_line_buffer} {block_point_cover} {block_point_buffer} {JOIN | NOJOIN} {sequence_item | DENSITY} {selection_file}

 

ARGUMENTS

 

<in_cover> - the input point coverage.

 

This coverage is not altered by GENERALIZEPT.  Manipulations to the input points are done in a copy of the <in_cover>.

 

<out_cover> - the name for the output point coverage.

 

The name must not be the name of an existing file or directory.

 

<buffer_distance> - the minimum desirable distance (in map units) between points in the <out_cover>.  Points that are within this tolerance will be separated, space permitting.

 

{max_distance} - the maximum distance (in map units) that a point can be moved.

 

If an opening is not found within the {max_distance}, then the point is not moved.

 

<cell_size> - the cell size for the temporary grids created during processing.

 

The smaller the cell size the more accurate the results, but the longer the processing time.

 

{block_line_cover} - the input arc coverage used to alter the location of the points in the <in_cover>.

 

<in_cover> points within the {block_line_buffer} of {block_line_cover} arcs will be moved outside of the buffer, space permitting.

 

By default no coverage is used.

 

{block_line_buffer} - the distance to buffer the arcs in the {block_line_cover}.

 

{block_point_cover} - the input point coverage used to alter the location of the points in the <in_cover>.

 

<in_cover> points within the {block_point_buffer} of {block_point_cover} points will be moved outside of the buffer, space permitting.

 

{block_point_buffer} - the distance to buffer the points in the {block_point_cover}.

 

{sequence_item | DENSITY} - how to sequence the points in the input coverage.

 

Sequence_item - the numeric item in the <in_cover> PAT that is used to sequence the input points.

 

By default the <in_cover># is used as the {sequence_item}.

 

Item values must be sequential starting with 1.

 

DENSITY - the input points are sequenced in descending order based on the density of points in the <in_cover>.

 

The reason for sequencing the points is that the points processed first by GENERALIZEPT are less likely to be moved than are points processed subsequently.  So points that aren't to be moved as much should be processed first.

 

{selection_file} - the ARCPLOT selection file that identifies which points can be moved.

 

All points not listed in the selection file are retained in the <out_cover> but are not moved.  However, these points are used to block the movement of the selected points.  The selected points will not be moved within the <buffer_distance> of the unselected points.

 

If no selection file is specified, then all points can be moved.

 

 

NOTES

 

GENERALIZEPT runs from the Grid module of ArcInfo.

 

 

EXAMPLES

 

Arc: &run generalizept

Usage: GENERALIZEPT <in_cover> <out_cover> <buffer_distance> {max_distance} <cell_size> {block_line_cover} {block_line_buffer} {block_point_cover} {block_point_buffer} {sequence_item | DENSITY} {selection_file}

 

1)  To move miscellaneous cultural point features so that they are at least 80 meters of roads and railroads to avoid overprinting at 1:126,720 map scale: first reselect the cultural points and create a selection file (named cult_point in this example), then run generalizept:

 

Arc: &run generalizept kell_pt kell_pt2 40 120 5 kell_trans 80 # # ~

Arc: density cult_point_sel