The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Astro::FITS::HdrTrans::SCUBA2 - JCMT SCUBA-2 translations

DESCRIPTION

Converts information contained in SCUBA-2 FITS headers to and from generic headers. See Astro::FITS::HdrTrans for a list of generic headers.

METHODS

this_instrument

The name of the instrument required to match (case insensitively) against the INSTRUME/INSTRUMENT keyword to allow this class to translate the specified headers. Called by the default can_translate method.

  $inst = $class->this_instrument();

Returns "SCUBA-2".

COMPLEX CONVERSIONS

These methods are more complicated than a simple mapping. We have to provide both from- and to-FITS conversions All these routines are methods and the to_ routines all take a reference to a hash and return the translated value (a many-to-one mapping) The from_ methods take a reference to a generic hash and return a translated hash (sometimes these are many-to-many)

to_OBSERVATION_MODE

If Observation type is SCIENCE, return the sample mode, else return the sample mode and observation type. For example, "STARE", "SCAN", "SCAN_POINTING".

Do not currently take into account polarimeter or FTS.

to_SUBSYSTEM_IDKEY
to_DR_RECIPE

Fix up recipes that were incorrect in the early years of the observing tool.

Converts SASSy survey data to use the SASSy recipe.

to_POLARIMETER

Determine if POL-2 is in the beam, based on the INBEAM header.

from_POLARIMETER

Attempt to recreate the INBEAM header. Since this also depends on FTS-2, use the _reconstruct_INBEAM method.

to_FOURIER_TRANSFORM_SPECTROMETER

Determine if FTS-2 is in the beam, based on the INBEAM header.

from_FOURIER_TRANSFORM_SPECTROMETER

Attempt to recreate the INBEAM header. Since this also depends on POL-2, use the _reconstruct_INBEAM method.

_reconstruct_INBEAM

Since the INBEAM header becomes multiple generic headers, we need to look at them all to reconstruct it. In order to work within the confines of the Astro::FITS::HdrTrans::Base::translate_to_FITS method, we need to work on a per-generic header basis. This internal method can then be used for the "from_" method for each of these. It will end up returning the same INBEAM header each time -- the versions generated from different generic headers will overwrite eachother in the Base translate_to_FITS method but that shouldn't be a problem.

Note that the INBEAM header may not be reconstructed exactly. For example it will just include the short form "pol" even if it would originally have included specific POL-2 components instead.

SEE ALSO

Astro::FITS::HdrTrans, Astro::FITS::HdrTrans::Base

AUTHOR

Tim Jenness <t.jenness@jach.hawaii.edu>

COPYRIGHT

Copyright (C) 2007-2009,2011,2013 Science & Technology Facilities Council. Copyright (C) 2003-2005 Particle Physics and Astronomy Research Council. 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.