### JCMTSTATE2CAT

convert JCMT state structure into TST format

#### Description:

Reads a set of SCUBA-2 or ACSIS files and writes a catalogue of the state information to standard out. The output file is in TST format and can be read into the TOPCAT application (but may require that TOPCAT is told explicitly that the catalogue is in TST format, e.g. with the "-f tst" command line option).

This information includes the telescope pointing position (Actual, Demand and Base) in both the tracking system and AZEL coordinate frames, jiggle patterns, telescope row/offset index amongst others.

#### Usage:

jcmtstate2cat *.sdf > catalogue.tst

topcat -f tst catalogue.tst

#### Parameters:

##### $-$help
Print help information.
##### $-$version
Print version information.
##### $-$man
Print the full documentation to STDOUT.
##### $-$$-$with$-$mce
Include SCUBA-2 MCE information in output table. This adds a lot of data to the output files and much of it is constant for the observation. Default is not to add this option. This option only works for data prior to summer of 2010 (which essentially means S2SRO data). After that date MCE data is written in a different form and is not supported. For modern data use the separate MCEHEAD2CAT command.

#### Notes:

Additional derived columns are included in addition to those stored directly in the JCMTSTATE extension. All telescope values include a correction for motion of the secondary mirror.

• RA/DEC

Tracking coordinates in degrees. The columns will have the same name even if the telescope was tracking in GALACTIC.

• DRA/DDEC

Tracking offsets from the base position in arcsec.

• AZ/EL

Azimuth and elevation in degrees. Calculated directly from JCMTSTATE without being converted to RA/Dec.

• DAZ/DEL

Azimuth and elevation offsets from the base position in arcsec.

• TELSPEED

Instantaneous telescope speed in arcsec/sec.

• WVMTAU

Zenith 225 GHz opacity derived from the water vapor radiometer.

• PWVZEN

Precipitable water vapor at the zenith in mm.

• PWVLOS

Precipitable water vaport in the line of sight in mm.

Note that information from the ACSIS extension is not included at this time. This is partly because this extension can change in shape between observations. MCE header information is included for SCUBA-2 data files.