Classes
class	FitsReport
	Class to handle information for one FITS file check run. More...

Typedefs
using	CfitsioType = int32_t

Functions
CfitsioType	DidToCfitsioType (ctd::defines::DataType did_type)
	Convert an ELT ICS data type to the corresponding cfitsio data type. More...

void	HandleCfitsioError (const std::string &operation, const int cfitsio_status)
	Throw an exception, extracting the relevant info from cfitsio, if status != 0. More...

std::string	GenerateKey (const std::string &key, const std::string &hierarch_prefix=FITS_KEY_ESO_HIERARCH)
	Generates an ESO hierarchical keyword. More...

void	Verify (const std::string &filename, std::string &target_filename, dit::fits::FitsReport &report)
	Function to carry out a verification check on a FITS file. More...

void	Verify (const std::string &filename, std::string &target_filename, const dit::did::Did &dictionary, dit::fits::FitsReport &report)
	Function to carry out a verification check on a FITS file. Dictionary taken into account. More...

void	CreateFile (CCfits::FITS **fits_handle, const std::string &filename, const dit::did::Did &dictionary, const int32_t bitpix, const std::list< int32_t > &naxes, std::string &target_filename, const bool remove_if_exists=false, const uint16_t nb_of_hdr_blocks=1)
	Create a new FITS file. More...

void	MoveToHdu (CCfits::FITS &fits_handle, const int16_t hdu_nb)
	Move to the given HDU. More...

bool	KeyInHdu (CCfits::FITS &fits_handle, const int16_t hdu_nb, const std::string &key)
	Check if a given key is contained in the referenced HDU (primary HDU = 1). More...

void	AddDoubleKey (CCfits::FITS &fits_handle, const dit::did::Did &dictionary, const std::string &key, const double value, const uint16_t hdu_nb)
	Add a double type key in an existing FITS file. More...

void	PrepForAddingKey (CCfits::FITS &fits_handle, const dit::did::Did &dictionary, const std::string &key, const int16_t hdu_nb, dit::did::Record &did_record, std::string &target_key, bool &key_in_hdu, CfitsioType &cfitsio_type, dit::did::FormatSpecifier &format_specifier)
	Used to prepare for adding a keyword card in a FITS file (mostly internal usage). More...

void	ExtractHeaders (CCfits::FITS &fits_handle, std::string &hdr_buf, const int16_t hdr_ref=ALL_HEADERS)
	Extract the keyword cards in one or more HDU's in an ASCII format (newline terminated). More...

void	ExtractHeaders (const std::string &filename, std::string &target_filename, std::string &hdr_buf, const int16_t hdr_ref=ALL_HEADERS)
	Extract all or a specific header from a FITS file. More...

void	OpenFitsFile (CCfits::FITS **fits_handle, const std::string &filename, std::string &target_filename, CCfits::RWmode mode=CCfits::Read)
	Open an existing FITS file. More...

template<class TYPE >
void	AddKey (CCfits::FITS &fits_handle, const dit::did::Did &dictionary, const std::string &key, const TYPE &value, const int16_t hdu_nb)
	Template function to add a keyword card in an existing FITS file. More...

Variables
const std::string	FITS_KEY_ESO_HIERARCH = "HIERARCH ESO"

const int16_t	ALL_HEADERS = SHRT_MAX

Typedef Documentation

typedef int32_t dit::fits::CfitsioType

Function Documentation

void dit::fits::AddDoubleKey	(	CCfits::FITS &	fits_handle,
		const dit::did::Did &	dictionary,
		const std::string &	key,
		const double	value,
		const uint16_t	hdu_nb
	)

Add a double type key in an existing FITS file.

Parameters

fits_handle	CCfits object associated to the FITS file.
dictionary	Dictionary obejct containing information about keys to be added.
hdu_nb	HDU in which to add the key (primary header = 1).
value	Double value to be added.
key	Key to be added.

template<class TYPE >

void dit::fits::AddKey	(	CCfits::FITS &	fits_handle,
		const dit::did::Did &	dictionary,
		const std::string &	key,
		const TYPE &	value,
		const int16_t	hdu_nb
	)

Template function to add a keyword card in an existing FITS file.

Parameters

