casa::IncEntropy Class Reference

Base class for incremental entropies used by incremental MEM algorithm. More...

#include <IncEntropy.h>

Inheritance diagram for casa::IncEntropy:

Public Member Functions
	IncEntropy ()
	The default constructor is good enough, does nothing. More...
virtual	~IncEntropy ()
	A virtual destructor may be necessary for use in derived classes. More...
virtual casacore::Float	formEntropy ()=0
	calculate the entropy for the whole image More...
virtual void	formGDG (casacore::Matrix< double > &)=0
	calculate the Gradient dot Gradient matrix More...
virtual void	formGDGStep (casacore::Matrix< double > &)=0
	calculate the Gradient dot Gradient matrix, calculate Step More...
virtual casacore::Double	formGDS ()=0
	calculate Gradient dot Step More...
virtual void	entropyType (casacore::String &)=0
	report the entropy type for a logging message More...
virtual void	entropyName (casacore::String &)=0
	report the entropy name More...
void	setMemModel (IncCEMemModel &mmm)
	set the MemModel More...
virtual void	infoBanner ()=0
	infoBanner More...
virtual void	infoPerIteration (casacore::uInt iteration)=0
	infoPerIteration More...
virtual casacore::Float	relaxMin ()=0
	are there any constraints on how the Image minimum gets relaxed? More...
virtual casacore::Bool	testConvergence ()=0
	each entropy type can have its distinct convergence criteria More...

Protected Types
enum	GRADTYPE {   H,   C,   F,   J }

Protected Member Functions
	IncEntropy (const IncEntropy &)

Protected Attributes
IncCEMemModel *	cemem_ptr

Detailed Description

Base class for incremental entropies used by incremental MEM algorithm.

Intended use:

Public interface

Review Status

Date Reviewed:

yyyy/mm/dd

Prerequisite

• IncCEMemModel

Etymology

This class is called Entropy because it encapsulates the required functionality of the entropy in the CE MEM algorithm. Inc is from incremental, as the dirty image specifies an increment on a previous major cycle's image, and the entropy is applied to the full image + deltaImage.

Synopsis

Provide the generic interface to entropy functions.

We calculate entropy, gradients, and Hessians (diagonal) of the entropy. For efficiency reasons, we cannot restrict the methods to these calculations, but must also subsume the loops over image pixels in which they are used. In this way, the Entropy classes form a tight partnership with the MemModel classes, taking over more responcibility than strict functional encapsulation requires.

This class heirarchy is used by CEMemModel, which implements the Cornwell-Evans Maximum Entropy algorithm.

In the Entropy constructor, we create a pointer to the CEMemModel for reference to its Mem image, prior image, and default levels. Since each sort of Entropy is a friend of the CEMemModel, it has access to its private data. However, we vow here NOT to touch it, just to look at it. Could have done read-only access, but too lazy.

Example

EntropyI myEntropyEngine(myCEMemModel&);

casacore::Float  theEntropy myEntropyEngine.getEntropy();

Motivation

This class is needed to encapsulate the methods of different functional forms of the entropy, used by Maximum Entropy (MEM) deconvolution algorithms.

To Do

• Nothing done yet!

virtual base class

Definition at line 105 of file IncEntropy.h.

Member Enumeration Documentation

enum casa::IncEntropy::GRADTYPE

protected

Enumerator
H
C
F
J

Definition at line 155 of file IncEntropy.h.

Constructor & Destructor Documentation

casa::IncEntropy::IncEntropy

(

)

The default constructor is good enough, does nothing.

the MemImage and Prior image are stored in the MemModel.

virtual casa::IncEntropy::~IncEntropy ( )

virtual

A virtual destructor may be necessary for use in derived classes.

casa::IncEntropy::IncEntropy ( const IncEntropy &  )

protected

Member Function Documentation

virtual void casa::IncEntropy::entropyName ( casacore::String &  )

pure virtual

report the entropy name

Implemented in casa::IncEntropyEmptiness, and casa::IncEntropyI.

virtual void casa::IncEntropy::entropyType ( casacore::String &  )

pure virtual

report the entropy type for a logging message

Implemented in casa::IncEntropyEmptiness, and casa::IncEntropyI.

Referenced by casa::IncCEMemModel::entropyType().

virtual casacore::Float casa::IncEntropy::formEntropy ( )

pure virtual

calculate the entropy for the whole image

Implemented in casa::IncEntropyEmptiness, and casa::IncEntropyI.

Referenced by casa::IncCEMemModel::formEntropy().

virtual void casa::IncEntropy::formGDG ( casacore::Matrix< double > &  )

pure virtual

calculate the Gradient dot Gradient matrix

Implemented in casa::IncEntropyEmptiness, and casa::IncEntropyI.

Referenced by casa::IncCEMemModel::formGDG().

virtual void casa::IncEntropy::formGDGStep ( casacore::Matrix< double > &  )

pure virtual

calculate the Gradient dot Gradient matrix, calculate Step

Implemented in casa::IncEntropyEmptiness, and casa::IncEntropyI.

Referenced by casa::IncCEMemModel::formGDGStep().

virtual casacore::Double casa::IncEntropy::formGDS ( )

pure virtual

calculate Gradient dot Step

Implemented in casa::IncEntropyEmptiness, and casa::IncEntropyI.

Referenced by casa::IncCEMemModel::formGDS().

virtual void casa::IncEntropy::infoBanner ( )

pure virtual

infoBanner

Implemented in casa::IncEntropyEmptiness, and casa::IncEntropyI.

virtual void casa::IncEntropy::infoPerIteration ( casacore::uInt  iteration )

pure virtual

infoPerIteration

Implemented in casa::IncEntropyEmptiness, and casa::IncEntropyI.

virtual casacore::Float casa::IncEntropy::relaxMin ( )

pure virtual

are there any constraints on how the Image minimum gets relaxed?

Implemented in casa::IncEntropyEmptiness, and casa::IncEntropyI.

Referenced by casa::IncCEMemModel::relaxMin().

void casa::IncEntropy::setMemModel ( IncCEMemModel &  mmm )

inline

set the MemModel

Definition at line 136 of file IncEntropy.h.

References cemem_ptr.

virtual casacore::Bool casa::IncEntropy::testConvergence ( )

pure virtual

each entropy type can have its distinct convergence criteria

Implemented in casa::IncEntropyEmptiness, and casa::IncEntropyI.

Referenced by casa::IncCEMemModel::testConvergence().

Member Data Documentation

IncCEMemModel* casa::IncEntropy::cemem_ptr

protected

Definition at line 158 of file IncEntropy.h.

Referenced by setMemModel().

---

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

• casa/code/synthesis/MeasurementEquations/IncEntropy.h