#include "oct-rand.h"

Collaboration diagram for rand:

[legend]

Public Member Functions
	~rand (void)=default

template<typename T >
T	do_scalar (T a)

template<typename T >
Array< T >	do_vector (octave_idx_type n, T a)

Static Public Member Functions
static void	distribution (const std::string &d)

static std::string	distribution (void)

static void	exponential_distribution (void)

static FloatNDArray	float_nd_array (const dim_vector &dims, float a=1.0)

static float	float_scalar (float a=1.0)

static Array< float >	float_vector (octave_idx_type n, float a=1.0)

static void	gamma_distribution (void)

static bool	instance_ok (void)

static NDArray	nd_array (const dim_vector &dims, double a=1.0)

static void	normal_distribution (void)

static void	poisson_distribution (void)

static void	reset (const std::string &d)

static void	reset (void)

static double	scalar (double a=1.0)

static void	seed (double s)

static double	seed (void)

static uint32NDArray	state (const std::string &d="")

static void	state (const uint32NDArray &s, const std::string &d="")

static void	uniform_distribution (void)

static Array< double >	vector (octave_idx_type n, double a=1.0)

Protected Member Functions
OCTAVE_API	rand (void)

Private Types
enum	{ unknown_dist , uniform_dist , normal_dist , expon_dist , poisson_dist , gamma_dist }

Private Member Functions
OCTAVE_API void	do_distribution (const std::string &d)

OCTAVE_API std::string	do_distribution (void)

OCTAVE_API void	do_exponential_distribution (void)

OCTAVE_API FloatNDArray	do_float_nd_array (const dim_vector &dims, float a=1.)

OCTAVE_API void	do_gamma_distribution (void)

OCTAVE_API NDArray	do_nd_array (const dim_vector &dims, double a=1.)

OCTAVE_API void	do_normal_distribution (void)

OCTAVE_API void	do_poisson_distribution (void)

OCTAVE_API void	do_reset ()

OCTAVE_API void	do_reset (const std::string &d)

template<typename T >
OCTAVE_API T	do_scalar (T a=1)

OCTAVE_API void	do_seed (double s)

OCTAVE_API double	do_seed (void)

OCTAVE_API uint32NDArray	do_state (const std::string &d)

OCTAVE_API void	do_state (const uint32NDArray &s, const std::string &d)

OCTAVE_API void	do_uniform_distribution (void)

template<typename T >
OCTAVE_API Array< T >	do_vector (octave_idx_type n, T a=1)

template<>
OCTAVE_API double	exponential (void)

template<>
OCTAVE_API float	exponential (void)

template<typename T >
OCTAVE_API T	exponential (void)

OCTAVE_API void	fill (octave_idx_type len, double *v, double a)

OCTAVE_API void	fill (octave_idx_type len, float *v, float a)

template<>
OCTAVE_API double	gamma (double a)

template<>
OCTAVE_API float	gamma (float a)

template<typename T >
OCTAVE_API T	gamma (T a)

OCTAVE_API int	get_dist_id (const std::string &d)

OCTAVE_API uint32NDArray	get_internal_state (void)

OCTAVE_API void	initialize_mersenne_twister (void)

OCTAVE_API void	initialize_ranlib_generators (void)

template<>
OCTAVE_API double	normal (void)

template<>
OCTAVE_API float	normal (void)

template<typename T >
OCTAVE_API T	normal (void)

template<>
OCTAVE_API double	poisson (double a)

template<>
OCTAVE_API float	poisson (float a)

template<typename T >
OCTAVE_API T	poisson (T a)

OCTAVE_API void	save_state (void)

OCTAVE_API void	set_internal_state (const uint32NDArray &s)

OCTAVE_API void	switch_to_generator (int dist)

template<>
OCTAVE_API double	uniform (void)

template<>
OCTAVE_API float	uniform (void)

template<typename T >
OCTAVE_API T	uniform (void)

Static Private Member Functions
static void	cleanup_instance (void)

Private Attributes
int	m_current_distribution

std::map< int, uint32NDArray >	m_rand_states

bool	m_use_old_generators

Static Private Attributes
static rand *	m_instance = nullptr

Detailed Description

Definition at line 44 of file oct-rand.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

private

Enumerator
unknown_dist
uniform_dist
normal_dist
expon_dist
poisson_dist
gamma_dist

Definition at line 190 of file oct-rand.h.

Constructor & Destructor Documentation

◆ rand()

rand::rand ( void )

protected

Definition at line 53 of file oct-rand.cc.

References initialize_mersenne_twister(), and initialize_ranlib_generators().

Referenced by instance_ok().

◆ ~rand()