fits_handle	CCfits object associated to a FITS file.
dictionary	Dictionary obejct containing information about keys to be added.
key	Key to be added, e.g. "INS OPTI1 ID".
value	Value to be added.
hdu_nb	Target HDU number (primary header = 1).

Note: For Double type keys, use "dit::fits::AddDoubleKey()".

Todo:: : Call AddDoubleKey() directly here.

Todo:: : Call AddDoubleKey() directly here.

Todo:: : Call AddDoubleKey() directly here.

Todo:: : Call AddDoubleKey() directly here.

Todo:: : Call AddDoubleKey() directly here.

void dit::fits::CreateFile	(	CCfits::FITS **	fits_handle,
		const std::string &	filename,
		const dit::did::Did &	dictionary,
		const int32_t	bitpix,
		const std::list< int32_t > &	naxes,
		std::string &	target_filename,
		const bool	remove_if_exists = `false`,
		const uint16_t	nb_of_hdr_blocks = `1`
	)

Create a new FITS file.

Parameters

fits_handle	The CCfits handle for the new file. Will be allocated by the function.
filename	Basename for target file.
dictionary	Dictionary containing the definition of the keys to be created.
target_filename	The resulting final target filename.
remove_if_exists	If true, remove a file if already exsting with the target filename.
nb_of_hdr_blocks	Number of header blocks to reserve (

Todo:: not implemented).

Parameters

data_size Size in bytes to allocate for the data (

Todo:: not implemented).

Files given by their basename, will be created in "$DATAROOT/resource/image".

Parameters

fits_handle	The CCfits handle for the new file. Will be allocated by the function.
filename	Basename for target file.
dictionary	Dictionary containing the definition of the keys to be created.
target_filename	The resulting final target filename.
remove_if_exists	If true, remove a file if already exsting with the target filename.
nb_of_hdr_blocks	Number of header blocks to reserve (

Todo:: not implemented).

Parameters

data_size Size in bytes to allocate for the data (

Todo:: not implemented).

Files given by their basename, will be created in "$DATAROOT/resource/image".

Parameters

fits_handle	The CCfits handle for the new file. Will be allocated by the function.
filename	Basename for target file.
dictionary	Dictionary containing the definition of the keys to be created.
target_filename	The resulting final target filename.
remove_if_exists	If true, remove a file if already exsting with the target filename.
nb_of_hdr_blocks	Number of header blocks to reserve (

Todo:: not implemented).

Parameters

data_size Size in bytes to allocate for the data (

Todo:: not implemented).

Files given by their basename, will be created in "$DATAROOT/resource/image".

Todo:: : Handle nb_of_hdr_blocks, data_size.

Todo:: : Handle nb_of_hdr_blocks, data_size.

Todo:: : Handle nb_of_hdr_blocks, data_size.

CfitsioType dit::fits::DidToCfitsioType ( ctd::defines::DataType did_type )

Convert an ELT ICS data type to the corresponding cfitsio data type.

Parameters

did_type

Returns: cfitsio data type.

void dit::fits::ExtractHeaders	(	CCfits::FITS &	fits_handle,
		std::string &	hdr_buf,
		const int16_t	hdr_ref = `ALL_HEADERS`
	)

Extract the keyword cards in one or more HDU's in an ASCII format (newline terminated).

Parameters

fits_handle	CCfits handle object associated with existing FITS file.
hdr_buf	Buffer which will contain the ASCII dump of the requested headers.
hdr_ref	Single HDU or all for which to extract the keyword cards.

void dit::fits::ExtractHeaders	(	const std::string &	filename,
		std::string &	target_filename,
		std::string &	hdr_buf,
		const int16_t	hdr_ref = `ALL_HEADERS`
	)

Extract all or a specific header from a FITS file.

Parameters

filename	Basename of the file.
target_filename	Complete name of target file.
hdr_buf	Buffer with the newline terminated FITS keyword cards from the requested HDU's.
hdr_ref	HDU to extract, or all (primary HDU = 1).

Returns: Buffer with the ASCII dump of the requested header(s).

std::string dit::fits::GenerateKey	(	const std::string &	key,
		const std::string &	hierarch_prefix = `FITS_KEY_ESO_HIERARCH`
	)

