Converts Gaussian parameters between pixel and world. More...

#include <GaussianConvert.h>

Public Member Functions
	GaussianConvert ()
	Default constructor.
	GaussianConvert (const CoordinateSystem &cSys, const Vector< uInt > &worldAxes)
	Constructor.
	~GaussianConvert ()
	Destructor.
	GaussianConvert (const GaussianConvert &other)
	Copy constructor.
GaussianConvert &	operator= (const GaussianConvert &other)
	Assignment operator.
void	setCoordinateSystem (const CoordinateSystem &cSys)
	(Re)set the coordinate system
void	setWorldAxes (const Vector< uInt > &worldAxes)
	Re(set) the world axes.
Bool	toWorld (Quantum< Double > &majorAxisOut, Quantum< Double > &minorAxisOut, Quantum< Double > &positionAngleOut, Double majorAxisIn, Double minorAxisIn, const Quantum< Double > &positionAngleIn)
	Convert Gaussian parameters from pixels to world.
Bool	toPixel (Double &majorAxisOut, Double &minorAxisOut, Quantum< Double > &positionAngleOut, const Quantum< Double > &majorAxisIn, const Quantum< Double > &minorAxisIn, const Quantum< Double > &positionAngleIn)
	Convert Gaussian parameters from world to pixel.
Bool	toPixel (Vector< Double > &pixel, const Vector< Quantum< Double > > &world)
	Convert location.
Bool	toWorld (Vector< Quantum< Double > > &world, const Vector< Double > &pixel)
String	errorMessage () const
	Recover error messages from the conversion functions.
Static Public Member Functions
static Bool	deconvolve (Quantum< Double > &majorAxisModel, Quantum< Double > &minorAxisModel, Quantum< Double > &positionAngleModel, const Quantum< Double > &majorAxisSource, const Quantum< Double > &minorAxisSource, const Quantum< Double > &positionAngleSource, const Quantum< Double > &majorAxisBeam, const Quantum< Double > &minorAxisBeam, const Quantum< Double > &positionAngleBeam)
	Deconvolve the parameters of a source Gaussian from a beam Gaussian to give a model Gaussian.
Private Member Functions
void	convertAxes (Double &minorAxisOut, Double &majorAxisOut, Quantum< Double > &positionAngleOut, Double minorAxisIn, Double majorAxisIn, const Quantum< Double > &positionAngleIn, const CoordinateSystem &cSys, String dir)
void	checkCoordinateSystem ()
void	checkWorldAxes ()
Double	positionAngleRange (Double pa)
Private Attributes
CoordinateSystem	itsCSys
Vector< uInt >	itsWorldAxes
String	itsErrorMessage
Bool	itsValid

Detailed Description

Converts Gaussian parameters between pixel and world.

Intended use:

Public interface

Prerequisite

CoordinateSystem

Synopsis

Converts Gaussian parameters between world and pixel. In the pixel coordinate system ([0,0] in center of image) the position angle is positive +y to -x. This is consistent with Gaussian2D. In the world coordinate system the pa is positive N through E

Example

To Do

Position angle signs require more thinking in aips++

Definition at line 70 of file GaussianConvert.h.

Constructor & Destructor Documentation

casa::GaussianConvert::GaussianConvert ( )

Default constructor.

casa::GaussianConvert::GaussianConvert	(	const CoordinateSystem &	cSys,
		const Vector< uInt > &	worldAxes
	)

Constructor.

You specify which world axes (must be length 2) of the coordinate system are the relevant ones for your gaussian (x then y)

casa::GaussianConvert::~GaussianConvert ( )

Destructor.

casa::GaussianConvert::GaussianConvert ( const GaussianConvert & other )

Copy constructor.

Uses copy semantics.

Member Function Documentation

void casa::GaussianConvert::checkCoordinateSystem ( ) [private]

void casa::GaussianConvert::checkWorldAxes ( ) [private]

void casa::GaussianConvert::convertAxes	(	Double &	minorAxisOut,
		Double &	majorAxisOut,
		Quantum< Double > &	positionAngleOut,
		Double	minorAxisIn,
		Double	majorAxisIn,
		const Quantum< Double > &	positionAngleIn,
		const CoordinateSystem &	cSys,
		String	dir
	)			`[private]`

static Bool casa::GaussianConvert::deconvolve	(	Quantum< Double > &	majorAxisModel,
		Quantum< Double > &	minorAxisModel,
		Quantum< Double > &	positionAngleModel,
		const Quantum< Double > &	majorAxisSource,
		const Quantum< Double > &	minorAxisSource,
		const Quantum< Double > &	positionAngleSource,
		const Quantum< Double > &	majorAxisBeam,
		const Quantum< Double > &	minorAxisBeam,
		const Quantum< Double > &	positionAngleBeam
	)			`[static]`

Deconvolve the parameters of a source Gaussian from a beam Gaussian to give a model Gaussian.

The return is True if the model appears to be a point source and the output model will be set to the parameters of the beam. If the units of the model are not given, they will be set to the units of the source.

String casa::GaussianConvert::errorMessage ( ) const [inline]

Recover error messages from the conversion functions.

Definition at line 142 of file GaussianConvert.h.

References itsErrorMessage.

GaussianConvert& casa::GaussianConvert::operator= ( const GaussianConvert & other )

Assignment operator.

Uses copy semantics.

Double casa::GaussianConvert::positionAngleRange ( Double pa ) [private]

void casa::GaussianConvert::setCoordinateSystem ( const CoordinateSystem & cSys )

(Re)set the coordinate system

void casa::GaussianConvert::setWorldAxes ( const Vector< uInt > & worldAxes )

Re(set) the world axes.

Bool casa::GaussianConvert::toPixel	(	Vector< Double > &	pixel,
		const Vector< Quantum< Double > > &	world
	)

Convert location.

Bool casa::GaussianConvert::toPixel	(	Double &	majorAxisOut,
		Double &	minorAxisOut,
		Quantum< Double > &	positionAngleOut,
		const Quantum< Double > &	majorAxisIn,
		const Quantum< Double > &	minorAxisIn,
		const Quantum< Double > &	positionAngleIn
	)

Convert Gaussian parameters from world to pixel.

Returns False if it fails with an error message recoverable with function errorMessage. For the output position angle, if the output units are not set, the units of the input position angle will be used.

Bool casa::GaussianConvert::toWorld	(	Quantum< Double > &	majorAxisOut,
		Quantum< Double > &	minorAxisOut,
		Quantum< Double > &	positionAngleOut,
		Double	majorAxisIn,
		Double	minorAxisIn,
		const Quantum< Double > &	positionAngleIn
	)

Convert Gaussian parameters from pixels to world.

Returns False if it fails with an error message recoverable with function errorMessage. If you set the units of the output axis quanta they will be honoured, otherwise they will come out in the axis units of the coordinate system. For the output position angle, if the output units are not set, the units of the input position angle will be used.