casacore
Public Types | Static Public Member Functions | List of all members
casacore::LatticeStatsBase Class Reference

More...

#include <LatticeStatsBase.h>

Public Types

enum  StatisticsTypes {
  NPTS ,
  SUM ,
  SUMSQ ,
  MEDIAN ,
  MEDABSDEVMED ,
  QUARTILE ,
  Q1 ,
  Q3 ,
  MIN ,
  MAX ,
  MEAN ,
  VARIANCE ,
  SIGMA ,
  RMS ,
  FLUX ,
  NSTATS ,
  NACCUM
}
 This enum StatisticTypes is provided for use with the LatticeStatistics<T>::setPlotting function. More...
 

Static Public Member Functions

static Vector< InttoStatisticTypes (const String &statistics, const std::regex &delimiter)
 Helper function to convert a String containing a list of desired statistics to the correct Vector<Int> required for the LatticeStatistics<T>::setPlotting function. More...
 
static Vector< InttoStatisticTypes (const Vector< String > &statistics)
 
static String toStatisticName (StatisticsTypes type)
 Convert type to string. More...
 
static String toStatisticName (Int type)
 
static Int toStatisticType (const String &statistic)
 Returns -1 if the statistic string is not valid. More...
 
static Bool setNxy (Vector< Int > &nxy, ostream &os)
 Check and fill in defaults for a Vector<Int> containing the number of subplots in x and y to be put on a plot. More...
 
static void setStorageImageShape (IPosition &storeImageShape, const Bool &last, const Int &axisSize, const Vector< Int > &displayAxes, const IPosition &shape)
 A storage image is used to accumulate information as a function of the display axes as an image is iterated through. More...
 
static void stretchMinMax (Float &min, Float &max)
 Stretch a range by 10%. More...
 
static std::set< DoublequartileFracs ()
 

Detailed Description

Base class for LatticeStatistics class

Intended use:

Public interface

Review Status

Date Reviewed:
yyyy/mm/dd

Prerequisite

Etymology

A simple base class for the LatticeStatistics class

Synopsis

This base class provides an enum defining allowed statistics types and a helper function to convert between a String and a Vector<Int> describing the desired statistics to plot. The reason for having it as a base class rather than just part of LatticeStatistics is that the latter is templated, and it doesn't make much sense to invoke the static function setStatisticTypes function with a templated type.

Example

Vector<Int> statsToPlot = LatticeStatsBase::toStatisticTypes("mean,rms,sigma");
static Vector< Int > toStatisticTypes(const String &statistics, const std::regex &delimiter)
Helper function to convert a String containing a list of desired statistics to the correct Vector<Int...

Definition at line 76 of file LatticeStatsBase.h.

Member Enumeration Documentation

◆ StatisticsTypes

This enum StatisticTypes is provided for use with the LatticeStatistics<T>::setPlotting function.

It gives the allowed statistics types that you can ask for.

Enumerator
NPTS 

The number of points.

SUM 

The sum.

SUMSQ 

The sum squared.

MEDIAN 

The median - the robust stats does not fit well into storage lattice approach.

MEDABSDEVMED 

median of absolute deviation from median

QUARTILE 

inter-quartile range

Q1 

The first and third quartiles.

Q3 
MIN 

The minimum.

MAX 

The maximum.

MEAN 

The mean.

VARIANCE 

The variance about the mean.

SIGMA 

The standard deviation about the mean.

RMS 

The rms.

FLUX 

The flux density (can't always compute this - needs the beam)

NSTATS 

The total number of available statistics to plot.

NACCUM 

The total number of accumulation image items (not for general use: note that the accumulation items MUST come first in this enum) dmehring changed from VARIANCE+1 to SIGMA+1 because the standard deviation should be stored rather than taking the square root of the same value multiple times.

Not to mention the biweight algorithm does not compute the variance, so that the standard deviation must be explicitly stored for it.

Definition at line 84 of file LatticeStatsBase.h.

Member Function Documentation

◆ quartileFracs()

static std::set<Double> casacore::LatticeStatsBase::quartileFracs ( )
static

◆ setNxy()

static Bool casacore::LatticeStatsBase::setNxy ( Vector< Int > &  nxy,
ostream &  os 
)
static

Check and fill in defaults for a Vector<Int> containing the number of subplots in x and y to be put on a plot.

The Vector<Int> is resized to 2 before assignment. A return value of False indicates invalid arguments.

◆ setStorageImageShape()

static void casacore::LatticeStatsBase::setStorageImageShape ( IPosition storeImageShape,
const Bool last,
const Int axisSize,
const Vector< Int > &  displayAxes,
const IPosition shape 
)
static

A storage image is used to accumulate information as a function of the display axes as an image is iterated through.

This function sets the storage image shape to that appropriate to the shape of the display axes and the desired size of the first or last dimension.

◆ stretchMinMax()

static void casacore::LatticeStatsBase::stretchMinMax ( Float min,
Float max 
)
static

Stretch a range by 10%.

◆ toStatisticName() [1/2]

static String casacore::LatticeStatsBase::toStatisticName ( Int  type)
static

◆ toStatisticName() [2/2]

static String casacore::LatticeStatsBase::toStatisticName ( StatisticsTypes  type)
static

Convert type to string.

◆ toStatisticType()

static Int casacore::LatticeStatsBase::toStatisticType ( const String statistic)
static

Returns -1 if the statistic string is not valid.

◆ toStatisticTypes() [1/2]

static Vector<Int> casacore::LatticeStatsBase::toStatisticTypes ( const String statistics,
const std::regex &  delimiter 
)
static

Helper function to convert a String containing a list of desired statistics to the correct Vector<Int> required for the LatticeStatistics<T>::setPlotting function.

This may be usful if your user interface involves strings rather than integers. A new value is added to the output vector (which is resized appropriately) if any of the substrings "npts", "min", "max", "sum", "sumsq", "mean", "sigma", "rms", and "flux" is present. An empty vector results if there are no matches

◆ toStatisticTypes() [2/2]

static Vector<Int> casacore::LatticeStatsBase::toStatisticTypes ( const Vector< String > &  statistics)
static

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