--------------------------------------------------------------------------------
MODULE    IFILTER

-------------------------------------------------------------------------------- REPLACES A variety of Laser-Scan smoothing and filtering programs.

--------------------------------------------------------------------------------

FUNCTION

--------------------------------------------------------------------------------

FORMAT

--------------------------------------------------------------------------------

PROMPT

--------------------------------------------------------------------------------

PARAMETERS

--------------------------------------------------------------------------------

COMMAND QUALIFIERS

--------------------------------------------------------------------------------

RESTRICTIONS

-------------------------------------------------------------------------------

DESCRIPTION

--------------------------------------------------------------------------------

EXAMPLES

$ IFILTER CCB2 NEW_CCB2
 ELAPSED:    0 00:00:07.91  CPU: 0:00:03.20  BUFIO: 5  DIRIO: 54  FAULTS: 152 
$

$ IFILTER/MCCONALOGUE=(SEPARATION:0.3,CHORD:0.2,DEVIATION:0.15)/NODP -
_$ CCB2 NEW_CCB2
 ELAPSED:    0 00:00:13.21  CPU: 0:00:03.37  BUFIO: 4  DIRIO: 53  FAULTS: 109 
$

$ IFILTER/AKI=(SEP:0.3,CHO:0.2)/BUN=(MIN:0.3,LAT:0.2)/LAY=(1,2)/LOG -
_$ OEEPECON CONTOURS1
%LSLLIB-I-IFFOPENED, DUA0:[LSL.IFF]OEEPECON.IFF;12 opened for read
%LSLLIB-I-IFFOPENED, DUA0:[LSL.IFF]CONTOURS1.IFF;1 opened for write
%IFILT-I-LAYERPROC, layer 1 being processed
%IFILT-I-FEATCOPY, FSN 45 (3) copied without modification
%IFILT-I-FEATCOPY, FSN 71 (12) copied without modification
%IFILT-I-FEATCOPY, FSN 135 (17) copied without modification
%IFILT-I-LAYERPROC, layer 2 being processed
%IFILT-I-FEATCOPY, FSN 158 (25) copied without modification
%IFILT-I-FEATCOPY, FSN 159 (26) copied without modification
%IFILT-I-FEATCOPY, FSN 160 (27) copied without modification
%IFILT-I-FEATCOPY, FSN 161 (28) copied without modification
%IFILT-I-FEATCOPY, FSN 162 (29) copied without modification
%IFILT-I-FEATCOPY, FSN 163 (30) copied without modification
%IFILT-I-FEATCOPY, FSN 164 (31) copied without modification
%IFILT-I-LAYERCOPY, layer 32 being copied without modification
%IFILT-I-FEATCOPY, FSN 9996 (51) copied without modification
%IFILT-I-FEATCOPY, FSN 9997 (52) copied without modification
%IFILT-I-FEATCOPY, FSN 9998 (53) copied without modification
%IFILT-I-FEATCOPY, FSN 9999 (54) copied without modification
 ELAPSED:    0 00:02:29.06  CPU: 0:00:50.56  BUFIO: 28  DIRIO: 375  FAULTS: 117 
$

$ IFILTER/LIN=SEP:0.4/DP=LAT:0.8/FILTER OEEPECON CONTOURS2
 ELAPSED:    0 00:02:36.92  CPU: 0:01:01.70  BUFIO: 26  DIRIO: 1641  FAULTS: 153
$

$ IFILTER/BUN=(MIN:0.2,MAX:0.5,LAT:0.3) OEEPECON FILT_CON
%IFILT-E-INVMINLAT, /BUNCH - MIN_SEP less than LATERAL
 ELAPSED:    0 00:00:00.58  CPU: 0:00:00.22  BUFIO: 1  DIRIO: 0  FAULTS: 89 
$

$ IFILTER/FILTER_FIRST CCB2 MY_CCB2
%CLI-W-CONFLICT, illegal combination of command elements - check documentation
 _\FILTER_FIRST_\
 ELAPSED:    0 00:00:00.39  CPU: 0:00:00.15  BUFIO: 2  DIRIO: 0  FAULTS: 95 
$

--------------------------------------------------------------------------------

MESSAGES (INFORMATIONAL)

These messages give information only, and require no immediate action by the user (except perhaps to verify that the correct options have been selected). Most will only appear if /LOG has been specified on the command line, unless they are used to provide supplementary information after an error has occurred.

--------------------------------------------------------------------------------

MESSAGES (WARNING)

These messages indicate that IFILTER has been unable to guarantee that a specified feature has been correctly processed, or that a specified IFF entry is correct.

--------------------------------------------------------------------------------

MESSAGES (ERROR)

These messages indicate an error in processing which has caused the program to terminate. The most likely causes are a corrupt or otherwise invalid input IFF file, or an error related to command line processing and file manipulation. It is most unlikely that any output file produced will be correctly processed.

--------------------------------------------------------------------------------

MESSAGE (FATAL)

This message indicates a fatal error in processing which has caused the program to terminate. No output IFF file will be produced.

--------------------------------------------------------------------------------

MESSAGES (OTHER)

In addition to the above messages which are generated by IFILTER itself, other messages may be produced by the command line interpreter (CLI) and by Laser-Scan libraries. In particular, messages may be generated by the IFF library. These are introduced by '%IFF' and are documented in the IFF library users' guide. In most cases IFF errors will be due to a corrupt input file, and this should be the first area of investigation. If the cause of the error cannot be traced by the user and Laser-Scan are consulted, then the input file should be preserved to facilitate diagnosis.