Class for handling FITS Image extensions. More...

#include <FITSImgParser.h>

Public Member Functions
	FITSImgParser (const String &name)
	Construct a parser from the FITS file. More...

	FITSImgParser (const FITSImgParser &other)
	Copy constructor (reference semantics). More...

	~FITSImgParser ()
	Destructor, does not much. More...

FITSImgParser &	operator= (const FITSImgParser &other)
	Assignment (reference semantics). More...

String	fitsname (Bool stripPath=False) const
	Returns the name of the disk file. More...

Int	get_index (const FITSExtInfo &extinfo)
	Identify the index of an extension. More...

Int	find_extension (const String &extname, const Int &extversion=-1)
	Find an extension; return -1 if not found. More...

uInt	get_firstdata_index (void)
	Get the index of the first extension with data. More...

uInt	get_numhdu (void)
	Get the number of extensions. More...

String	get_extlist_string (const String &delimiter, const String &qualmarker="", const String &fitsmarker="", const Bool &listall=True)
	Get a string representation of the extension list. More...

Bool	has_qualityimg (void)
	Get the flag indicating at least one quality image. More...

Bool	is_qualityimg (const String &extexpr)
	Check whether the extensions named in the extension expression can be loaded as a quality image. More...

Bool	get_quality_data (const String &extexpr, Int &data_HDU, Int &error_HDU, String &error_type, Int &mask_HDU, String &mask_type, Int &mask_value)
	Find all necessary access information for the extensions to be loaded as a quality image. More...

Private Member Functions
void	setup (void)
	Setup the object (used by constructors). More...

void	process_extension (HeaderDataUnit *h, const uInt &extindex)
	Get the information on an extension. More...

Bool	get_extlist (const String &extexpr, Vector< String > &extlist)
	Extract the list of extensions from the extension expression. More...

Int	get_dataindex (const Vector< Int > &extindex)
	Get the first extension with HDU type "data" from the list of indices. More...

String	get_errorext (const Int &ext_index)
	Get the error extension name for the given data extension. More...

String	get_maskext (const Int &ext_index)
	Get the mask extension name for the given data extension. More...

Bool	confirm_fix_keywords (const Int &ext_index)
	Check the keywords with fixed values. More...

Bool	index_is_HDUtype (const Int &ext_index, const String &hdutype)
	Check whether the extension has a certain HDU type. More...

Bool	find_qualimgs (void)
	Find and store all set of extensions that can be loaded as a quality image. More...

Private Attributes
String	name_p

uInt	numhdu_p

FITSExtInfo *	extensions_p

Vector< String >	qualimglist_p

Bool	hasmeasurement_p

Static Private Attributes
static const char *	storeKwords_p []

static const int	nKwords_p

Detailed Description

Class for handling FITS Image extensions.

Intended use:

Public interface

Review Status

Test programs:: tFITSImgParser

Prerequisite

Etymology

This class parses through a FITS image and stores essential information for each extension.

Synopsis

The class parses through a FITS image and extracts information on its extensions, e.g. the extension name and the extension version. It is possible to identify a certain extension and to get the its extension index.

It is also explored whether some of the FITS extensions can be loaded as a quality image (data + error + mask).

Example

FITSImgParser fitsImg("in.fits");
uInt numHDU    = fitsImg.get_numhdu();                // get the total number of HDU's
uInt firstdata = fitsImg.get_firstdata_index();       // get the first HDU with data
String allExts = fitsImg.get_extlist_string(String("\n"));  // get a string representation of all extensions
String hasQual = fitsImg.has_qualityimg();            // check whether some of the extensions form quality image

Motivation

Investigate and select FITS extensions

Definition at line 88 of file FITSImgParser.h.

Constructor & Destructor Documentation

casacore::FITSImgParser::FITSImgParser ( const String & name )

Construct a parser from the FITS file.

casacore::FITSImgParser::FITSImgParser ( const FITSImgParser & other )

Copy constructor (reference semantics).

casacore::FITSImgParser::~FITSImgParser ( )

Destructor, does not much.

Member Function Documentation

