casacore
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Public Member Functions | Private Attributes | List of all members
casacore::AxesSpecifier Class Reference

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

#include <AxesSpecifier.h>

Public Member Functions

 AxesSpecifier ()
 The default constructor keeps all axes. More...
 
 AxesSpecifier (bool keepDegenerate)
 Tell if no or all degenerate axes have to be removed. More...
 
 AxesSpecifier (bool keepDegenerate, const IPosition &axisPath)
 Tell if no or all degenerate axes have to be removed. More...
 
 AxesSpecifier (const IPosition &keepAxes)
 Tell which (degenerate) axes have to be kept. More...
 
 AxesSpecifier (const IPosition &keepAxes, const IPosition &axisPath)
 The argument keepAxes tells which degenerate axes have to be kept. More...
 
AxesMapping apply (const IPosition &shape) const
 Apply the specification to a shape. More...
 
bool keep () const
 Are we keeping all degenerate axes ? More...
 

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

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 casacore 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 Casacore 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 110 of file AxesSpecifier.h.

Constructor & Destructor Documentation

casacore::AxesSpecifier::AxesSpecifier ( )

The default constructor keeps all axes.

casacore::AxesSpecifier::AxesSpecifier ( bool  keepDegenerate)
explicit

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

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

casacore::AxesSpecifier::AxesSpecifier ( const IPosition keepAxes)
explicit

Tell which (degenerate) axes have to be kept.

Non-degenerate axes will always be kept.

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

Member Function Documentation

AxesMapping casacore::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 casacore::AxesSpecifier::keep ( ) const
inline

Are we keeping all degenerate axes ?

Definition at line 144 of file AxesSpecifier.h.

References itsKeep.

Member Data Documentation

IPosition casacore::AxesSpecifier::itsAxes
private

Definition at line 144 of file AxesSpecifier.h.

bool casacore::AxesSpecifier::itsKeep
private

Definition at line 149 of file AxesSpecifier.h.

Referenced by keep().

IPosition casacore::AxesSpecifier::itsPath
private

Definition at line 148 of file AxesSpecifier.h.


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