Displays histograms of regions from an image. More...

#include <ImageHistograms.h>

Inheritance diagram for casa::ImageHistograms< T >:

Public Member Functions
	ImageHistograms (const ImageInterface< T > &image, LogIO &os, Bool showProgress=True, Bool forceDisk=False)
	Constructor takes the image and a `LogIO` object for logging.
	ImageHistograms (const ImageInterface< T > &image, Bool showProgress=True, Bool forceDisk=False)
	Constructor takes the image only.
	ImageHistograms (const ImageHistograms< T > &other)
	Copy constructor (copy semantics)
virtual	~ImageHistograms ()
	Destructor.
ImageHistograms< T > &	operator= (const ImageHistograms< T > &other)
	Assignment operator (copy semantics)
Bool	setNewImage (const ImageInterface< T > &image)
	Set a new image.
Private Member Functions
virtual String	writeCoordinates (const IPosition &histPos) const
	Make a string with pixel and world coordinates of display axes.
Private Attributes
LogIO	os_p
	These things are protected only so that they are available to ImageHistograms which inherits from LatticeHistograms.
const ImageInterface< T > *	pInImage_p

Detailed Description

template<class T>
class casa::ImageHistograms< T >

Displays histograms of regions from an image.

Intended use:

Public interface

Review Status

Date Reviewed:: yyyy/mm/dd

Prerequisite

Etymology

This is a class designed to display histograms from images

Synopsis

This class enable you to display and/or retrieve histograms evaluated over specified regions from an image. The dimension of the region is arbitrary, but the size of each dimension is always the size of the corresponding image axis. The histograms are displayed as a function of location of the axes not used to evaluate the histograms over. The axes which you evaluate the histograms over are called the cursor axes, the others are called the display axwes.

For example, consider an image cube (call the axes xyz or [0,1,2]). You could display histograms from xy planes (cursor axes [0,1]) as a function of z (display axes [2]). Or you could retrieve histograms from the z axis (cursor axes [2]) for each [x,y] location (display axes [0,1]).

The hard work is done by LatticeHistograms which this class (clumsily) inherits. It generates a "storage lattice" into which it writes the histograms. It is from this storage image that the plotting and retrieval arrays are drawn. The storage image is either in core or on disk depending upon its size (if > 10% of memory given by .aipsrc system.resources.memory then it goes into a disk-based PagedArray). If on disk, the storage image is deleted when the ImageHistograms object destructs.

See LatticeHistograms for most of the useful public interface. ImageHistograms exists only so that it can write some world coordinate information to the plots and logger.

Tip: Note that for complex images, real and imaginary are treated independently; They are binned and plotted separately;

Tip: If you ignore return error statuses from the functions that set the state of the class, the internal status of the class is set to bad; This means it will just keep on returning error conditions until you explicitly recover the situation; A message describing the last error condition can be recovered with function errorMessage;

Example

   // Construct PagedImage from file name
   
         PagedImage<Float> inImage(inName);
      
   // Construct histogram object
         
         LogOrigin or("myClass", "myFunction(...)", WHERE);
         LogIO os(or);
         ImageHistograms<Float> histo(inImage, os);
         
   // Set cursor axes to see statistics of yz planes (0 relative)
   
         Vector<Int> cursorAxes(2)
         cursorAxes(0) = 1;
         cursorAxes(1) = 2;
         if (!histo.setAxes(cursorAxes)) return 1;
   
   // Set to list and plot mean, sigma and rms
   
         if (!histo.setList(True)) return 1;
         String device = "/xs";
         Vector<Int> nxy(2);
         nxy(0) = 3;
         nxy(1) = 3;
         if (!histo.setPlotting(device, nxy)) return 1;
    
   // Now activate actual listing and plotting
    
         if (!histo.display ()) return 1;
   
   // Retrieve histograms into array
   
         Array<Float> values, counts;
         if (!histo.getHistograms(values, counts)) return 1;

In this example, a PagedImage is constructed. We set the cursor axes to be the y and z axes so we make a histogram of each yz plane as a function of x location on the PGPLOT device "/xs" with 9 subplots per page. After the plotting we also retrieve the histograms into an array.

Motivation

The generation of histograms from an image is a basic and necessary capability.

To Do

Make ascii listing of histograms as well as plots if desired

Definition at line 159 of file ImageHistograms.h.

Constructor & Destructor Documentation

template<class T>

casa::ImageHistograms< T >::ImageHistograms	(	const ImageInterface< T > &	image,
		LogIO &	os,
		Bool	showProgress = `True`,
		Bool	forceDisk = `False`
	)

Constructor takes the image and a LogIO object for logging.

You can also specify whether you want to see progress meters or not. You can force the storage image to be disk based, otherwise the decision for core or disk is taken for you.

template<class T>

casa::ImageHistograms< T >::ImageHistograms	(	const ImageInterface< T > &	image,
		Bool	showProgress = `True`,
		Bool	forceDisk = `False`
	)

Constructor takes the image only.

In the absence of a logger you get no messages. This includes error messages and potential listing of statistics. You can specify whether you want to see progress meters or not. You can force the storage image to be disk based, otherwise the decision for core or disk is taken for you.

template<class T>

casa::ImageHistograms< T >::ImageHistograms ( const ImageHistograms< T > & other )

Copy constructor (copy semantics)

template<class T>

virtual casa::ImageHistograms< T >::~ImageHistograms ( ) [virtual]

Destructor.

Member Function Documentation

template<class T>

ImageHistograms<T>& casa::ImageHistograms< T >::operator= ( const ImageHistograms< T > & other )

Assignment operator (copy semantics)

template<class T>

Bool casa::ImageHistograms< T >::setNewImage ( const ImageInterface< T > & image )

Set a new image.

A return value of False indicates the image had an invalid type or that the internal status of the class is bad.

template<class T>

virtual String casa::ImageHistograms< T >::writeCoordinates ( const IPosition & histPos ) const [private, virtual]

Make a string with pixel and world coordinates of display axes.

Reimplemented from casa::LatticeHistograms< T >.

Member Data Documentation

template<class T>

LogIO casa::ImageHistograms< T >::os_p [private]

These things are protected only so that they are available to ImageHistograms which inherits from LatticeHistograms.

Reimplemented from casa::LatticeHistograms< T >.

Definition at line 195 of file ImageHistograms.h.

template<class T>

const ImageInterface<T>* casa::ImageHistograms< T >::pInImage_p [private]

Definition at line 196 of file ImageHistograms.h.

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

code/imageanalysis/ImageAnalysis/ImageHistograms.h

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

template<class T> class casa::ImageHistograms< T >

Intended use:

Review Status

Prerequisite

Etymology

Synopsis

Example

Motivation

To Do

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation

template<class T>
class casa::ImageHistograms< T >