Description:
Create a selection of rows in a
catalogue for which the fields for a specified column lie in a given range.
A field is selected if it lies in the range:
field value .GE. MINRNG .AND. field value .LE. MAXRNG
The selection may be created from either a genuine catalogue or some previous selection from a
catalogue.
The specified column must be sorted in ascending or descending order (eventually
the routine will be enhanced to work on indexed columns too).
Invocation
CALL
CAT_SFND<t>
(CI, FI, MINRNG, MAXRNG, REJFLG; SI, NUMSEL, SIR, NUMREJ; STATUS)
Arguments
CI =
INTEGER (Given)
Input catalogue or selection from which the new selection is to be generated. Note
that CI may be either a catalogue or a selection identifier.
FI = INTEGER (Given)
Identifier to the
column whose fields will be selected to lie in the given range. The column must be sorted
into ascending or descending order (and known by CAT to be so sorted).
MINRNG =
<type>
(Given)
Minimum value which a field must satisfy to be selected.
MAXRNG =
<type>
(Given)
Maximum value which a field must satisfy to be selected.
REJFLG = LOGICAL (Returned)
Flag indicating whether or not a second selection of the rejected rows is to be created: .TRUE. - create
the catalogue of rejected rows, .FALSE. - do not create the catalogue of rejected rows.
SI = INTEGER (Returned)
Selection identifier to the set of selected rows.
NUMSEL =
INTEGER (Returned)
Number of rows selected.
SIR = INTEGER (Returned)
Optional
selection identifier to the set of rejected rows. If the rejected rows are not being retained
then SIR is set to the null identifier.
NUMREJ = INTEGER (Returned)
Number of rows
rejected.
STATUS = INTEGER (Given and Returned)
The global status.
Copyright
Copyright (C) 1999 Central Laboratory of the Research Councils
Bugs:
None known