|
|
Process Help FILTPO - filter out coincident or adjacent XYZ points |
|
Process Name |
Menu Path |
Link to Command Table |
|
FILTPO |
Data ribbon | Data Tools | 3D Utilities | Filter Points |
Introduction
This process filters out coincident or adjacent points either within a single file or by using a second filter file.
How to use
The optional parameter @RADIUS allows the user to define a search radius within which points are considered to be coincident the first point will be copied to the output file.
If a filter file is used then points from the &IN1 file are copied to the &OUT file only if they do NOT lie within @RADIUS of a point in the &IN2 file.
The input points file (&IN1) must be sorted on the *X coordinate field.
Files, Fields and Parameters
Input Files
|
Name |
Description |
I/O Status |
Required |
Type |
|
IN1 |
Input points file. Must be sorted on X. |
Input |
Yes |
Undefined |
|
IN2 |
Optional filter points file. Must be sorted on X. |
Input |
No |
Undefined |
Output Files
|
Name |
I/O Status |
Required |
Type |
Description |
|
OUT |
Output |
Yes |
Undefined |
Output points file. |
Fields
|
Name |
Description |
Source |
Required |
Type |
Default |
|
X |
Field used as X coordinate for filter process. |
IN1 |
Yes |
Numeric |
Undefined |
|
Y |
Field used as Y coordinate for filter process. |
IN1 |
Yes |
Numeric |
Undefined |
|
Z |
Optional Z coordinate for filter process. |
IN1 |
No |
Numeric |
Undefined |
Parameters
|
Name |
Description |
Required |
Default |
Range |
Values |
|
RADIUS |
Optional, default = 0.0. Points within RADIUS of one another are filtered out. If Z is not defined, filter test is applied in a circle in the XY plane. If Z is defined filter test is applied within a sphere. |
No |
Undefined |
Undefined |
Undefined |
Notes
No additional notes.
Example
|
!FILTPO
|
&IN1(POINTS),&OUT(POINTS.F),*X(EAST),*Y(NORTH), |
Error and Warning Messages
|
Message |
Description |
Solution |
|
!!! MISSING INPUT POINTS FILE (&IN1) !!! |
The input points file was not specified. Fatal; the process is exited. |
|
|
|
|
|
|
!!! INVALID FILTER FILE (&IN2) !!! |
The specified filter file is not a valid filter file. Fatal; the process is exited. |
|
|
|
|
|
|
!!! MISSING OUTPUT POINTS FILE (&OUT1) !!! |
The output points file was not specified. Fatal; the process is exited. |
|
|
|
|
|
|
!!! FILTPO CANNOT FILTER IN-PLACE !!! |
An invalid in-place operation was attempted. Fatal; the process is exited. |
|
|
|
|
|
|
!!! ATTEMPT TO OPEN nnnnn FILE!!! |
The specified file could not be opened. Fatal; the process is exited. |
|
|
|
|
|
|
!!! n FIELD NOT NUMERIC !!! |
One of the fields in the input files which was expected to be numeric is not (e.g. X, Y, Z). Fatal; the process is exited. |
|
|
|
|
|
|
!!! n FIELD NOT AN EXPLICIT FIELD !!! |
One of the fields in the input files which was expected to be explicit is not (e.g. X, Y, Z). Fatal; the process is exited. |
|
|
|
|
|
|
!!! n FIELD MISSING !!! |
The specified field is missing from the input files. Fatal; the process is exited. |
|
|
|
|
|
|
!!! INVALID FILTER RADIUS PARAMETER !!! |
The specified radius parameter is incorrect. Fatal; the process is exited. |
|
|
|
|
|
|
!!! FILTER FILE NOT SORTED ON "X" FIELD !!! |
The input filter file is not sorted on the *X coordinate field. Fatal; the process is exited. |
|
|
|
|
|
