casacore::GaussianConvert Class Reference

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.
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 Casacore

Definition at line 72 of file GaussianConvert.h.

Constructor & Destructor Documentation

casacore::GaussianConvert::GaussianConvert ( )

Default constructor.

casacore::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)

casacore::GaussianConvert::~GaussianConvert ( )

Destructor.

casacore::GaussianConvert::GaussianConvert ( const GaussianConvert & other )

Copy constructor.

Uses copy semantics.

Member Function Documentation

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

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

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

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

Recover error messages from the conversion functions.

Definition at line 129 of file GaussianConvert.h.

References itsErrorMessage.

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

Assignment operator.

Uses copy semantics.

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

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

(Re)set the coordinate system

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

Re(set) the world axes.

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

Convert location.

Bool casacore::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 casacore::GaussianConvert::toWorld	(	Vector< Quantum< Double > > &	world,
		const Vector< Double > &	pixel
	)

Bool casacore::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.