casacore::ImageSummary< T > Class Template Reference

Provides and lists information about the header of an image. More...

#include <ImageConcat.h>

Public Member Functions
	ImageSummary (const ImageInterface< T > &)
	Constructor. More...
	ImageSummary (const ImageSummary< T > &other)
	Copy constructor. More...
	~ImageSummary ()
	Destructor. More...
ImageSummary< T > &	operator= (const ImageSummary< T > &other)
	Assignment operator. More...
Int	ndim () const
	Retrieve number of image dimension. More...
IPosition	shape () const
	Retrieve image shape. More...
IPosition	tileShape () const
	Retrieve tile shape with which image is stored on disk. More...
Vector< String >	axisNames (Bool pixelOrder=True) const
	Retrieve axis names in pixel or world axis order. More...
Vector< Double >	referencePixels (Bool oneRel=True) const
	Retrieve reference pixels (0 or 1 rel) More...
Vector< Double >	referenceValues (Bool pixelOrder=True) const
	Retrieve reference values in pixel or world axis order. More...
Vector< Double >	axisIncrements (Bool pixelOrder=True) const
	Retrieve axis increments in pixel or world axis order. More...
Vector< String >	axisUnits (Bool pixelOrder=True) const
	Retrieve axis units in pixel or world axis order. More...
Unit	units () const
	Retrieve image units. More...
String	name () const
	Retrieve image name. More...
String	observer () const
	Retrieve observer name. More...
String	obsDate (MEpoch &date) const
	Return epoch of observation as MEpoch or formatted string. More...
String	telescope () const
	Return telescope. More...
Bool	restFrequency (String &restFreqString, Quantum< Double > &restFreq) const
	Return rest frequency. More...
Bool	frequencySystem (String &freqTypeString, MFrequency::Types &freqType) const
	Return frequency system. More...
Bool	directionSystem (String &dirTypeString, MDirection::Types &dirType) const
	Return direction system. More...
Bool	hasAMask () const
	Retrieve whether image has mask or not. More...
Vector< String >	maskNames () const
	Retrieve mask names. More...
Vector< String >	regionNames () const
	Retrieve region names. More...
String	defaultMaskName () const
	Retrieve default mask name. More...
String	imageType () const
	Retrieve image type. More...
Vector< String >	list (LogIO &os, const MDoppler::Types velocityType=MDoppler::RADIO, Bool postLocally=False, const Bool verbose=False)
	List all header information. More...
Bool	setNewImage (const ImageInterface< T > &image)
	Set a new image. More...

Private Member Functions
String	makeMasksString () const
String	makeRegionsString () const

Private Attributes
CoordinateSystem	cSys_p
ObsInfo	obsInfo_p
ImageInfo	imageInfo_p
const ImageInterface< T > *	pImage_p

Detailed Description

template<class T>
class casacore::ImageSummary< T >

Provides and lists information about the header of an image.

Intended use:

Public interface

Review Status

Date Reviewed:

yyyy/mm/dd

Prerequisite

• ImageInterface
• Coordinates

Etymology

This class lists the ancilliary descriptive information from an image

Synopsis

Images consist of pixel values and descriptive information. This information describes the coordinate system, the image units etc. This class enables you to retrieve the descriptive information and/or list it.

The functions that retrieve specific coordinate information in vectors (e.g. referenceValues) return it in the order of the (pixel) axes of the image. Note that this can be different from the order in which the CoordinateSystem functions of similar name might return them. This is because the order of the coordinates in the CoordinateSystem is not necessarily the same order as the pixel axes in the associated image, although of course there is a known association.

