NAME

Astro::FITS::HdrTrans::JCMT - class combining common behaviour for modern JCMT instruments

METHODS

translate_from_FITS

This routine overrides the base class implementation to enable the caches to be cleared for target location.

This means that some conversion methods (in particular those using time in a base class) may not work properly outside the context of a full translation unless they have been subclassed locally.

Date fixups are handled in a super class.

to_UTDATE

Converts the date in a date-obs header into a number of form YYYYMMDD.

to_UTEND

Converts UT date in a date-end header into Time::Piece object

to_UTSTART

Converts UT date in a date-obs header into Time::Piece object.

to_RA_BASE

Uses the elevation, azimuth, telescope name, and observation start time headers (ELSTART, AZSTART, TELESCOP, and DATE-OBS headers, respectively) to calculate the base RA.

Returns the RA in degrees.

to_DEC_BASE

Uses the elevation, azimuth, telescope name, and observation start time headers (ELSTART, AZSTART, TELESCOP, and DATE-OBS headers, respectively) to calculate the base declination.

Returns the declination in degrees.

to_TAU

Use the average WVM tau measurements.

to_SEEING

Use the average seeing measurements.

to_OBSERVATION_ID_SUBSYSTEM

Returns the subsystem observation IDs associated with the header. Returns a reference to an array. Will be empty if the OBSIDSS header is missing.

to_SUBSYSTEM_IDKEY

to_DOME_OPEN

Uses the roof and door status at start and end of observation headers to generate a combined value which, if true, confirms that the dome was fully open throughout. (Unless it closed and reopened during the observation.)

from_DOME_OPEN

Converts the DOME_OPEN value back to individual roof and door status headers.

to_REMOTE

Convert between the JCMT's OPER_LOC header and a standardised 'REMOTE value'.

REMOTE = 1 LOCAL = 0

If not defined or has a different value, return 'undef'

from_REMOTE

Converts the REMOTE value back to the OPER_LOC header if REMOTE=1, oper_loc='REMOTE' if REMOTE=0, oper_loc='LOCAL' if REMOTE is anything else, return undef;

PRIVATE METHODS

_calc_coords

Function to calculate the coordinates at the start of the observation by using the elevation, azimuth, telescope, and observation start time. Caches the result if it's already been calculated.

Returns an Astro::Coords object.

_middle_value

Returns the value from the middle of an array reference. If that is not defined we start from the beginning until we find a defined value. Return undef if we can not find anything.

SEE ALSO

Astro::FITS::HdrTrans, Astro::FITS::HdrTrans::Base, Astro::FITS::HdrTrans::JAC.

AUTHORS

Anubhav <a.agarwal@jach.hawawii.edu>, Brad Cavanagh <b.cavanagh@jach.hawaii.edu>, Tim Jenness <t.jenness@jach.hawaii.edu>.

COPYRIGHT

Copyright (C) 2009, 2011, 2012, 2014 Science and Technology Facilities Council. Copyright (C) 2016 East Asian Observatory. All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place,Suite 330, Boston, MA 02111-1307, USA