PISA2CAT - Converts a PISA formatted data file into a catalogue

Description:

PISA2CAT converts PISAFIND and PISAPEAK results files into catalogues. The output catalogues can be used by CURSA or CATPAC applications.

Usage:

pisa2cat datatype data cat

Parameters:

DATATYPE = LITERAL (Read)

The type of PISA data. Either FIND, SIZE or PEAK. FIND indicates that the input data is a results file produced by PISAFIND (RESULTS parameter) and that it contains the main object parameterisations (ie. position, total intensity, peak intensity etc. ). SIZE indicates that the input file is a results file from PISAFIND, but which contains the pixel sums within different intensity thresholds (from the SIZES parameter). Finally PEAK indicates that the input is a results file from the PISAPEAK routine. [FIND]

DATA = FILENAME (Read)

Name of the file containing the PISA results to be converted into a catalogue. [PISAFIND.DAT]

CAT = FILENAME (Write)

Name of the output catalogue. [FIND]

Examples:

pisa2cat find pisafind.dat find

This example converts the results file containing the object parameterisations from PISAFIND to FITS table format. It writes the results to the file find.FIT

pisa2cat peak pisapeak.dat peak.sdf

This example converts the output from a run of PISAPEAK into an HDS catalogue that can be used with the CATPAC applications.

Notes:

• The output format of the catalogue can be manipulated by changing the file extension. Without a file extension a binary FITS table is produced. If you add a ".sdf" extension then an HDS catalogue that can be used by CATPAC will be created.

Column_names

The column names used in the output catalogues are.

• DATATYPE = FIND
  INDEX XPOS YPOS INTENSITY NPIX PEAK ELLIPT ANGLE SXX SYY SXY

• DATATYPE = SIZE
  INDEX A1 A2 A3 A4 A5 A6 A7 A8

• DATATYPE = PEAK
  INDEX RRATIO IRATIO ELLIP ABSSXY