Struct rand::distributions::UnitSphereSurface

pub struct UnitSphereSurface;

Samples uniformly from the surface of the unit sphere in three dimensions.

Implemented via a method by Marsaglia¹.

Example

use rand::distributions::{UnitSphereSurface, Distribution};

let sphere = UnitSphereSurface::new();
let v = sphere.sample(&mut rand::thread_rng());
println!("{:?} is from the unit sphere surface.", v)

---

1. Marsaglia, George (1972). Choosing a Point from the Surface of a Sphere. Ann. Math. Statist. 43, no. 2, 645--646. ↩

Methods

impl UnitSphereSurface

pub fn new() -> UnitSphereSurface

Construct a new UnitSphereSurface distribution.

Trait Implementations

impl Distribution<[f64; 3]> for UnitSphereSurface

fn sample<R: Rng + ?Sized>(&self, rng: &mut R) -> [f64; 3]

Generate a random value of T, using rng as the source of randomness.

Important traits for DistIter<'a, D, R, T>

impl<'a, D, R, T> Iterator for DistIter<'a, D, R, T> where
    D: Distribution<T>,
    R: Rng + 'a,  type Item = T;

fn sample_iter<'a, R>(&'a self, rng: &'a mut R) -> DistIter<'a, Self, R, T> where
    Self: Sized,
    R: Rng, 

Create an iterator that generates random values of T, using rng as the source of randomness.

impl Clone for UnitSphereSurface

fn clone(&self) -> UnitSphereSurface

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for UnitSphereSurface

impl Debug for UnitSphereSurface

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.