SuprimeCamTranslator#

class astro_metadata_translator.SuprimeCamTranslator(header, filename=None)#

Bases: SubaruTranslator

Metadata translator for HSC standard headers.

Parameters:

header (Mapping[str, Any])
filename (str | ParseResult | ResourcePath | Path | None, default: None)

Attributes Summary

`all_properties`	All the valid properties for this translator including extensions.
`default_resource_root`	Default resource path root to use to locate header correction files.
`name`	Name of this translation class
`supported_instrument`	Supports the SuprimeCam instrument.

Methods Summary

`can_translate`(header[, filename])	Indicate whether this translation class can translate the supplied header.
`to_altaz_begin`()	Return value of altaz_begin from headers.
`to_boresight_airmass`()	Airmass of the boresight of the telescope.
`to_boresight_rotation_angle`()	Return value of boresight_rotation_angle from headers.
`to_boresight_rotation_coord`()	Coordinate frame of the instrument rotation angle (options: sky, unknown).
`to_dark_time`()	Duration of the exposure with shutter closed (seconds).
`to_datetime_begin`()	Calculate start time of observation.
`to_datetime_end`()	Calculate end time of observation.
`to_detector_exposure_id`()	Return value of detector_exposure_id from headers.
`to_detector_group`()	Collection name of which this detector is a part.
`to_detector_name`()	Return value of detector_name from headers.
`to_detector_num`()	Unique (for instrument) integer identifier for the sensor.
`to_detector_serial`()	Serial number/string associated with this detector.
`to_exposure_id`()	Calculate unique exposure integer for this observation.
`to_exposure_time`()	Actual duration of the exposure (seconds).
`to_object`()	Object of interest or field name.
`to_observation_id`()	Label uniquely identifying this observation (can be related to 'exposure_id').
`to_observation_type`()	Calculate the observation type.
`to_physical_filter`()	Return value of physical_filter from headers.
`to_pressure`()	Atmospheric pressure outside the dome.
`to_relative_humidity`()	Relative humidity outside the dome.
`to_science_program`()	Observing program (survey or proposal) identifier.
`to_temperature`()	Temperature outside the dome.
`to_tracking_radec`()	Return value of tracking_radec from headers.
`to_visit_id`()	Calculate the unique integer ID for this visit.

Attributes Documentation

all_properties: dict[str, PropertyDefinition] = {'altaz_begin': <astro_metadata_translator.properties.PropertyDefinition object>, 'altaz_end': <astro_metadata_translator.properties.PropertyDefinition object>, 'boresight_airmass': <astro_metadata_translator.properties.PropertyDefinition object>, 'boresight_rotation_angle': <astro_metadata_translator.properties.PropertyDefinition object>, 'boresight_rotation_coord': <astro_metadata_translator.properties.PropertyDefinition object>, 'can_see_sky': <astro_metadata_translator.properties.PropertyDefinition object>, 'dark_time': <astro_metadata_translator.properties.PropertyDefinition object>, 'datetime_begin': <astro_metadata_translator.properties.PropertyDefinition object>, 'datetime_end': <astro_metadata_translator.properties.PropertyDefinition object>, 'detector_exposure_id': <astro_metadata_translator.properties.PropertyDefinition object>, 'detector_group': <astro_metadata_translator.properties.PropertyDefinition object>, 'detector_name': <astro_metadata_translator.properties.PropertyDefinition object>, 'detector_num': <astro_metadata_translator.properties.PropertyDefinition object>, 'detector_serial': <astro_metadata_translator.properties.PropertyDefinition object>, 'detector_unique_name': <astro_metadata_translator.properties.PropertyDefinition object>, 'exposure_group': <astro_metadata_translator.properties.PropertyDefinition object>, 'exposure_id': <astro_metadata_translator.properties.PropertyDefinition object>, 'exposure_time': <astro_metadata_translator.properties.PropertyDefinition object>, 'exposure_time_requested': <astro_metadata_translator.properties.PropertyDefinition object>, 'focus_z': <astro_metadata_translator.properties.PropertyDefinition object>, 'group_counter_end': <astro_metadata_translator.properties.PropertyDefinition object>, 'group_counter_start': <astro_metadata_translator.properties.PropertyDefinition object>, 'has_simulated_content': <astro_metadata_translator.properties.PropertyDefinition object>, 'instrument': <astro_metadata_translator.properties.PropertyDefinition object>, 'location': <astro_metadata_translator.properties.PropertyDefinition object>, 'object': <astro_metadata_translator.properties.PropertyDefinition object>, 'observation_counter': <astro_metadata_translator.properties.PropertyDefinition object>, 'observation_id': <astro_metadata_translator.properties.PropertyDefinition object>, 'observation_reason': <astro_metadata_translator.properties.PropertyDefinition object>, 'observation_type': <astro_metadata_translator.properties.PropertyDefinition object>, 'observing_day': <astro_metadata_translator.properties.PropertyDefinition object>, 'observing_day_offset': <astro_metadata_translator.properties.PropertyDefinition object>, 'physical_filter': <astro_metadata_translator.properties.PropertyDefinition object>, 'pressure': <astro_metadata_translator.properties.PropertyDefinition object>, 'relative_humidity': <astro_metadata_translator.properties.PropertyDefinition object>, 'science_program': <astro_metadata_translator.properties.PropertyDefinition object>, 'telescope': <astro_metadata_translator.properties.PropertyDefinition object>, 'temperature': <astro_metadata_translator.properties.PropertyDefinition object>, 'tracking_radec': <astro_metadata_translator.properties.PropertyDefinition object>, 'visit_id': <astro_metadata_translator.properties.PropertyDefinition object>}#: All the valid properties for this translator including extensions.