rand::~rand ( void )

default

Member Function Documentation

◆ cleanup_instance()

static void rand::cleanup_instance ( void )

inlinestaticprivate

Definition at line 187 of file oct-rand.h.

Referenced by instance_ok().

◆ distribution() [1/2]

static void rand::distribution ( const std::string & d )

inlinestatic

Definition at line 106 of file oct-rand.h.

References d.

◆ distribution() [2/2]

static std::string rand::distribution ( void )

inlinestatic

Definition at line 99 of file oct-rand.h.

Referenced by do_rand().

◆ do_distribution() [1/2]

void rand::do_distribution ( const std::string & d )

private

Definition at line 225 of file oct-rand.cc.

References d, expon_dist, exponential_distribution(), gamma_dist, gamma_distribution(), get_dist_id(), normal_dist, normal_distribution(), poisson_dist, poisson_distribution(), uniform_dist, and uniform_distribution().

◆ do_distribution() [2/2]

std::string rand::do_distribution ( void )

private

Definition at line 190 of file oct-rand.cc.

References expon_dist, gamma_dist, m_current_distribution, normal_dist, poisson_dist, and uniform_dist.

◆ do_exponential_distribution()

void rand::do_exponential_distribution ( void )

private

Definition at line 272 of file oct-rand.cc.

References expon_dist, F77_FUNC(), and switch_to_generator().

◆ do_float_nd_array()

FloatNDArray rand::do_float_nd_array	(	const dim_vector &	dims,
		float	a = `1.`
	)

private

Definition at line 533 of file oct-rand.cc.

References dim_vector::all_zero(), Array< T, Alloc >::clear(), fill(), Array< T, Alloc >::fortran_vec(), and Array< T, Alloc >::numel().

◆ do_gamma_distribution()

void rand::do_gamma_distribution ( void )

private

Definition at line 286 of file oct-rand.cc.

References F77_FUNC(), gamma_dist, and switch_to_generator().

◆ do_nd_array()

NDArray rand::do_nd_array	(	const dim_vector &	dims,
		double	a = `1.`
	)

private

Definition at line 519 of file oct-rand.cc.

References dim_vector::all_zero(), Array< T, Alloc >::clear(), fill(), Array< T, Alloc >::fortran_vec(), and Array< T, Alloc >::numel().

◆ do_normal_distribution()

void rand::do_normal_distribution ( void )

private

Definition at line 265 of file oct-rand.cc.

References F77_FUNC(), normal_dist, and switch_to_generator().

◆ do_poisson_distribution()

void rand::do_poisson_distribution ( void )

private

Definition at line 279 of file oct-rand.cc.

References F77_FUNC(), poisson_dist, and switch_to_generator().

◆ do_reset() [1/2]

void rand::do_reset ( void )

private

Definition at line 138 of file oct-rand.cc.

References initialize_ranlib_generators(), and m_use_old_generators.

◆ do_reset() [2/2]

void rand::do_reset ( const std::string & d )

private

Definition at line 170 of file oct-rand.cc.

References d, get_dist_id(), get_internal_state(), init_mersenne_twister(), m_current_distribution, m_rand_states, and m_use_old_generators.

◆ do_scalar() [1/2]

template<typename T >

T rand::do_scalar ( T a )

Definition at line 455 of file oct-rand.cc.

References expon_dist, gamma_dist, m_current_distribution, m_use_old_generators, normal_dist, poisson_dist, save_state(), and uniform_dist.

◆ do_scalar() [2/2]

template<typename T >

OCTAVE_API T rand::do_scalar ( T a = 1 )

private

◆ do_seed() [1/2]

void rand::do_seed ( double s )

private

Definition at line 111 of file oct-rand.cc.

References d, F77_FUNC(), flt_fmt_ieee_big_endian, force_to_fit_range(), m_use_old_generators, native_float_format(), and setsd().

◆ do_seed() [2/2]

double rand::do_seed ( void )

private

Definition at line 75 of file oct-rand.cc.

References d, F77_FUNC(), flt_fmt_ieee_big_endian, getsd(), and native_float_format().

◆ do_state() [1/2]

uint32NDArray rand::do_state ( const std::string & d )

private

Definition at line 144 of file oct-rand.cc.

References d, get_dist_id(), m_current_distribution, and m_rand_states.

◆ do_state() [2/2]

void rand::do_state	(	const uint32NDArray &	s,
		const std::string &	d
	)

private

Definition at line 149 of file oct-rand.cc.

References d, get_dist_id(), get_internal_state(), m_current_distribution, m_rand_states, m_use_old_generators, and set_internal_state().

◆ do_uniform_distribution()

