FITSKeyword

class msumastro.header_processing.fitskeyword.FITSKeyword(name=None, value=None, comment=None, synonyms=None)[source]

Bases: object

Represents a FITS keyword, which may have several synonyms.

Parameters
namestr, optional

Name of the keyword; case insensitive

valuestr or numeric type, optional

Value of the keyword; this class imposes no constraints on the type of the keyword but if you intend to save the value in a FITS header you should be aware of the restrictions the FITS standard places on keyword values.

commentstr, optional

Description of the keyword.

synonymsstr or list of str, optional

Synonyms for this keyword. Synonyms are to look for a value in a FITS header and to set multiple keywords to the same value in a FITS header.

Attributes Summary

name

Primary name of the keyword.

names

All names, including synonyms, for this keyword, as a list.

synonyms

List of synonyms for the keyword.

Methods Summary

add_to_header(self, hdu_or_header[, …])

Add keyword to FITS header.

history_comment(self[, with_name])

Produce a string describing changes to the keyword value.

set_value_from_header(self, hdu_or_header)

Set value of keyword from FITS header.

Attributes Documentation

name

Primary name of the keyword.

names

All names, including synonyms, for this keyword, as a list.

synonyms

List of synonyms for the keyword.

Methods Documentation

add_to_header(self, hdu_or_header, with_synonyms=True, history=False)[source]

Add keyword to FITS header.

Parameters
hdu_or_headerastropy.io.fits.Header or astropy.io.fits.PrimaryHDU

Header/HDU to which the keyword is to be added.

with_synonymsbool, optional

Control whether a keyword is added for each of the synonyms for the keyword. Default is True.

historybool, optional

Control whether a history comment is added to the header; if True a history comment is added for each of the keyword names added to the header, including synonyms.

history_comment(self, with_name=None)[source]

Produce a string describing changes to the keyword value.

Parameters
with_namestr, optional

Name to use for the keyword in the history comment. Default is the name attribute of the Keyword.

set_value_from_header(self, hdu_or_header)[source]

Set value of keyword from FITS header.

Values are obtained from the header by looking for the keyword by its primary name and any synonyms. If multiple values are found they are checked for consistency.

Parameters
hdu_or_header: astropy.io.fits.Header or astrop.io.fits.PrimaryHDU

Header from which the keyword value should be taken.

Raises
ValueError

If hdu_or_header is of the wrong type, or the keyword (or synonyms) are not found in the header, or multiple non-identical values are found.