#include <itkAzimuthElevationToCartesianTransform.h>

Inheritance diagram for itk::AzimuthElevationToCartesianTransform< TScalarType, NDimensions >:

Collaboration diagram for itk::AzimuthElevationToCartesianTransform< TScalarType, NDimensions >:

Detailed Description

template<class TScalarType = float, unsigned int NDimensions = 3>
class itk::AzimuthElevationToCartesianTransform< TScalarType, NDimensions >

Transforms from an azimuth, elevation, radius coordinate system to a Cartesian coordinate system, or vice versa.

The three coordinate axis are azimuth, elevation, and range.

The azimuth elevation coordinate system is defined similarly to spherical coordinates but is slightly different in that the azimuth and elevation are measured in degrees between the r-axis (i.e z axis) and the projection on the x-z and y-z planes, respectively. Range, or r, is the distance from the origin.

The equations form performing the conversion from azimuth-elevation coordinates to cartesian coordinates are as follows: z = vcl_sqrt((r^2*(cos(azimuth))^2)/(1 + (cos(azimuth))^2 * (tan(elevation))^2); x = z * vcl_tan(azimuth) y = z * vcl_tan(elevation)

The reversed transforms are: azimuth = arctan(x/y) elevation = arctan(y/z) r = vcl_sqrt(x^2 + y^2 + z^2)

In this class, we can also set what a "forward" transform means. If we call SetForwardAzimuthElevationToCartesian(), a forward transform will return cartesian coordinates when passed azimuth,elevation,r coordinates. Calling SetForwardCartesianToAzimuthElevation() will cause the forward transform to return azimuth,elevation,r coordinates from cartesian coordinates.

Setting the FirstSampleDistance to a non-zero value means that a r value of 12 is actually (12 + FirstSampleDistance) distance from the origin.

There are two template parameters for this class:

ScalarT The type to be used for scalar numeric values. Either float or double.

NDimensions The number of dimensions of the vector space (must be >=3).

Todo:: Is there any real value in allowing the user to template over the scalar type? Perhaps it should always be double, unless there's a compatibility problem with the Point class.

Todo:: Derive this class from a yet undefined TransformBase class. Currently, this class derives from AffineTransform, although it is not an affine transform.

Wiki Examples:

All Examples

Cartesian to AzimuthElevation and vice-versa

Definition at line 82 of file itkAzimuthElevationToCartesianTransform.h.

Public Types
typedef SmartPointer< const Self >	ConstPointer

typedef Superclass::InputPointType	InputPointType

typedef Superclass::JacobianType	JacobianType

typedef Matrix< TScalarType, itkGetStaticConstMacro(SpaceDimension), itkGetStaticConstMacro(SpaceDimension) >	MatrixType

typedef Superclass::OutputPointType	OutputPointType

typedef Superclass::ParametersType	ParametersType

typedef SmartPointer< Self >	Pointer

typedef Superclass::ScalarType	ScalarType

typedef AzimuthElevationToCartesianTransform	Self

typedef AffineTransform < TScalarType, NDimensions >	Superclass

Public Types inherited from itk::AffineTransform< TScalarType, NDimensions >
typedef Superclass::CenterType	CenterType

typedef SmartPointer< const Self >	ConstPointer

typedef Superclass::InputCovariantVectorType	InputCovariantVectorType

typedef Superclass::InputPointType	InputPointType

typedef Superclass::InputVectorType	InputVectorType

typedef Superclass::InputVnlVectorType	InputVnlVectorType

typedef Superclass::InverseMatrixType	InverseMatrixType

typedef InverseTransformBaseType::Pointer	InverseTransformBasePointer

typedef Superclass::InverseTransformBaseType	InverseTransformBaseType

typedef Superclass::JacobianType	JacobianType

typedef Superclass::MatrixType	MatrixType

typedef Superclass::OffsetType	OffsetType

typedef Superclass::OutputCovariantVectorType	OutputCovariantVectorType

typedef Superclass::OutputPointType	OutputPointType

typedef Superclass::OutputVectorType	OutputVectorType

typedef Superclass::OutputVnlVectorType	OutputVnlVectorType

typedef Superclass::ParametersType	ParametersType

typedef SmartPointer< Self >	Pointer

typedef Superclass::ScalarType	ScalarType

typedef AffineTransform	Self

typedef MatrixOffsetTransformBase < TScalarType, NDimensions, NDimensions >	Superclass

typedef Superclass::TranslationType	TranslationType

Public Types inherited from itk::MatrixOffsetTransformBase< TScalarType, NDimensions, NDimensions >
typedef InputPointType	CenterType

typedef SmartPointer< const Self >	ConstPointer

typedef Superclass::InputDiffusionTensor3DType	InputDiffusionTensor3DType

typedef Superclass::InputSymmetricSecondRankTensorType	InputSymmetricSecondRankTensorType

typedef CovariantVector < TScalarType, InputDiffusionTensor3DType::Dimension >	InputTensorEigenVectorType

typedef Superclass::InputVectorPixelType	InputVectorPixelType

typedef Matrix< TScalarType, itkGetStaticConstMacro(InputSpaceDimension), itkGetStaticConstMacro(OutputSpaceDimension)>	InverseMatrixType

typedef InverseTransformBaseType::Pointer	InverseTransformBasePointer

typedef Superclass::InverseTransformBaseType	InverseTransformBaseType

typedef Superclass::JacobianType	JacobianType

typedef OutputVectorType	OffsetType

typedef OffsetType::ValueType	OffsetValueType

typedef Superclass::OutputDiffusionTensor3DType	OutputDiffusionTensor3DType

typedef Superclass::OutputSymmetricSecondRankTensorType	OutputSymmetricSecondRankTensorType

typedef Superclass::OutputVectorPixelType	OutputVectorPixelType

typedef Superclass::ParametersType	ParametersType

typedef Superclass::ParametersValueType	ParametersValueType

typedef SmartPointer< Self >	Pointer

typedef Superclass::ScalarType	ScalarType

typedef MatrixOffsetTransformBase	Self

typedef Transform< TScalarType, NInputDimensions, NOutputDimensions >	Superclass

typedef Superclass::TransformCategoryType	TransformCategoryType

typedef OutputVectorType	TranslationType

typedef TranslationType::ValueType	TranslationValueType

typedef Vector< TScalarType, itkGetStaticConstMacro(InputSpaceDimension)>	InputVectorType

typedef Vector< TScalarType, itkGetStaticConstMacro(OutputSpaceDimension)>	OutputVectorType

typedef OutputVectorType::ValueType	OutputVectorValueType

typedef CovariantVector < TScalarType, itkGetStaticConstMacro(InputSpaceDimension)>	InputCovariantVectorType

typedef CovariantVector < TScalarType, itkGetStaticConstMacro(OutputSpaceDimension)>	OutputCovariantVectorType

typedef vnl_vector_fixed < TScalarType, itkGetStaticConstMacro(InputSpaceDimension)>	InputVnlVectorType

typedef vnl_vector_fixed < TScalarType, itkGetStaticConstMacro(OutputSpaceDimension)>	OutputVnlVectorType

typedef Point< TScalarType, itkGetStaticConstMacro(InputSpaceDimension)>	InputPointType

typedef InputPointType::ValueType	InputPointValueType

typedef Point< TScalarType, itkGetStaticConstMacro(OutputSpaceDimension)>	OutputPointType

typedef OutputPointType::ValueType	OutputPointValueType

typedef Matrix< TScalarType, itkGetStaticConstMacro(OutputSpaceDimension), itkGetStaticConstMacro(InputSpaceDimension)>	MatrixType

typedef MatrixType::ValueType	MatrixValueType

Public Types inherited from itk::Transform< TScalarType, NInputDimensions, NOutputDimensions >
typedef SmartPointer< const Self >	ConstPointer

typedef Array < ParametersValueType >	DerivativeType

typedef Matrix< double, itkGetStaticConstMacro(OutputSpaceDimension), itkGetStaticConstMacro(InputSpaceDimension)>	DirectionChangeMatrix

typedef CovariantVector < TScalarType, NInputDimensions >	InputCovariantVectorType

typedef DiffusionTensor3D < TScalarType >	InputDiffusionTensor3DType

typedef Matrix< double, itkGetStaticConstMacro(InputSpaceDimension), itkGetStaticConstMacro(InputSpaceDimension)>	InputDirectionMatrix

typedef Point< TScalarType, NInputDimensions >	InputPointType

typedef SymmetricSecondRankTensor < TScalarType, NInputDimensions >	InputSymmetricSecondRankTensorType

typedef VariableLengthVector < TScalarType >	InputVectorPixelType

typedef Vector< TScalarType, NInputDimensions >	InputVectorType

typedef vnl_vector_fixed < TScalarType, NInputDimensions >	InputVnlVectorType

typedef InverseTransformBaseType::Pointer	InverseTransformBasePointer

typedef Transform< TScalarType, NOutputDimensions, NInputDimensions >	InverseTransformBaseType

typedef Array2D < ParametersValueType >	JacobianType

typedef Matrix< TScalarType, itkGetStaticConstMacro(OutputSpaceDimension), itkGetStaticConstMacro(InputSpaceDimension)>	MatrixType

typedef Superclass::NumberOfParametersType	NumberOfParametersType

typedef CovariantVector < TScalarType, NOutputDimensions >	OutputCovariantVectorType

typedef DiffusionTensor3D < TScalarType >	OutputDiffusionTensor3DType

typedef Matrix< double, itkGetStaticConstMacro(OutputSpaceDimension), itkGetStaticConstMacro(OutputSpaceDimension)>	OutputDirectionMatrix

typedef Point< TScalarType, NOutputDimensions >	OutputPointType

typedef SymmetricSecondRankTensor < TScalarType, NOutputDimensions >	OutputSymmetricSecondRankTensorType

typedef VariableLengthVector < TScalarType >	OutputVectorPixelType

typedef Vector< TScalarType, NOutputDimensions >	OutputVectorType

typedef vnl_vector_fixed < TScalarType, NOutputDimensions >	OutputVnlVectorType

typedef Superclass::ParametersType	ParametersType

typedef Superclass::ParametersValueType	ParametersValueType

typedef SmartPointer< Self >	Pointer

typedef TScalarType	ScalarType

typedef Transform	Self

typedef TransformBase	Superclass

Public Types inherited from itk::TransformBase
typedef SmartPointer< const Self >	ConstPointer

typedef IdentifierType	NumberOfParametersType

typedef OptimizerParameters < ParametersValueType >	ParametersType

typedef double	ParametersValueType

typedef SmartPointer< Self >	Pointer

typedef TransformBase	Self

typedef Object	Superclass

enum	TransformCategoryType { UnknownTransformCategory =0, Linear =1, BSpline =2, Spline =3, DisplacementField =4, VelocityField =5 }

Public Types inherited from itk::Object
typedef SmartPointer< const Self >	ConstPointer

typedef SmartPointer< Self >	Pointer

typedef Object	Self

typedef LightObject	Superclass

Public Types inherited from itk::LightObject
typedef SmartPointer< const Self >	ConstPointer

typedef SmartPointer< Self >	Pointer

typedef LightObject	Self

Public Member Functions
InputPointType	BackTransform (const OutputPointType &point) const

InputPointType	BackTransformPoint (const OutputPointType &point) const

virtual ::itk::LightObject::Pointer	CreateAnother (void) const

virtual const char *	GetNameOfClass () const

void	SetAzimuthElevationToCartesianParameters (const double sampleSize, const double blanking, const long maxAzimuth, const long maxElevation, const double azimuthAngleSeparation, const double elevationAngleSeparation)

void	SetAzimuthElevationToCartesianParameters (const double sampleSize, const double blanking, const long maxAzimuth, const long maxElevation)

void	SetForwardAzimuthElevationToCartesian ()

void	SetForwardCartesianToAzimuthElevation ()

OutputPointType	TransformAzElToCartesian (const InputPointType &point) const

OutputPointType	TransformCartesianToAzEl (const OutputPointType &point) const

OutputPointType	TransformPoint (const InputPointType &point) const


virtual void	SetMaxAzimuth (long _arg)

virtual long	GetMaxAzimuth () const


virtual void	SetMaxElevation (long _arg)

virtual long	GetMaxElevation () const


virtual void	SetRadiusSampleSize (double _arg)

virtual double	GetRadiusSampleSize () const


virtual void	SetAzimuthAngularSeparation (double _arg)

virtual double	GetAzimuthAngularSeparation () const


virtual void	SetElevationAngularSeparation (double _arg)

virtual double	GetElevationAngularSeparation () const


virtual void	SetFirstSampleDistance (double _arg)

virtual double	GetFirstSampleDistance () const

Public Member Functions inherited from itk::AffineTransform< TScalarType, NDimensions >
bool	GetInverse (Self *inverse) const

virtual InverseTransformBasePointer	GetInverseTransform () const

	itkLegacyMacro (InputPointType BackTransformPoint(const OutputPointType &point) const)

ScalarType	Metric (const Self *other) const

ScalarType	Metric (void) const

void	Rotate2D (TScalarType angle, bool pre=0)

void	Rotate3D (const OutputVectorType &axis, TScalarType angle, bool pre=0)

void	Scale (const OutputVectorType &factor, bool pre=0)

void	Scale (const TScalarType &factor, bool pre=0)

void	Shear (int axis1, int axis2, TScalarType coef, bool pre=0)

void	Translate (const OutputVectorType &offset, bool pre=0)

void	Rotate (int axis1, int axis2, TScalarType angle, bool pre=0)

	itkLegacyMacro (InputPointType BackTransform(const OutputPointType &point) const)

	itkLegacyMacro (InputVectorType BackTransform(const OutputVectorType &vector) const)

	itkLegacyMacro (InputVnlVectorType BackTransform(const OutputVnlVectorType &vector) const)

	itkLegacyMacro (InputCovariantVectorType BackTransform(const OutputCovariantVectorType &vector) const)

Public Member Functions inherited from itk::MatrixOffsetTransformBase< TScalarType, NDimensions, NDimensions >
void	Compose (const Self *other, bool pre=0)

virtual void	ComputeInverseJacobianWithRespectToPosition (const InputPointType &x, JacobianType &jac) const

virtual void	ComputeJacobianWithRespectToParameters (const InputPointType &x, JacobianType &j) const

virtual void	ComputeJacobianWithRespectToPosition (const InputPointType &x, JacobianType &jac) const

virtual ::itk::LightObject::Pointer	CreateAnother (void) const

const InputPointType &	GetCenter () const

virtual const ParametersType &	GetFixedParameters (void) const

virtual const MatrixType &	GetMatrix () const

const OutputVectorType &	GetOffset (void) const

const ParametersType &	GetParameters (void) const

virtual TransformCategoryType	GetTransformCategory () const

const OutputVectorType &	GetTranslation (void) const

virtual bool	IsLinear () const

virtual void	SetFixedParameters (const ParametersType &)

virtual void	SetIdentity (void)

void	SetParameters (const ParametersType &parameters)

OutputCovariantVectorType	TransformCovariantVector (const InputCovariantVectorType &vector) const

OutputVectorPixelType	TransformCovariantVector (const InputVectorPixelType &vector) const

OutputDiffusionTensor3DType	TransformDiffusionTensor3D (const InputDiffusionTensor3DType &tensor) const

OutputVectorPixelType	TransformDiffusionTensor3D (const InputVectorPixelType &tensor) const

OutputPointType	TransformPoint (const InputPointType &point) const

OutputSymmetricSecondRankTensorType	TransformSymmetricSecondRankTensor (const InputSymmetricSecondRankTensorType &tensor) const

OutputVectorPixelType	TransformSymmetricSecondRankTensor (const InputVectorPixelType &tensor) const

OutputVectorType	TransformVector (const InputVectorType &vector) const

OutputVnlVectorType	TransformVector (const InputVnlVectorType &vector) const

OutputVectorPixelType	TransformVector (const InputVectorPixelType &vector) const

virtual void	SetMatrix (const MatrixType &matrix)

void	SetOffset (const OutputVectorType &offset)

void	SetCenter (const InputPointType &center)

void	SetTranslation (const OutputVectorType &translation)

bool	GetInverse (Self *inverse) const

Public Member Functions inherited from itk::Transform< TScalarType, NInputDimensions, NOutputDimensions >
unsigned int	GetInputSpaceDimension (void) const

bool	GetInverse (Self *) const

virtual NumberOfParametersType	GetNumberOfLocalParameters (void) const

virtual NumberOfParametersType	GetNumberOfParameters (void) const

unsigned int	GetOutputSpaceDimension (void) const

virtual std::string	GetTransformTypeAsString () const

	itkCloneMacro (Self)

virtual void	SetParametersByValue (const ParametersType &p)

virtual OutputCovariantVectorType	TransformCovariantVector (const InputCovariantVectorType &vector, const InputPointType &point) const

virtual OutputVectorPixelType	TransformCovariantVector (const InputVectorPixelType &vector, const InputPointType &point) const

virtual OutputDiffusionTensor3DType	TransformDiffusionTensor3D (const InputDiffusionTensor3DType &tensor, const InputPointType &point) const

virtual OutputVectorPixelType	TransformDiffusionTensor3D (const InputVectorPixelType &tensor, const InputPointType &point) const

virtual OutputSymmetricSecondRankTensorType	TransformSymmetricSecondRankTensor (const InputSymmetricSecondRankTensorType &tensor, const InputPointType &point) const

virtual OutputVectorPixelType	TransformSymmetricSecondRankTensor (const InputVectorPixelType &tensor, const InputPointType &point) const

virtual OutputVectorType	TransformVector (const InputVectorType &vector, const InputPointType &point) const

virtual OutputVnlVectorType	TransformVector (const InputVnlVectorType &vector, const InputPointType &point) const

virtual OutputVectorPixelType	TransformVector (const InputVectorPixelType &vector, const InputPointType &point) const

virtual void	UpdateTransformParameters (const DerivativeType &update, TScalarType factor=1.0)

Public Member Functions inherited from itk::TransformBase
virtual void	SetFixedParameters (const ParametersType &)=0

virtual void	SetParameters (const ParametersType &)=0

virtual void	SetParametersByValue (const ParametersType &p)=0

Public Member Functions inherited from itk::Object
unsigned long	AddObserver (const EventObject &event, Command *)

unsigned long	AddObserver (const EventObject &event, Command *) const

virtual void	DebugOff () const

virtual void	DebugOn () const

Command *	GetCommand (unsigned long tag)

bool	GetDebug () const

MetaDataDictionary &	GetMetaDataDictionary (void)

const MetaDataDictionary &	GetMetaDataDictionary (void) const

virtual ModifiedTimeType	GetMTime () const

virtual const TimeStamp &	GetTimeStamp () const

bool	HasObserver (const EventObject &event) const

void	InvokeEvent (const EventObject &)

void	InvokeEvent (const EventObject &) const

virtual void	Modified () const

virtual void	Register () const

void	RemoveAllObservers ()

void	RemoveObserver (unsigned long tag)

void	SetDebug (bool debugFlag) const

void	SetMetaDataDictionary (const MetaDataDictionary &rhs)

virtual void	SetReferenceCount (int)

virtual void	UnRegister () const

Public Member Functions inherited from itk::LightObject
virtual void	Delete ()

virtual int	GetReferenceCount () const

	itkCloneMacro (Self)

void	Print (std::ostream &os, Indent indent=0) const

Static Public Member Functions
static Pointer	New ()

Static Public Member Functions inherited from itk::AffineTransform< TScalarType, NDimensions >
static Pointer	New ()

Static Public Member Functions inherited from itk::MatrixOffsetTransformBase< TScalarType, NDimensions, NDimensions >
static Pointer	New ()

Static Public Attributes

static const unsigned int	SpaceDimension = NDimensions

static const unsigned int	ParametersDimension = NDimensions * ( NDimensions + 1 )

Static Public Attributes inherited from itk::AffineTransform< TScalarType, NDimensions >
static const unsigned int	InputSpaceDimension = NDimensions

static const unsigned int	OutputSpaceDimension = NDimensions

static const unsigned int	SpaceDimension = NDimensions

static const unsigned int	ParametersDimension = NDimensions *( NDimensions + 1 )

Static Public Attributes inherited from itk::MatrixOffsetTransformBase< TScalarType, NDimensions, NDimensions >
static const unsigned int	InputSpaceDimension

static const unsigned int	OutputSpaceDimension

static const unsigned int	ParametersDimension

Static Public Attributes inherited from itk::Transform< TScalarType, NInputDimensions, NOutputDimensions >
static const unsigned int	InputSpaceDimension = NInputDimensions

static const unsigned int	OutputSpaceDimension = NOutputDimensions

Protected Member Functions
	AzimuthElevationToCartesianTransform ()

void	PrintSelf (std::ostream &s, Indent indent) const

virtual	~AzimuthElevationToCartesianTransform ()

Protected Member Functions inherited from itk::AffineTransform< TScalarType, NDimensions >
virtual	~AffineTransform ()

	AffineTransform (const MatrixType &matrix, const OutputVectorType &offset)

	AffineTransform (unsigned int paramDims)

	AffineTransform ()

Protected Member Functions inherited from itk::MatrixOffsetTransformBase< TScalarType, NDimensions, NDimensions >
virtual void	ComputeMatrix (void)

virtual void	ComputeMatrixParameters (void)

virtual void	ComputeOffset (void)

virtual void	ComputeTranslation (void)

const InverseMatrixType &	GetInverseMatrix (void) const

const InverseMatrixType &	GetVarInverseMatrix (void) const

bool	InverseMatrixIsOld (void) const

void	PrintSelf (std::ostream &s, Indent indent) const

void	SetVarCenter (const InputPointType &center)

void	SetVarInverseMatrix (const InverseMatrixType &matrix) const

void	SetVarMatrix (const MatrixType &matrix)

void	SetVarOffset (const OutputVectorType &offset)

void	SetVarTranslation (const OutputVectorType &translation)

virtual	~MatrixOffsetTransformBase ()

	MatrixOffsetTransformBase (const MatrixType &matrix, const OutputVectorType &offset)

	MatrixOffsetTransformBase (unsigned int paramDims)

	MatrixOffsetTransformBase ()

Protected Member Functions inherited from itk::Transform< TScalarType, NInputDimensions, NOutputDimensions >
virtual LightObject::Pointer	InternalClone () const

OutputDiffusionTensor3DType	PreservationOfPrincipalDirectionDiffusionTensor3DReorientation (const InputDiffusionTensor3DType, const JacobianType) const

	Transform ()

	Transform (NumberOfParametersType NumberOfParameters)

virtual	~Transform ()

Protected Member Functions inherited from itk::TransformBase
	TransformBase ()

virtual	~TransformBase ()

Protected Member Functions inherited from itk::Object
	Object ()

bool	PrintObservers (std::ostream &os, Indent indent) const

virtual void	SetTimeStamp (const TimeStamp &time)

virtual	~Object ()

Protected Member Functions inherited from itk::LightObject
	LightObject ()

virtual void	PrintHeader (std::ostream &os, Indent indent) const

virtual void	PrintTrailer (std::ostream &os, Indent indent) const

virtual	~LightObject ()

Private Member Functions
	AzimuthElevationToCartesianTransform (const Self &)

void	operator= (const Self &)

Private Attributes
double	m_AzimuthAngularSeparation

double	m_ElevationAngularSeparation

double	m_FirstSampleDistance

bool	m_ForwardAzimuthElevationToPhysical

long	m_MaxAzimuth

long	m_MaxElevation

double	m_RadiusSampleSize

Additional Inherited Members
Protected Types inherited from itk::LightObject
typedef int	InternalReferenceCountType

Protected Attributes inherited from itk::Transform< TScalarType, NInputDimensions, NOutputDimensions >
DirectionChangeMatrix	m_DirectionChange

ParametersType	m_FixedParameters

ParametersType	m_Parameters