Tip: This class lists information about the coordinates in the image; The Coordinates classes can maintain the information in a variety of units; For example, angular quantities are by default in radians, but the manipulator of a CoordinateSystem may have converted to some other unit such as arcseconds; This means that when this class fetches coordinate information and returns it to you (such as the referenceValues() function, the information is returned to you in whatever units the coordinates are currently in; It does not convert it;

Example

PagedImage<Float> inImage(fileName);
ImageSummary<Float> summary(inImage);
LogOrigin or("myClass", "myFunction(...)", WHERE);
LogIO os(or);
summary.list(os);

A PagedImage object is constructed and then logged to the supplied LogIO object.

Motivation

The viewing of the descriptive image information is a basic capability.

Definition at line 45 of file ImageConcat.h.

Constructor & Destructor Documentation

template<class T >

casacore::ImageSummary< T >::ImageSummary

(

const ImageInterface< T > &

)

Constructor.

template<class T >

casacore::ImageSummary< T >::ImageSummary

(

const ImageSummary< T > &

other

)

Copy constructor.

template<class T >

casacore::ImageSummary< T >::~ImageSummary

(

)

Destructor.

Member Function Documentation

template<class T >

Vector<Double> casacore::ImageSummary< T >::axisIncrements

(

Bool

pixelOrder = True

)

const

Retrieve axis increments in pixel or world axis order.

template<class T >

Vector<String> casacore::ImageSummary< T >::axisNames

(

Bool

pixelOrder = True

)

const

Retrieve axis names in pixel or world axis order.

template<class T >

Vector<String> casacore::ImageSummary< T >::axisUnits

(

Bool

pixelOrder = True

)

const

Retrieve axis units in pixel or world axis order.

template<class T >

String casacore::ImageSummary< T >::defaultMaskName

(

)

const

Retrieve default mask name.

Empty if none

template<class T >

Bool casacore::ImageSummary< T >::directionSystem	(	String &	dirTypeString,
		MDirection::Types &	dirType
	)		const

Return direction system.

Returns False if none.

template<class T >

Bool casacore::ImageSummary< T >::frequencySystem	(	String &	freqTypeString,
		MFrequency::Types &	freqType
	)		const

Return frequency system.

Returns False if none.

template<class T >

Bool casacore::ImageSummary< T >::hasAMask

(

)

const

Retrieve whether image has mask or not.

template<class T >

String casacore::ImageSummary< T >::imageType

(

)

const

Retrieve image type.

template<class T >

Vector<String> casacore::ImageSummary< T >::list	(	LogIO &	os,
		const MDoppler::Types	velocityType = MDoppler::RADIO,
		Bool	postLocally = False,
		const Bool	verbose = False
	)

List all header information.

By default, the reference values and pixel increments are converted to a "nice" unit before formatting (e.g. RA is shown as HH:MM:SS.S). For spectral axes, both frequency and velocity information is listed. You can specify what velocity definition you want with velocityType If postLocally is True, the formatted strings are returned in the return value

template<class T >

String casacore::ImageSummary< T >::makeMasksString ( ) const

private

template<class T >

String casacore::ImageSummary< T >::makeRegionsString ( ) const

private

template<class T >

Vector<String> casacore::ImageSummary< T >::maskNames

(

)

const

Retrieve mask names.

template<class T >

String casacore::ImageSummary< T >::name

(

)

const

Retrieve image name.

Any prepended path is stripped off.

template<class T >

Int casacore::ImageSummary< T >::ndim

(

)

const

Retrieve number of image dimension.

template<class T >

String casacore::ImageSummary< T >::obsDate

(

MEpoch &

date

)

const

Return epoch of observation as MEpoch or formatted string.

template<class T >

String casacore::ImageSummary< T >::observer

(

)

const

Retrieve observer name.

template<class T >

ImageSummary<T>& casacore::ImageSummary< T >::operator=

(

const ImageSummary< T > &

other

)

Assignment operator.

template<class T >

Vector<Double> casacore::ImageSummary< T >::referencePixels

(

Bool

oneRel = True

)

const

Retrieve reference pixels (0 or 1 rel)

template<class T >

Vector<Double> casacore::ImageSummary< T >::referenceValues

(

Bool

pixelOrder = True

)

const

Retrieve reference values in pixel or world axis order.

template<class T >

Vector<String> casacore::ImageSummary< T >::regionNames

(

)

const

Retrieve region names.

template<class T >

Bool casacore::ImageSummary< T >::restFrequency	(	String &	restFreqString,
		Quantum< Double > &	restFreq
	)		const

Return rest frequency.

Returns False if none.

template<class T >

Bool casacore::ImageSummary< T >::setNewImage

(

const ImageInterface< T > &

image

)

Set a new image.

template<class T >

IPosition casacore::ImageSummary< T >::shape

(

)

const

Retrieve image shape.

template<class T >

String casacore::ImageSummary< T >::telescope

(

)

const

Return telescope.

template<class T >

IPosition casacore::ImageSummary< T >::tileShape

(

)

const

Retrieve tile shape with which image is stored on disk.

template<class T >

Unit casacore::ImageSummary< T >::units

(

)

const

Retrieve image units.

Member Data Documentation

template<class T >

CoordinateSystem casacore::ImageSummary< T >::cSys_p

private

Definition at line 215 of file ImageSummary.h.

template<class T >

ImageInfo casacore::ImageSummary< T >::imageInfo_p

private

Definition at line 217 of file ImageSummary.h.

template<class T >

ObsInfo casacore::ImageSummary< T >::obsInfo_p

private

Definition at line 216 of file ImageSummary.h.

template<class T >

const ImageInterface<T>* casacore::ImageSummary< T >::pImage_p

private

Definition at line 218 of file ImageSummary.h.

---

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

• casa/casacore/images/Images/ImageConcat.h
• casa/casacore/images/Images/ImageSummary.h