PISACUT - Separates a formatted file into two parts

Description:

This routine works on any formatted data files, applying a threshold to one of the variables. The variable is specified by a column number. File entries with variable value above and below the threshold are written out to separate files.

Usage:

PISACUT INPUT COLUMN THRESH LOWER HIGHER

Parameters:

INPUT = FILENAME (Read)

Name of a file containing the data to be separated by applying a threshold value to the variable in the specified column.

COLUMN = _INTEGER (Read)

The column which contains the data which is to be thresholded. [1]

THRESH = _REAL (Read)

The threshold value for variable in the given column. Entries with this variable value above the threshold will be entered to file HIGHER. Entries with a value less than or equal to this variable value will be entered into file LOWER. [0.0]

LOWER = FILENAME (Write)

Name of a file to contain the entries with selected variable value less than equal to the threshold.

HIGHER = FILENAME (Write)

Name of a file to contain the entries with selected variable value greater than the threshold.

Examples:

PISACUT INPUT=PISAPEAK.DAT COLUMN=2 THRESH=1.5 LOWER=STARS HIGHER=GALS

This separates the results from a run of the PISAPEAK program, whose results are stored in file PISAPEAK.DAT, into two different files STARS and GALS. The variable selected is the one found in column 2 (the object peakedness). Entries, in file PISAPEAK, with the variable value in column 2 greater than 1.5 are written into file GALS, those with selected variable value less than equal to 1.5 are written to file STARS.