Bool casacore::FITSImgParser::confirm_fix_keywords ( const Int & ext_index )

private

Check the keywords with fixed values.

Int casacore::FITSImgParser::find_extension	(	const String &	extname,
		const Int &	extversion = `-1`
	)

Find an extension; return -1 if not found.

Bool casacore::FITSImgParser::find_qualimgs ( void )

private

Find and store all set of extensions that can be loaded as a quality image.

String casacore::FITSImgParser::fitsname ( Bool stripPath = False ) const

Returns the name of the disk file.

Int casacore::FITSImgParser::get_dataindex ( const Vector< Int > & extindex )

private

Get the first extension with HDU type "data" from the list of indices.

Returns "-1" if there is none.

String casacore::FITSImgParser::get_errorext ( const Int & ext_index )

private

Get the error extension name for the given data extension.

Bool casacore::FITSImgParser::get_extlist	(	const String &	extexpr,
		Vector< String > &	extlist
	)

private

Extract the list of extensions from the extension expression.

String casacore::FITSImgParser::get_extlist_string	(	const String &	delimiter,
		const String &	qualmarker = `""`,
		const String &	fitsmarker = `""`,
		const Bool &	listall = `True`
	)

Get a string representation of the extension list.

uInt casacore::FITSImgParser::get_firstdata_index ( void )

Get the index of the first extension with data.

Int casacore::FITSImgParser::get_index ( const FITSExtInfo & extinfo )

Identify the index of an extension.

String casacore::FITSImgParser::get_maskext ( const Int & ext_index )

private

Get the mask extension name for the given data extension.

uInt casacore::FITSImgParser::get_numhdu ( void )

inline

Get the number of extensions.

Definition at line 116 of file FITSImgParser.h.

References numhdu_p.

Bool casacore::FITSImgParser::get_quality_data	(	const String &	extexpr,
		Int &	data_HDU,
		Int &	error_HDU,
		String &	error_type,
		Int &	mask_HDU,
		String &	mask_type,
		Int &	mask_value
	)

Find all necessary access information for the extensions to be loaded as a quality image.

Bool casacore::FITSImgParser::has_qualityimg ( void )

inline

Get the flag indicating at least one quality image.

Definition at line 123 of file FITSImgParser.h.

References casacore::False, qualimglist_p, and casacore::True.

Bool casacore::FITSImgParser::index_is_HDUtype	(	const Int &	ext_index,
		const String &	hdutype
	)

private

Check whether the extension has a certain HDU type.

Bool casacore::FITSImgParser::is_qualityimg ( const String & extexpr )

Check whether the extensions named in the extension expression can be loaded as a quality image.

FITSImgParser& casacore::FITSImgParser::operator= ( const FITSImgParser & other )

Assignment (reference semantics).

void casacore::FITSImgParser::process_extension	(	HeaderDataUnit *	h,
		const uInt &	extindex
	)

private

Get the information on an extension.

void casacore::FITSImgParser::setup ( void )

private

Setup the object (used by constructors).

Member Data Documentation

FITSExtInfo* casacore::FITSImgParser::extensions_p

private

Definition at line 138 of file FITSImgParser.h.

Bool casacore::FITSImgParser::hasmeasurement_p

private

Definition at line 141 of file FITSImgParser.h.

String casacore::FITSImgParser::name_p

private

Definition at line 135 of file FITSImgParser.h.

const int casacore::FITSImgParser::nKwords_p

staticprivate

Definition at line 144 of file FITSImgParser.h.

uInt casacore::FITSImgParser::numhdu_p

private

Definition at line 136 of file FITSImgParser.h.

Referenced by get_numhdu().

Vector<String> casacore::FITSImgParser::qualimglist_p

private

Definition at line 139 of file FITSImgParser.h.

Referenced by has_qualityimg().

const char* casacore::FITSImgParser::storeKwords_p[]

staticprivate

Definition at line 143 of file FITSImgParser.h.

The documentation for this class was generated from the following file:

casa/casacore/images/Images/FITSImgParser.h

Public Member Functions

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Intended use:

Review Status

Prerequisite

Etymology

Synopsis

Example

Motivation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation