SpatialSort Command

Use the SpatialSort command in a Logic Template to sort results by distance from a defined coordinate pair, using a pair of fields containing numeric values. The values are assumed to be signed integers or fixed point data with an implied decimal point.

Integer values stored within a numeric field must be greater than -4294967296 and less than 4294967296. Values greater than or equal to 4294967296 will be treated as negative. Fixed point data with 2 implied decimal places must be greater than -42949672.96 and less than 42949672.96. The limits for fixed point data with other than 2 implied decimal places is adjusted in the same way by moving the decimal point.

To execute a Spatial Sort request, use the SpatialSort command with four arguments:

SpatialSort( fld1, fld2, cntr, pas );

SpatialSort Arguments

Argument

Description

fld1

The name of the data field containing the X coordinate to be sorted.

fld2

The name of the data field containing the Y coordinate to be sorted.

cntr

The name of the HTML variable containing the center point coordinate pair.

pas

The pass during which the sort is to be executed.

Access the SpatialSort Dialog Box by selecting the Spatial menu item under the Sorting category of the Logic Template editor command menu.

Examples

Command

Description

Center = { 32, 47 };

SpatialSort( _Field_X, _Field_Y, Center, 2);

Sort results by distance from the point with X coordinate 32 and Y coordinate 47 during pass 2. Use data coordinates stored in fields "_Field_X" and "_Field_Y".

IF ( Center )

 SpatialSort( _Field_X, _Field_Y, Center, 1);

ENDIF

Sort results by distance from the point with coordinates stored in HTML variable "Center" during pass 1, if "Center" is not empty. Use data coordinates stored in fields "_Field_X" and "_Field_Y".