Generates an ESO hierarchical keyword.

Parameters

key	Input key to be checked and possibly converted.

Returns: ESO hierachical key or input key unchanged.

For hierarchical keys, these shall be given as follows: "<cat> [<subsystem>] <parameter>".

A primary key is returned unmodified.

void dit::fits::HandleCfitsioError	(	const std::string &	operation,
		const int	cfitsio_status
	)

Throw an exception, extracting the relevant info from cfitsio, if status != 0.

bool dit::fits::KeyInHdu	(	CCfits::FITS &	fits_handle,
		const int16_t	hdu_nb,
		const std::string &	key
	)

Check if a given key is contained in the referenced HDU (primary HDU = 1).

Parameters

fits_handle	The CCfits object.
hdu_nb	HDU to check.
key	Name of the key, e.g. "INS FILT1 NAME".

Returns: True if key found in the referenced HDU.

void dit::fits::MoveToHdu	(	CCfits::FITS &	fits_handle,
		const int16_t	hdu_nb
	)

Move to the given HDU.

Parameters

fits_handle	CCfits fits handle.
hdu_nb	HDU number requested (primary header = 1).

void dit::fits::OpenFitsFile	(	CCfits::FITS **	fits_handle,
		const std::string &	filename,
		std::string &	target_filename,
		CCfits::RWmode	mode = `CCfits::Read`
	)

Open an existing FITS file.

Parameters

fits_handle	CCfits fits handle object. Will be allocated by the function.
filename	Basename of FITS file to open.
target_filename	Complete name of file opened.
mode	CCfits::Read or CCfits::Write.

void dit::fits::PrepForAddingKey	(	CCfits::FITS &	fits_handle,
		const dit::did::Did &	dictionary,
		const std::string &	key,
		const int16_t	hdu_nb,
		dit::did::Record &	did_record,
		std::string &	target_key,
		bool &	key_in_hdu,
		CfitsioType &	cfitsio_type,
		dit::did::FormatSpecifier &	format_specifier
	)

Used to prepare for adding a keyword card in a FITS file (mostly internal usage).

Parameters

dictionary	Dictionary object defining the keys in the FITS file.
fits_handle	The CCfits object.
key	Key to be added.
hdu_nb	HDU number where the shall be added (primary header = 1).
did_record	Copy of the dictionary record for the key.
target_key	The final target keyname, e.g. "HIERARCH ESO INS1 FILT2 NAME".
key_in_hdu	True if key already defined in the given HDU.
cfitsio_type	The cfitsio data type for the key.
format_specifier	Object with information about the format of the value.

Note, the function does actually not add the key in the file.

void dit::fits::Verify	(	const std::string &	filename,
		std::string &	target_filename,
		dit::fits::FitsReport &	report
	)

Function to carry out a verification check on a FITS file.

Parameters

filename	Basename of file to check.
target_filename	Filename of the FITS file checked.
report	Report object with the results from the check.

This is a basic verification check, not involving a ICS dictionary.

Todo:: Not yet implemented.

Parameters

filename	Basename of file to check.
target_filename	Filename of the FITS file checked.
report	Report object with the results from the check.

This is a basic verification check, not involving a ICS dictionary.

Todo:: Not yet implemented.

Parameters

filename	Basename of file to check.
target_filename	Filename of the FITS file checked.
report	Report object with the results from the check.

This is a basic verification check, not involving a ICS dictionary.

Todo:: Not yet implemented.

void dit::fits::Verify	(	const std::string &	filename,
		std::string &	target_filename,
		const dit::did::Did &	dictionary,
		dit::fits::FitsReport &	report
	)

Function to carry out a verification check on a FITS file. Dictionary taken into account.

Parameters

filename	Basename of file to check.
target_filename	Complete filename of file checked.
dictionary	ICS dictionary with keyword definitions.
report	Report object with the results from the check.

Variable Documentation

const int16_t dit::fits::ALL_HEADERS = SHRT_MAX

const std::string dit::fits::FITS_KEY_ESO_HIERARCH = "HIERARCH ESO"

Classes

Typedefs

Functions

Variables

Typedef Documentation

Function Documentation

Variable Documentation