void rand::do_uniform_distribution ( void )

private

Definition at line 258 of file oct-rand.cc.

References F77_FUNC(), switch_to_generator(), and uniform_dist.

◆ do_vector() [1/2]

template<typename T >

Array<T> rand::do_vector	(	octave_idx_type	n,
		T	a
	)

Definition at line 498 of file oct-rand.cc.

References Array< T, Alloc >::clear(), fill(), Array< T, Alloc >::fortran_vec(), n, and Array< T, Alloc >::numel().

◆ do_vector() [2/2]

template<typename T >

OCTAVE_API Array<T> rand::do_vector	(	octave_idx_type	n,
		T	a = `1`
	)

private

◆ exponential() [1/3]

template<>

OCTAVE_API double rand::exponential ( void )

private

Definition at line 320 of file oct-rand.cc.

References dgenexp(), F77_FUNC(), m_use_old_generators, and rand_exponential< double >().

◆ exponential() [2/3]

template<>

OCTAVE_API float rand::exponential ( void )

private

Definition at line 399 of file oct-rand.cc.

References F77_FUNC(), fgenexp(), m_use_old_generators, and rand_exponential< float >().

◆ exponential() [3/3]

template<typename T >

OCTAVE_API T rand::exponential ( void )

private

◆ exponential_distribution()

static void rand::exponential_distribution ( void )

inlinestatic

Definition at line 124 of file oct-rand.h.

Referenced by do_distribution(), and do_rand().

◆ fill() [1/2]

void rand::fill	(	octave_idx_type	len,
		double *	v,
		double	a
	)

private

Definition at line 658 of file oct-rand.cc.

References dgenexp(), dgengam(), dgennor(), dgenunf(), dignpoi(), expon_dist, F77_FUNC(), gamma_dist, isfinite(), len, m_current_distribution, m_use_old_generators, NaN, normal_dist, poisson_dist, rand_exponential< double >(), rand_normal< double >(), rand_poisson< double >(), rand_uniform< double >(), save_state(), uniform_dist, and x.

Referenced by do_float_nd_array(), do_nd_array(), and do_vector().

◆ fill() [2/2]

void rand::fill	(	octave_idx_type	len,
		float *	v,
		float	a
	)

private

Definition at line 726 of file oct-rand.cc.

References expon_dist, F77_FUNC(), fgenexp(), fgengam(), fgennor(), fgenunf(), fignpoi(), gamma_dist, isfinite(), len, m_current_distribution, m_use_old_generators, NaN, normal_dist, poisson_dist, rand_exponential< float >(), rand_normal< float >(), rand_poisson< float >(), rand_uniform< float >(), save_state(), uniform_dist, and x.

◆ float_nd_array()

static FloatNDArray rand::float_nd_array	(	const dim_vector &	dims,
		float	a = `1.0`
	)

inlinestatic

Definition at line 177 of file oct-rand.h.

Referenced by do_rand().

◆ float_scalar()

static float rand::float_scalar ( float a = 1.0 )

inlinestatic

Definition at line 150 of file oct-rand.h.

References NaN.

Referenced by do_rand().

◆ float_vector()

static Array<float> rand::float_vector	(	octave_idx_type	n,
		float	a = `1.0`
	)

inlinestatic

Definition at line 163 of file oct-rand.h.

References Array< float >, and n.

◆ gamma() [1/3]

template<>

OCTAVE_API double rand::gamma ( double a )

private

Definition at line 355 of file oct-rand.cc.

References dgengam(), F77_FUNC(), isfinite(), m_use_old_generators, and NaN.

◆ gamma() [2/3]

template<>

OCTAVE_API float rand::gamma ( float a )

private

Definition at line 437 of file oct-rand.cc.

References F77_FUNC(), fgengam(), isfinite(), m_use_old_generators, and NaN.

◆ gamma() [3/3]

template<typename T >

OCTAVE_API T rand::gamma ( T a )

private

◆ gamma_distribution()

static void rand::gamma_distribution ( void )

inlinestatic

Definition at line 136 of file oct-rand.h.

Referenced by do_distribution(), and do_rand().

◆ get_dist_id()

int rand::get_dist_id ( const std::string & d )

private

Definition at line 615 of file oct-rand.cc.

References current_liboctave_error_handler, d, expon_dist, gamma_dist, normal_dist, poisson_dist, uniform_dist, and unknown_dist.

Referenced by do_distribution(), do_reset(), and do_state().

◆ get_internal_state()

uint32NDArray rand::get_internal_state ( void )

private

Definition at line 601 of file oct-rand.cc.

