casacore
Public Member Functions | Static Private Member Functions | Private Attributes | List of all members
casacore::DiscreteUniform Class Reference

Discrete uniform distribution. More...

#include <Random.h>

Public Member Functions

 DiscreteUniform (RNG *gen, Int low=-1, Int high=1)
 Construct a random number generator for a discrete uniform distribution. More...
 
virtual ~DiscreteUniform ()
 The destructor is trivial. More...
 
virtual Double operator() ()
 Returns a value from the discrete uniform distribution. More...
 
Int asInt ()
 
Int low () const
 Functions that allow you to query and change the parameters of the discrete uniform distribution. More...
 
void low (Int x)
 
Int high () const
 
void high (Int x)
 
void range (Int low, Int high)
 
virtual void setParameters (const Vector< Double > &parms)
 These function allow you to manipulate the parameters (low & high) described above through the base class. More...
 
virtual Vector< Doubleparameters () const
 
virtual Bool checkParameters (const Vector< Double > &parms) const
 
- Public Member Functions inherited from casacore::Random
virtual ~Random ()
 A virtual destructor is needed to ensure that the destructor of derived classes gets used. More...
 
RNGgenerator ()
 Functions that allow you to access and change the class that generates the random bits. More...
 
void generator (RNG *p)
 

Static Private Member Functions

static Double calcDelta (Int low, Int high)
 

Private Attributes

Int itsLow
 
Int itsHigh
 
Double itsDelta
 

Additional Inherited Members

- Public Types inherited from casacore::Random
enum  Types {
  BINOMIAL ,
  DISCRETEUNIFORM ,
  ERLANG ,
  GEOMETRIC ,
  HYPERGEOMETRIC ,
  NORMAL ,
  LOGNORMAL ,
  NEGATIVEEXPONENTIAL ,
  POISSON ,
  UNIFORM ,
  WEIBULL ,
  UNKNOWN ,
  NUMBER_TYPES
}
 This enumerator lists all the predefined random number distributions. More...
 
- Static Public Member Functions inherited from casacore::Random
static String asString (Random::Types type)
 Convert the enumerator to a lower-case string. More...
 
static Random::Types asType (const String &str)
 Convert the string to enumerator. More...
 
static Randomconstruct (Random::Types type, RNG *gen)
 Convert the Random::Type enumerator to a specific object (derived from Random but upcast to a Random object). More...
 
static Vector< DoubledefaultParameters (Random::Types type)
 returns the default parameters for the specified distribution. More...
 
- Protected Member Functions inherited from casacore::Random
 Random (RNG *generator)
 
- Protected Attributes inherited from casacore::Random
RNGitsRNG
 

Detailed Description

Discrete uniform distribution.

Synopsis

The DiscreteUniform class implements a quantized uniform random variable over the closed interval ranging from [low..high]. The low parameter is the lowest possible return value and the high parameter is the highest. The operator() functions returns a value from this distribution. It is possible to get this same value as an integer using the asInt function.

It is assumed that low limit is less than the high limit and an AipsError exception thrown if this is not true. The remaining members allow you to read and set the parameters.

Example

Thrown Exceptions

To Do

Definition at line 662 of file Random.h.

Constructor & Destructor Documentation

◆ DiscreteUniform()

casacore::DiscreteUniform::DiscreteUniform ( RNG gen,
Int  low = -1,
Int  high = 1 
)

Construct a random number generator for a discrete uniform distribution.

The first argument is a class that produces random bits. This pointer is NOT taken over by this class and the user is responsible for deleting it. The second and third arguments define the range of possible return values for this distribution as described in the synopsis.

◆ ~DiscreteUniform()

virtual casacore::DiscreteUniform::~DiscreteUniform ( )
virtual

The destructor is trivial.

Member Function Documentation

◆ asInt()

Int casacore::DiscreteUniform::asInt ( )

◆ calcDelta()

static Double casacore::DiscreteUniform::calcDelta ( Int  low,
Int  high 
)
staticprivate

◆ checkParameters()

virtual Bool casacore::DiscreteUniform::checkParameters ( const Vector< Double > &  parms) const
virtual

Implements casacore::Random.

◆ high() [1/2]

Int casacore::DiscreteUniform::high ( ) const
inline

Definition at line 713 of file Random.h.

References itsHigh.

◆ high() [2/2]

void casacore::DiscreteUniform::high ( Int  x)

◆ low() [1/2]

Int casacore::DiscreteUniform::low ( ) const
inline

Functions that allow you to query and change the parameters of the discrete uniform distribution.


Definition at line 709 of file Random.h.

References itsLow.

◆ low() [2/2]

void casacore::DiscreteUniform::low ( Int  x)

◆ operator()()

virtual Double casacore::DiscreteUniform::operator() ( )
virtual

Returns a value from the discrete uniform distribution.

The returned value is a integer and using the asInt function bypasses the conversion to a floating point number.

Implements casacore::Random.

◆ parameters()

virtual Vector<Double> casacore::DiscreteUniform::parameters ( ) const
virtual

Implements casacore::Random.

◆ range()

void casacore::DiscreteUniform::range ( Int  low,
Int  high 
)

◆ setParameters()

virtual void casacore::DiscreteUniform::setParameters ( const Vector< Double > &  parms)
virtual

These function allow you to manipulate the parameters (low & high) described above through the base class.

The Vectors must always be of length two.

Implements casacore::Random.

Member Data Documentation

◆ itsDelta

Double casacore::DiscreteUniform::itsDelta
private

Definition at line 706 of file Random.h.

◆ itsHigh

Int casacore::DiscreteUniform::itsHigh
private

Definition at line 705 of file Random.h.

Referenced by high().

◆ itsLow

Int casacore::DiscreteUniform::itsLow
private

Definition at line 704 of file Random.h.

Referenced by low().


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