Astro::FITS::HdrTrans::ClassicCam - Magellan ClassicCam translations
use Astro::FITS::HdrTrans::ClassicCam; %gen = Astro::FITS::HdrTrans::ClassicCam->translate_from_FITS( %hdr );
This class provides a generic set of translations that are specific to Magellan ClassicCam observations.
The name of the instrument required to match (case insensitively) against the CHIP keyword to allow this class to translate the specified headers. Called by the default can_translate method.
CHIP
can_translate
$inst = $class->this_instrument();
Returns "ClassicCam".
Returns true if the supplied headers can be handled by this class.
$cando = $class->can_translate( \%hdrs );
For this class, in the absence of an INSTRUME keyword, the method will return true if the CHIP header exists and matches 'C-CAM'. It is not clear how robust this is, or over what range of epochs this keyword was written.
INSTRUME
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).
Sets a default airmass at the start of the observation if the AIRMASS keyword is not defined.
AIRMASS
Converts the base declination from sexagesimal d:m:s to decimal degrees using the DEC keyword, defaulting to 0.0.
DEC
Sets the declination scale in arcseconds per pixel. It has a fixed absolute value of 0.115 arcsec/pixel, but its sign depends on the declination. The scale increases with pixel index, i.e. has north to the top, for declinations south of -29 degrees. It is flipped north of -29 degrees. The default scale assumes north is up.
Returns the data-reduction recipe name. The selection depends on the value of the OBJECT keyword. The default is "QUICK_LOOK". A dark returns "REDUCE_DARK", a sky flat "SKY_FLAT_MASKED", a dome flat "SKY_FLAT", and an object's recipe is "JITTER_SELF_FLAT".
OBJECT
Stores the number of offsets using the UKIRT convention, i.e. adding one to the number of dither positions, and a default dither pattern of 5.
Stores the number of reads of the detector, with a default of 2, from the sum of keywords REASDS_EP and PRE_EP.
REASDS_EP
PRE_EP
Determines the observation type from the OBJECT keyword provided it is "DARK" for a dark frame, or "FLAT" for a flat-field frame. All other values of OBJECT return a value of "OBJECT", i.e. of a source.
Converts the base right ascension from sexagesimal h:m:s to decimal degrees using the RA keyword, defaulting to 0.0.
RA
Sets the right-ascension scale in arcseconds per pixel. It has a fixed absolute value of 0.115 arcsec/pixel, but its sign depends on the declination. The scale increases with pixel index, i.e. has east to the right, for declinations south of -29 degrees. It is flipped north of -29 degrees. The default scale assumes east is to the right.
Returns the UT date as Time::Piece object. It copes with non-standard format in DATE-OBS.
Time::Piece
DATE-OBS
Returns the UT time of the end of the observation as a Time::Piece object.
Returns the UT time of the end of the observation in HH:MM:SS format and stores it in the UTEND keyword.
UTEND
Returns an estimated UT time of the start of the observation as a Time::Piece object. The start time is derived from the end time, less the EXPTIME exposure time and some allowance for the read time.
EXPTIME
Returns the lower bound along the X-axis of the area of the detector as a pixel index.
Specifies the X-axis reference pixel near the frame centre.
Returns the upper bound along the X-axis of the area of the detector as a pixel index.
Returns the lower bound along the Y-axis of the area of the detector as a pixel index.
Specifies the Y-axis reference pixel near the frame centre.
Returns the upper bound along the Y-axis of the area of the detector as a pixel index.
These are ClassicCam-specific helper routines.
Converts a sky angle specified in d:m:s format into decimal degrees. The argument is the sexagesimal-format angle.
Returns the detector speed in seconds. It uses the SPEED to derive a time in decimal seconds. The default is 0.743.
SPEED
Returns the UT date in YYYYMMDD format. It parses the non-standard ddMmmyy DATE-OBS keyword.
Returns the UT time of the end of observation in decimal hours from the UT keyeword.
UT
Converts a sky angle specified in h:m:s format into decimal degrees. It takes no account of latitude. The argument is the sexagesimal format angle.
Returns the detector bounds in pixels of the region of the detector used. The region will be one of the four quadrants or the full detector. We guess for the moment that keword QUAD values of 1, 2, 3, 4 correspond to lower-left, lower-right, upper-left, upper-right quadrants respectively, and 5 is the whole 256x256-pixel array.
QUAD
$Id: ClassicCam.pm 14879 2008-02-13 21:51:31Z timj $
Astro::FITS::HdrTrans, Astro::FITS::HdrTrans::UKIRT.
Astro::FITS::HdrTrans
Astro::FITS::HdrTrans::UKIRT
Malcolm J. Currie <mjc@jach.hawaii.edu> Tim Jenness <t.jenness@jach.hawaii.edu>.
Copyright (C) 2008 Science and Technology Facilities Council. Copyright (C) 1998-2007 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.
To install Astro::FITS::HdrTrans, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Astro::FITS::HdrTrans
CPAN shell
perl -MCPAN -e shell install Astro::FITS::HdrTrans
For more information on module installation, please visit the detailed CPAN module installation guide.