References Array< T, Alloc >::fortran_vec(), get_mersenne_twister_state(), and MT_N.

Referenced by do_reset(), do_state(), initialize_mersenne_twister(), and save_state().

◆ initialize_mersenne_twister()

void rand::initialize_mersenne_twister ( void )

private

Definition at line 572 of file oct-rand.cc.

References expon_dist, gamma_dist, get_internal_state(), init_mersenne_twister(), m_current_distribution, m_rand_states, normal_dist, poisson_dist, set_internal_state(), and uniform_dist.

Referenced by rand().

◆ initialize_ranlib_generators()

void rand::initialize_ranlib_generators ( void )

private

Definition at line 552 of file oct-rand.cc.

References F77_FUNC(), force_to_fit_range(), m_current_distribution, setall(), and uniform_dist.

Referenced by rand(), and do_reset().

◆ instance_ok()

bool rand::instance_ok ( void )

static

Definition at line 62 of file oct-rand.cc.

References rand(), singleton_cleanup_list::add(), cleanup_instance(), and m_instance.

◆ nd_array()

static NDArray rand::nd_array	(	const dim_vector &	dims,
		double	a = `1.0`
	)

inlinestatic

Definition at line 170 of file oct-rand.h.

References NDArray.

Referenced by do_rand(), and Frandperm().

◆ normal() [1/3]

template<>

OCTAVE_API double rand::normal ( void )

private

Definition at line 307 of file oct-rand.cc.

References dgennor(), F77_FUNC(), m_use_old_generators, and rand_normal< double >().

◆ normal() [2/3]

template<>

OCTAVE_API float rand::normal ( void )

private

Definition at line 386 of file oct-rand.cc.

References F77_FUNC(), fgennor(), m_use_old_generators, and rand_normal< float >().

◆ normal() [3/3]

template<typename T >

OCTAVE_API T rand::normal ( void )

private

◆ normal_distribution()

static void rand::normal_distribution ( void )

inlinestatic

Definition at line 118 of file oct-rand.h.

Referenced by do_distribution(), and do_rand().

◆ poisson() [1/3]

template<>

OCTAVE_API double rand::poisson ( double a )

private

Definition at line 333 of file oct-rand.cc.

References dignpoi(), F77_FUNC(), isfinite(), m_use_old_generators, NaN, and rand_poisson< double >().

◆ poisson() [2/3]

template<>

OCTAVE_API float rand::poisson ( float a )

private

Definition at line 412 of file oct-rand.cc.

References F77_FUNC(), fignpoi(), isfinite(), m_use_old_generators, NaN, and rand_poisson< double >().

◆ poisson() [3/3]

template<typename T >

OCTAVE_API T rand::poisson ( T a )

private

◆ poisson_distribution()

static void rand::poisson_distribution ( void )

inlinestatic

Definition at line 130 of file oct-rand.h.

Referenced by do_distribution(), and do_rand().

◆ reset() [1/2]

static void rand::reset ( const std::string & d )

inlinestatic

Definition at line 92 of file oct-rand.h.

References d.

◆ reset() [2/2]

static void rand::reset ( void )

inlinestatic

Definition at line 71 of file oct-rand.h.

Referenced by do_rand().

◆ save_state()

void rand::save_state ( void )

private

Definition at line 610 of file oct-rand.cc.

References get_internal_state(), m_current_distribution, and m_rand_states.

Referenced by do_scalar(), and fill().

◆ scalar()

static double rand::scalar ( double a = 1.0 )

inlinestatic

Definition at line 143 of file oct-rand.h.

References NaN.

Referenced by do_rand().

◆ seed() [1/2]

static void rand::seed ( double s )

inlinestatic

Definition at line 64 of file oct-rand.h.

◆ seed() [2/2]

static double rand::seed ( void )

inlinestatic

Definition at line 57 of file oct-rand.h.

References NaN.

Referenced by do_rand().

◆ set_internal_state()

void rand::set_internal_state ( const uint32NDArray & s )

private

Definition at line 636 of file oct-rand.cc.

References Array< T, Alloc >::data(), init_mersenne_twister(), len, MT_N, Array< T, Alloc >::numel(), and set_mersenne_twister_state().

Referenced by do_state(), initialize_mersenne_twister(), and switch_to_generator().

◆ state() [1/2]

static uint32NDArray rand::state ( const std::string & d = "" )

inlinestatic

Definition at line 78 of file oct-rand.h.

References d.

Referenced by do_rand().

◆ state() [2/2]

static void rand::state	(	const uint32NDArray &	s,
		const std::string &	d = `""`
	)

inlinestatic

Definition at line 84 of file oct-rand.h.

References d.