default_resource_root: str | None = 'corrections/SuprimeCam'#: Default resource path root to use to locate header correction files.

name: str | None = 'SuprimeCam'#: Name of this translation class

supported_instrument: str | None = 'SuprimeCam'#: Supports the SuprimeCam instrument.

Methods Documentation

classmethod can_translate(header, filename=None)#

Indicate whether this translation class can translate the supplied header.

Parameters:

header (dict-like) – Header to convert to standardized form.
filename (str, optional) – Name of file being translated.

Returns:

can – True if the header is recognized by this class. False otherwise.

Return type:

bool

to_altaz_begin()#

Return value of altaz_begin from headers.

Telescope boresight azimuth and elevation at start of observation.

Returns:: The translated property.
Return type:: astropy.coordinates.builtin_frames.altaz.AltAz

to_boresight_airmass()#

Airmass of the boresight of the telescope.

Returns:: Translated value derived directly from a single header.
Return type:: float
Parameters:: self (MetadataTranslator)

to_boresight_rotation_angle()#

Return value of boresight_rotation_angle from headers.

Angle of the instrument in boresight_rotation_coord frame.

Returns:: The translated property.
Return type:: astropy.coordinates.angles.core.Angle

to_boresight_rotation_coord()#

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

Returns:: Translated property that is fixed to a single value by the translator.
Return type:: str
Parameters:: self (MetadataTranslator)

to_dark_time()#

Duration of the exposure with shutter closed (seconds).

Returns:: Translated value derived directly from a single header.
Return type:: astropy.units.quantity.Quantity
Parameters:: self (MetadataTranslator)

to_datetime_begin()#

Calculate start time of observation.

Uses FITS standard MJD-BEG or DATE-BEG, in conjunction with the TIMESYS header. Will fallback to using MJD-OBS or DATE-OBS if the -BEG variants are not found.

Returns:: start_time – Time corresponding to the start of the observation. Returns None if no date can be found.
Return type:: astropy.time.Time or None

to_datetime_end()#

Calculate end time of observation.

Uses FITS standard MJD-END or DATE-END, in conjunction with the TIMESYS header.

Returns:: start_time – Time corresponding to the end of the observation.
Return type:: astropy.time.Time

to_detector_exposure_id()#

Return value of detector_exposure_id from headers.

Unique integer identifier for this detector in this exposure.

Returns:: The translated property.
Return type:: int

to_detector_group()#

Collection name of which this detector is a part. Can be None if there are no detector groupings.

Returns:: Translated property that is fixed to a single value by the translator.
Return type:: str
Parameters:: self (MetadataTranslator)

to_detector_name()#

Return value of detector_name from headers.

Name of the detector within the instrument (might not be unique if there are detector groups).

Returns:: The translated property.
Return type:: str

to_detector_num()#

Unique (for instrument) integer identifier for the sensor.

Returns:: Translated value derived directly from a single header.
Return type:: int
Parameters:: self (MetadataTranslator)

to_detector_serial()#

Serial number/string associated with this detector.

Returns:: Translated value derived directly from a single header.
Return type:: str
Parameters:: self (MetadataTranslator)

to_exposure_id()#

Calculate unique exposure integer for this observation.

Returns:: visit – Integer uniquely identifying this exposure.
Return type:: int

to_exposure_time()#

Actual duration of the exposure (seconds).

Returns:: Translated value derived directly from a single header.
Return type:: astropy.units.quantity.Quantity
Parameters:: self (MetadataTranslator)

to_object()#

Object of interest or field name.

Returns:: Translated value derived directly from a single header.
Return type:: str
Parameters:: self (MetadataTranslator)

to_observation_id()#

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

Returns:: Translated value derived directly from a single header.
Return type:: str
Parameters:: self (MetadataTranslator)

to_observation_type()#

Calculate the observation type.

Returns:: typ – Observation type. Normalized to standard set.
Return type:: str

to_physical_filter()#

Return value of physical_filter from headers.

The bandpass filter used for this observation.

Returns:: The translated property.
Return type:: str

to_pressure()#

Atmospheric pressure outside the dome.

Returns:: Translated value derived directly from a single header.
Return type:: astropy.units.quantity.Quantity
Parameters:: self (MetadataTranslator)

to_relative_humidity()#

Relative humidity outside the dome.

Returns:: Translated value derived directly from a single header.
Return type:: float
Parameters:: self (MetadataTranslator)

to_science_program()#

Observing program (survey or proposal) identifier.

Returns:: Translated value derived directly from a single header.
Return type:: str
Parameters:: self (MetadataTranslator)

to_temperature()#

Temperature outside the dome.

Returns:: Translated value derived directly from a single header.
Return type:: astropy.units.quantity.Quantity
Parameters:: self (MetadataTranslator)

to_tracking_radec()#

Return value of tracking_radec from headers.

Requested RA/Dec to track.

Returns:: The translated property.
Return type:: astropy.coordinates.sky_coordinate.SkyCoord

to_visit_id()#

Calculate the unique integer ID for this visit.

Assumed to be identical to the exposure ID in this implementation.

Returns:: exp – Unique visit identifier.
Return type:: int