casa::ResidualEquation< T > Class Template Reference

Interface class containing functions returning "Domain" type. More...

#include <Deconvolver.h>

Public Member Functions
virtual	~ResidualEquation ()
	A virtual destructor may be necessary for use in derived classes. More...
virtual casacore::Bool	residual (Domain &answer, const LinearModel< Domain > &model)=0
	The canonical member of this class defines a function which gives the residual when the model is propagated through the equation and compared with the data. More...
virtual casacore::Bool	residual (Domain &answer, casacore::Float &chisq, const LinearModel< Domain > &model)=0
	Same as above, but also calculates Chi^2 (rms of residual image) More...
virtual casacore::Bool	residual (Domain &answer, casacore::Float &chisq, Domain &mask, const LinearModel< Domain > &model)=0
	Same as above, but also calculates Chi^2 (rms of residual image) considering a mask image. More...

Detailed Description

template<class T>
class casa::ResidualEquation< T >

Interface class containing functions returning "Domain" type.

Intended use:

Internal

Review Status

Date Reviewed:

yyyy/mm/dd

Prerequisite

class should be read in conjunction with: LinearModel LinearEquation

Etymology

ResidualEquation reflects the fact that the residual() function was the first, and perhaps most important member of the class.

Synopsis

ResidualEquation is an abstract interface class into the more extensive LinearEquation class. It is composed of the subset of functions from LinearEquation which return objects of the "Domain", type. These objects can be used by the solve() function in the LinearModel to determine a new model. The separation of the ResidualEquation functions isolates the model, of type "Domain" from knowing what the data "Range", used by the LinearEquation class is.

Example

Suppose we have a simple class that has a vector model and knows (using the solve() function) how to update this vector if it is told the error betweeen the measured data and a model of the data produced using the current vector.

SimpleModel< casacore::Vector<casacore::Float> > simplemodel;

Suppose we also have a big complicated equation that does the forward modelling from vectors to some arbitrary class;

FancyEquation<casacore::Vector<casacore::Float>, VisibilitySet> eqn;

Then Simplemodel class does not need to know anything about the VisibilitySet class as it knows that the FancyEquation class will have (via inheritence) a ResidualEquation interface which returns vectors, so that it can use code like:

casacore::Vector<casacore::Float> error;
if (eqn.residual(*this, error)){ 
use the error to determine a new model
}

as part of the solve function.

Motivation

The main reason for the existence of this class is to isolate the type of the model ("Domain" type) from knowing what the "Range" of the equation is.

Template Type Argument Requirements (Domain)

template determines the type used to return the results for all the functions in this class. So even complicated template arguements should be OK.

Thrown Exceptions

is an interface class and does not contain any implementation (and hence does not throw exceptions)

To Do

• decide whether to add a derivative function
• decide whether functions which return scalars should also be in this class

Definition at line 56 of file Deconvolver.h.

Constructor & Destructor Documentation

template<class T>

virtual casa::ResidualEquation< T >::~ResidualEquation ( )

virtual

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

Member Function Documentation

template<class T>

virtual casacore::Bool casa::ResidualEquation< T >::residual ( Domain &  answer, const LinearModel< Domain > &  model  )

pure virtual

The canonical member of this class defines a function which gives the residual when the model is propagated through the equation and compared with the data.

It returns false if the answer could not be computed.

Implemented in casa::LinearEquation< Domain, Range >.

template<class T>

virtual casacore::Bool casa::ResidualEquation< T >::residual ( Domain &  answer, casacore::Float &  chisq, const LinearModel< Domain > &  model  )

pure virtual

Same as above, but also calculates Chi^2 (rms of residual image)

Implemented in casa::LinearEquation< Domain, Range >.

template<class T>

virtual casacore::Bool casa::ResidualEquation< T >::residual ( Domain &  answer, casacore::Float &  chisq, Domain &  mask, const LinearModel< Domain > &  model  )

pure virtual

Same as above, but also calculates Chi^2 (rms of residual image) considering a mask image.

Implemented in casa::LinearEquation< Domain, Range >.

---

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

• casa/code/synthesis/MeasurementEquations/Deconvolver.h
• casa/code/synthesis/MeasurementEquations/ResidualEquation.h