NAME

Astro::FITS::HdrTrans::LCO - Base class for translation of LCO instruments

SYNOPSIS

use Astro::FITS::HdrTrans::LCO;

DESCRIPTION

This class provides a generic set of translations that are common to instrumentation from LCO. It should not be use directly for translation of instrument FITS headers.

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_AIRMASS_END

Set's the airmass at the end of the exposure. The AMEND is used if it exists, otherwise AIRMASS is used. In the case of neither existing, it is set to 1.0.

to_AIRMASS_START

Set's the airmass at the start of the exposure. The AMSTART is used if it exists, otherwise AIRMASS is used. In the case of neither existing, it is set to 1.0.

to_DEC_BASE

Converts the base declination from sexagesimal d:m:s to decimal degrees using the DEC keyword, defaulting to 0.0.

to_DR_RECIPE

Returns the data-reduction recipe name. The selection depends on the values of the OBJECT and OBSTYPE keywords. The default is "QUICK_LOOK". A dark returns "REDUCE_DARK", and an object's recipe is "JITTER_SELF_FLAT".

to_FILTER

Look for FILTER keyword first and if not found, concatenate the individual FILTERx keywords together, minus any that say "air"

to_NUMBER_OF_OFFSETS

Return the number of offsets. (dithers)

_to_OBSERVATION_NUMBER

Converts to the observation number. This uses the FRAMENUM keyword if it exists, otherwise it is obtained from the filename

to_OBSERVATION_TYPE

Determines the observation type from the OBSTYPE keyword. Almost a direct mapping except "EXPOSE" which needs mapping to OBJECT. Lambert may need extra handling in future

to_RA_BASE

Converts the base right ascension from sexagesimal h:m:s to decimal degrees using the RA keyword, defaulting to 0.0.

to_STANDARD

Returns whether or not the observation is of a standard source. It is deemed to be a standard when the OBSTYPE keyword is "STANDARD".

to_XBINNING

Determines the binning in the X direction of the frame. We look for XBINNING if it exists, otherwise we look for the CCDSUM keyword and extract the first part.

to_YBINNING

Determines the binning in the Y direction of the frame. We look for YBINNING if it exists, otherwise we look for the CCDSUM keyword and extract the second part.

dms_to_degrees

Converts a sky angle specified in d m s format into decimal degrees. The argument is the sexagesimal-format angle.

hms_to_degrees

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.

REVISION

$Id: LCO.pm 5661 2012-05-10 17:29:10Z tlister $

SEE ALSO

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

AUTHOR

Tim Lister <tlister@lcogt.net>

COPYRIGHT