casa::Entropy Class Reference

base class for entropy functions as used by MEM More...

#include <Entropy.h>

Inheritance diagram for casa::Entropy:

List of all members.

Public Member Functions
	Entropy ()
	The default constructor is good enough, does nothing.
virtual	~Entropy ()
	A virtual destructor may be necessary for use in derived classes.
virtual Float	formEntropy ()=0
	calculate the entropy for the whole image
virtual void	formGDG (Matrix< double > &)=0
	calculate the Gradient dot Gradient matrix
virtual void	formGDGStep (Matrix< double > &)=0
	calculate the Gradient dot Gradient matrix, calculate Step
virtual Double	formGDS ()=0
	calculate Gradient dot Step
virtual void	entropyType (String &)=0
	report the entropy type for a logging message
void	setMemModel (CEMemModel &mmm)
	set the MemModel
virtual void	infoBanner ()=0
	infoBanner
virtual void	infoPerIteration (uInt iteration)=0
	infoPerIteration
virtual Float	relaxMin ()=0
	are there any constraints on how the Image minimum gets relaxed?
virtual Bool	testConvergence ()=0
	each entropy type can have its distinct convergence criteria
Protected Types
enum	GRADTYPE {   H,   C,   F,   J }
Protected Member Functions
	Entropy (const Entropy &)
Protected Attributes
CEMemModel *	cemem_ptr

---

Detailed Description

base class for entropy functions as used by MEM

Intended use:

Public interface

Review Status

Date Reviewed:

yyyy/mm/dd

Prerequisite

• CEMemModel

Etymology

This class is called Entropy because it encapsulates the required functionality of the entropy in the CE MEM algorithm

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&);
   
    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 103 of file Entropy.h.

---

Member Enumeration Documentation

enum casa::Entropy::GRADTYPE [protected]

Enumerator:

H
C
F
J

Definition at line 151 of file Entropy.h.

---

Constructor & Destructor Documentation

casa::Entropy::Entropy

(

)

The default constructor is good enough, does nothing.

the MemImage and Prior image are stored in the MemModel.

virtual casa::Entropy::~Entropy

(

)

[virtual]

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

casa::Entropy::Entropy

(

const Entropy &

)

[protected]

---

Member Function Documentation

virtual void casa::Entropy::entropyType

(

String &

)

[pure virtual]

report the entropy type for a logging message

Implemented in casa::EntropyEmptiness, and casa::EntropyI.

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

virtual Float casa::Entropy::formEntropy

(

)

[pure virtual]

calculate the entropy for the whole image

Implemented in casa::EntropyEmptiness, and casa::EntropyI.

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

virtual void casa::Entropy::formGDG

(

Matrix< double > &

)

[pure virtual]

calculate the Gradient dot Gradient matrix

Implemented in casa::EntropyEmptiness, and casa::EntropyI.

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

virtual void casa::Entropy::formGDGStep

(

Matrix< double > &

)

[pure virtual]

calculate the Gradient dot Gradient matrix, calculate Step

Implemented in casa::EntropyEmptiness, and casa::EntropyI.

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

virtual Double casa::Entropy::formGDS

(

)

[pure virtual]

calculate Gradient dot Step

Implemented in casa::EntropyEmptiness, and casa::EntropyI.

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

virtual void casa::Entropy::infoBanner

(

)

[pure virtual]

infoBanner

Implemented in casa::EntropyEmptiness, and casa::EntropyI.

virtual void casa::Entropy::infoPerIteration

(

uInt

iteration

)

[pure virtual]

infoPerIteration

Implemented in casa::EntropyEmptiness, and casa::EntropyI.

virtual Float casa::Entropy::relaxMin

(

)

[pure virtual]

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

Implemented in casa::EntropyEmptiness, and casa::EntropyI.

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

void casa::Entropy::setMemModel

(

CEMemModel &

mmm

)

[inline]

set the MemModel

Definition at line 132 of file Entropy.h.

References cemem_ptr.

virtual Bool casa::Entropy::testConvergence

(

)

[pure virtual]

each entropy type can have its distinct convergence criteria

Implemented in casa::EntropyEmptiness, and casa::EntropyI.

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

---

Member Data Documentation

CEMemModel* casa::Entropy::cemem_ptr [protected]

Definition at line 154 of file Entropy.h.

Referenced by setMemModel().

---

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

• code/synthesis/MeasurementEquations/Entropy.h