Specification of axes to keep or remove. More...

#include <AxesSpecifier.h>

Public Member Functions
	AxesSpecifier ()
	The default constructor keeps all axes.
	AxesSpecifier (Bool keepDegenerate)
	Tell if no or all degenerate axes have to be removed.
	AxesSpecifier (Bool keepDegenerate, const IPosition &axisPath)
	Tell if no or all degenerate axes have to be removed.
	AxesSpecifier (const IPosition &keepAxes)
	Tell which (degenerate) axes have to be kept.
	AxesSpecifier (const IPosition &keepAxes, const IPosition &axisPath)
	The argument `keepAxes` tells which degenerate axes have to be kept.
	AxesSpecifier (const AxesSpecifier &other)
	Copy constructor (copy semantics).
	~AxesSpecifier ()
AxesSpecifier &	operator= (const AxesSpecifier &other)
	Assignment (copy semantics).
AxesMapping	apply (const IPosition &shape) const
	Apply the specification to a shape.
Bool	keep () const
	Are we keeping all degenerate axes ?
Private Attributes
IPosition	itsAxes
IPosition	itsPath
Bool	itsKeep

Detailed Description

Specification of axes to keep or remove.

Intended use:

Public interface

Review Status

Date Reviewed:: yyyy/mm/dd
Test programs:: tAxesSpecifier

Prerequisite

IPosition

Synopsis

AxesSpecifier makes it possible to specify which axes should be used in a shape. Degenerate axes (i.e. axes with length 0) can be thrown away which makes it possible to reduce the dimensionality of an array. All degenerate axes can be thrown away, but one can also specify which ones should be kept.

Another option of this class is to reorder the axes, thus to make the axes of a lattice appear in a different order. This can be useful when two images with diferent axes orders have to be combined.

When an AxesSpecifier has to be used for a lattice, the lattice's shape has to be applied to the AxesSpecifier. The result is a AxesMapping object. This object is (for example) used internally in the SubLattice class to know how to map the axes form the original lattice to the sublattice.
Caution: Reordering axes is not supported (yet) by the other AIPS++ classes like Lattices and Images;

Example

This example tells that all degenerate axes have to be kept. The axes are reordered to 1,0,2. Thus the first and second axes are swapped.

    AxesSpecifier spec(True, IPosition(3,1,0,2));
    AxesMapping map = spec.apply (IPosition(3,4,1,5));
    AlwaysAssertExit (map.posToNew (IPosition(3,2,0,3)) == IPosition(3,0,2,3));
    AlwaysAssertExit (map.posToOld (IPosition(3,0,2,3)) == IPosition(3,2,0,3));
   
    The following specification would have the same effect, because the
    unspecified axes are kept in their natural order.
    AxesSpecifier spec(True, IPosition(1,1));

The same example as above, but now degenerated axes are removed. Note that because the second axis is removed, the third axis now get the second axis, thus gets swapped with the first axis.
Also note the difference between the functions posToOld and shapeToOld.

    AxesSpecifier spec(False, IPosition(1,1));
    AxesMapping map = spec.apply (IPosition(3,4,1,5));
    AlwaysAssertExit (map.posToNew (IPosition(3,2,0,3)) == IPosition(2,3,2));
    AlwaysAssertExit (map.posToOld (IPosition(3,3,2)) == IPosition(3,2,0,3);
    AlwaysAssertExit (map.shapeToOld (IPosition(3,3,2)) == IPosition(3,2,1,3);

Definition at line 111 of file AxesSpecifier.h.

Constructor & Destructor Documentation

casa::AxesSpecifier::AxesSpecifier ( )

The default constructor keeps all axes.

casa::AxesSpecifier::AxesSpecifier ( Bool keepDegenerate ) [explicit]

Tell if no or all degenerate axes have to be removed.

casa::AxesSpecifier::AxesSpecifier	(	Bool	keepDegenerate,
		const IPosition &	axisPath
	)			`[explicit]`

Tell if no or all degenerate axes have to be removed.

The argument axisPath makes it possible to specify in which order the KEPT axes have to be used. Unspecified axes are appended to the end. It gives a means to reorder the axes of a lattice.
E.g. for a 4-dim lattice axisPath [2,0] means axis order [2,0,1,3].

casa::AxesSpecifier::AxesSpecifier ( const IPosition & keepAxes ) [explicit]

Tell which (degenerate) axes have to be kept.

Non-degenerate axes will always be kept.

casa::AxesSpecifier::AxesSpecifier	(	const IPosition &	keepAxes,
		const IPosition &	axisPath
	)

The argument keepAxes tells which degenerate axes have to be kept.

Non-degenerate axes will always be kept.
The argument axisPath makes it possible to specify in which order the KEPT axes have to be used. Unspecified axes are appended to the end. It gives a means to reorder the axes of a lattice.
E.g. for a 4-dim lattice axisPath [2,0] means axis order [2,0,1,3].

casa::AxesSpecifier::AxesSpecifier ( const AxesSpecifier & other )

Copy constructor (copy semantics).

casa::AxesSpecifier::~AxesSpecifier ( )

Member Function Documentation

AxesMapping casa::AxesSpecifier::apply ( const IPosition & shape ) const

Apply the specification to a shape.

It returns an AxesMapping object which takes care of mapping old to new axes order.

Bool casa::AxesSpecifier::keep ( ) const [inline]

Are we keeping all degenerate axes ?

Definition at line 79 of file AxesSpecifier.h.

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

Assignment (copy semantics).

This and that do not have to have the same length.

Member Data Documentation

IPosition casa::AxesSpecifier::itsAxes [private]

Definition at line 79 of file AxesSpecifier.h.

Bool casa::AxesSpecifier::itsKeep [private]

Definition at line 84 of file AxesSpecifier.h.

IPosition casa::AxesSpecifier::itsPath [private]

Definition at line 83 of file AxesSpecifier.h.

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

casa/Arrays/AxesSpecifier.h

casa::AxesSpecifier Class Reference [Arrays_module]

Public Member Functions

Private Attributes