ObservationInfo¶

class astro_metadata_translator.ObservationInfo(header, translator_class=None, pedantic=False)¶

Bases: object

Standardized representation of an instrument header for a single exposure observation.

Parameters:

header : dict-like: Representation of an instrument header accessible as a dict.
translator_class : MetadataTranslator-class, optional: If not None, the class to use to translate the supplied headers into standard form. Otherwise each registered translator class will be asked in turn if it knows how to translate the supplied header.
pedantic : bool, optional: If True the translation must succeed for all properties. If False individual property translations must all be implemented but can fail and a warning will be issued.

Raises:

ValueError: The supplied header was not recognized by any of the registered translators.
TypeError: The supplied translator class was not a MetadataTranslator.

Attributes Summary

`altaz_begin`	Telescope boresight azimuth and elevation at start of observation.
`boresight_airmass`	Airmass of the boresight of the telescope.
`boresight_rotation_angle`	Angle of the instrument in boresight_rotation_coord frame.
`boresight_rotation_coord`	Coordinate frame of the instrument rotation angle (options: sky, unknown).
`cards_used`	Header cards used for the translation.
`dark_time`	Duration of the exposure with shutter closed (seconds).
`datetime_begin`	Time of the start of the observation.
`datetime_end`	Time of the end of the observation.
`detector_exposure_id`	Unique integer identifier for this detector in this exposure.
`detector_name`	Name of the detector within the instrument (might not be unique).
`detector_num`	Unique (for instrument) integer identifier for the sensor.
`exposure_id`	Unique (with instrument) integer identifier for this observation.
`exposure_time`	Duration of the exposure with shutter open (seconds).
`instrument`	The instrument used to observe the exposure.
`location`	Location of the observatory.
`object`	Object of interest or field name.
`observation_id`	Label uniquely identifying this observation (can be related to ‘exposure_id’).
`observation_type`	Type of observation (currently: science, dark, flat, bias, focus).
`physical_filter`	The bandpass filter used for this observation.
`pressure`	Atmospheric pressure outside the dome.
`relative_humidity`	Relative humidity outside the dome.
`science_program`	Observing program (survey or proposal) identifier.
`telescope`	Full name of the telescope.
`temperature`	Temperature outside the dome.
`tracking_radec`	Requested RA/Dec to track.
`visit_id`	ID of the Visit this Exposure is associated with.

Methods Summary

stripped_header() Return a copy of the supplied header with used keywords removed.

Attributes Documentation

altaz_begin¶

Telescope boresight azimuth and elevation at start of observation.

Returns:	altaz_begin : `astropy.coordinates.AltAz` Access the property.

boresight_airmass¶

Airmass of the boresight of the telescope.

Returns:	boresight_airmass : `float` Access the property.

boresight_rotation_angle¶

Angle of the instrument in boresight_rotation_coord frame.

Returns:	boresight_rotation_angle : `astropy.coordinates.Angle` Access the property.

boresight_rotation_coord¶

Coordinate frame of the instrument rotation angle (options: sky, unknown).

Returns:	boresight_rotation_coord : `str` Access the property.

cards_used¶

Header cards used for the translation.

Returns:	used : `frozenset` of `str` Set of card used.

dark_time¶

Duration of the exposure with shutter closed (seconds).

Returns:	dark_time : `astropy.units.Quantity` Access the property.

datetime_begin¶

Time of the start of the observation.

Returns:	datetime_begin : `astropy.time.Time` Access the property.

datetime_end¶

Time of the end of the observation.

Returns:	datetime_end : `astropy.time.Time` Access the property.

detector_exposure_id¶

Unique integer identifier for this detector in this exposure.

Returns:	detector_exposure_id : `int` Access the property.

detector_name¶

Name of the detector within the instrument (might not be unique).

Returns:	detector_name : `str` Access the property.

detector_num¶

Unique (for instrument) integer identifier for the sensor.

Returns:	detector_num : `int` Access the property.

exposure_id¶

Unique (with instrument) integer identifier for this observation.

Returns:	exposure_id : `int` Access the property.

exposure_time¶

Duration of the exposure with shutter open (seconds).

Returns:	exposure_time : `astropy.units.Quantity` Access the property.

instrument¶

The instrument used to observe the exposure.

Returns:	instrument : `str` Access the property.

location¶

Location of the observatory.

Returns:	location : `astropy.coordinates.EarthLocation` Access the property.

object¶

Object of interest or field name.

Returns:	object : `str` Access the property.

observation_id¶

Label uniquely identifying this observation (can be related to ‘exposure_id’).

Returns:	observation_id : `str` Access the property.

observation_type¶

Type of observation (currently: science, dark, flat, bias, focus).

Returns:	observation_type : `str` Access the property.

physical_filter¶

The bandpass filter used for this observation.

Returns:	physical_filter : `str` Access the property.

pressure¶

Atmospheric pressure outside the dome.

Returns:	pressure : `astropy.units.Quantity` Access the property.

relative_humidity¶

Relative humidity outside the dome.

Returns:	relative_humidity : `float` Access the property.

science_program¶

Observing program (survey or proposal) identifier.

Returns:	science_program : `str` Access the property.

telescope¶

Full name of the telescope.

Returns:	telescope : `str` Access the property.

temperature¶

Temperature outside the dome.

Returns:	temperature : `astropy.units.Quantity` Access the property.

tracking_radec¶

Requested RA/Dec to track.

Returns:	tracking_radec : `astropy.coordinates.SkyCoord` Access the property.

visit_id¶

ID of the Visit this Exposure is associated with.

Science observations should essentially always be associated with a visit, but calibration observations may not be.

Returns:	visit_id : `int` Access the property.

Methods Documentation

stripped_header()¶

Return a copy of the supplied header with used keywords removed.

Returns:	stripped : `dict`-like Same class as header supplied to constructor, but with the headers used to calculate the generic information removed.

Navigation

ObservationInfo¶