![]() |
Home | Libraries | People | FAQ | More |
boost::random::uniform_on_sphere
// In header: <boost/random/uniform_on_sphere.hpp> template<typename RealType, typename Cont> class uniform_on_sphere { public: // types typedef ; typedef ; // member classes/structs/unions class param_type { public: // types typedef uniform_on_sphere ; // construct/copy/destruct ( = ); // public member functions () ; // friend functions template<typename CharT, typename Traits> (, param_type &); template<typename CharT, typename Traits> (, param_type &); (param_type &, param_type &); (param_type &, param_type &); }; // construct/copy/destruct ( = ); (param_type &); // public member functions () ; param_type () ; (param_type &); () ; () ; (); template<typename Engine> (); template<typename Engine> (, param_type &) ; // friend functions template<typename CharT, typename Traits> (, uniform_on_sphere &); template<typename CharT, typename Traits> (, uniform_on_sphere &); (uniform_on_sphere &, uniform_on_sphere &); (uniform_on_sphere &, uniform_on_sphere &); };
Instantiations of class template uniform_on_sphere model a random distribution . Such a distribution produces random numbers uniformly distributed on the unit sphere of arbitrary dimension dim
. The Cont
template parameter must be a STL-like container type with begin and end operations returning non-const ForwardIterators of type Cont::iterator
.
uniform_on_sphere
public
construct/copy/destruct( dim = );
Constructs a
distribution. uniform_on_sphere
dim
is the dimension of the sphere.
Requires: dim >= 0
(param_type & param);
Constructs a
distribution from its parameters. uniform_on_sphere
uniform_on_sphere
public member functions() ;
Returns the dimension of the sphere.
param_type () ;
Returns the parameters of the distribution.
(param_type & param);
Sets the parameters of the distribution.
() ;
Returns the smallest value that the distribution can produce. Note that this is required to approximate the standard library's requirements. The behavior is defined according to lexicographical comparison so that for a container type of std::vector, dist.min() <= x <= dist.max() where x is any value produced by the distribution.
() ;
Returns the largest value that the distribution can produce. Note that this is required to approximate the standard library's requirements. The behavior is defined according to lexicographical comparison so that for a container type of std::vector, dist.min() <= x <= dist.max() where x is any value produced by the distribution.
();
Effects: Subsequent uses of the distribution do not depend on values produced by any engine prior to invoking reset.
template<typename Engine> ( eng);
Returns a point uniformly distributed over the surface of a sphere of dimension dim().
template<typename Engine> ( eng, param_type & param) ;
Returns a point uniformly distributed over the surface of a sphere of dimension param.dim().
uniform_on_sphere
friend functionstemplate<typename CharT, typename Traits> ( os, uniform_on_sphere & sd);
Writes the distribution to a std::ostream
.
template<typename CharT, typename Traits> ( is, uniform_on_sphere & sd);
Reads the distribution from a std::istream
.
(uniform_on_sphere & lhs, uniform_on_sphere & rhs);
Returns true if the two distributions will produce identical sequences of values, given equal generators.
(uniform_on_sphere & lhs, uniform_on_sphere & rhs);
Returns true if the two distributions may produce different sequences of values, given equal generators.