◆ switch_to_generator()

void rand::switch_to_generator ( int dist )

private

Definition at line 648 of file oct-rand.cc.

References m_current_distribution, m_rand_states, and set_internal_state().

Referenced by do_exponential_distribution(), do_gamma_distribution(), do_normal_distribution(), do_poisson_distribution(), and do_uniform_distribution().

◆ uniform() [1/3]

template<>

OCTAVE_API double rand::uniform ( void )

private

Definition at line 294 of file oct-rand.cc.

References dgenunf(), F77_FUNC(), m_use_old_generators, and rand_uniform< double >().

◆ uniform() [2/3]

template<>

OCTAVE_API float rand::uniform ( void )

private

Definition at line 373 of file oct-rand.cc.

References F77_FUNC(), fgenunf(), m_use_old_generators, and rand_uniform< float >().

◆ uniform() [3/3]

template<typename T >

OCTAVE_API T rand::uniform ( void )

private

◆ uniform_distribution()

static void rand::uniform_distribution ( void )

inlinestatic

Definition at line 112 of file oct-rand.h.

Referenced by do_distribution(), and do_rand().

◆ vector()

static Array<double> rand::vector	(	octave_idx_type	n,
		double	a = `1.0`
	)

inlinestatic

Definition at line 157 of file oct-rand.h.

References Array< double >, and n.

Member Data Documentation

◆ m_current_distribution

int rand::m_current_distribution

private

Definition at line 201 of file oct-rand.h.

Referenced by do_distribution(), do_reset(), do_scalar(), do_state(), fill(), initialize_mersenne_twister(), initialize_ranlib_generators(), save_state(), and switch_to_generator().

◆ m_instance

rand * rand::m_instance = nullptr

staticprivate

Definition at line 185 of file oct-rand.h.

Referenced by instance_ok().

◆ m_rand_states

std::map<int, uint32NDArray> rand::m_rand_states

private

Definition at line 208 of file oct-rand.h.

Referenced by do_reset(), do_state(), initialize_mersenne_twister(), save_state(), and switch_to_generator().

◆ m_use_old_generators

bool rand::m_use_old_generators

private

Definition at line 205 of file oct-rand.h.

Referenced by do_reset(), do_scalar(), do_seed(), do_state(), exponential(), fill(), gamma(), normal(), poisson(), and uniform().

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

liboctave/numeric/oct-rand.h
liboctave/numeric/oct-rand.cc

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Types

Private Member Functions

Static Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Member Enumeration Documentation

◆ anonymous enum

Constructor & Destructor Documentation

◆ rand()

◆ ~rand()

Member Function Documentation

◆ cleanup_instance()

◆ distribution() [1/2]

◆ distribution() [2/2]

◆ do_distribution() [1/2]

◆ do_distribution() [2/2]

◆ do_exponential_distribution()

◆ do_float_nd_array()

◆ do_gamma_distribution()

◆ do_nd_array()

◆ do_normal_distribution()

◆ do_poisson_distribution()

◆ do_reset() [1/2]

◆ do_reset() [2/2]

◆ do_scalar() [1/2]

◆ do_scalar() [2/2]

◆ do_seed() [1/2]

◆ do_seed() [2/2]

◆ do_state() [1/2]

◆ do_state() [2/2]

◆ do_uniform_distribution()

◆ do_vector() [1/2]

◆ do_vector() [2/2]

◆ exponential() [1/3]

◆ exponential() [2/3]

◆ exponential() [3/3]

◆ exponential_distribution()

◆ fill() [1/2]

◆ fill() [2/2]

◆ float_nd_array()

◆ float_scalar()

◆ float_vector()

◆ gamma() [1/3]

◆ gamma() [2/3]

◆ gamma() [3/3]

◆ gamma_distribution()

◆ get_dist_id()

◆ get_internal_state()

◆ initialize_mersenne_twister()

◆ initialize_ranlib_generators()

◆ instance_ok()

◆ nd_array()

◆ normal() [1/3]

◆ normal() [2/3]

◆ normal() [3/3]

◆ normal_distribution()

◆ poisson() [1/3]

◆ poisson() [2/3]

◆ poisson() [3/3]

◆ poisson_distribution()

◆ reset() [1/2]

◆ reset() [2/2]

◆ save_state()

◆ scalar()

◆ seed() [1/2]

◆ seed() [2/2]

◆ set_internal_state()

◆ state() [1/2]

◆ state() [2/2]

◆ switch_to_generator()

◆ uniform() [1/3]

◆ uniform() [2/3]

◆ uniform() [3/3]

◆ uniform_distribution()

◆ vector()

Member Data Documentation