Struct UnitCircle

pub struct UnitCircle;

Samples uniformly from the circumference of the unit circle in two dimensions.

Implemented via a method by von Neumann¹.

For a distribution that also samples from the interior of the unit circle, see UnitDisc.

For a similar distribution in three dimensions, see UnitSphere.

Plot

The following plot shows the unit circle.

Example

use rand_distr::{UnitCircle, Distribution};

let v: [f64; 2] = UnitCircle.sample(&mut rand::rng());
println!("{:?} is from the unit circle.", v)

---

1. von Neumann, J. (1951) Various Techniques Used in Connection with Random Digits. NBS Appl. Math. Ser., No. 12. Washington, DC: U.S. Government Printing Office, pp. 36-38. ↩

Trait Implementations

impl Clone for UnitCircle

fn clone(&self) -> UnitCircle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UnitCircle

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for UnitCircle

fn deserialize<__D>( __deserializer: __D, ) -> Result<UnitCircle, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<F> Distribution<[F; 2]> for UnitCircle

where F: Float + SampleUniform,

fn sample<R>(&self, rng: &mut R) -> [F; 2]

where R: Rng + ?Sized,

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

fn sample_iter<R>(self, rng: R) -> Iter<Self, R, T>

where R: Rng, Self: Sized,

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

fn map<F, S>(self, func: F) -> Map<Self, F, T, S>

where F: Fn(T) -> S, Self: Sized,

Map sampled values to type S

impl Serialize for UnitCircle

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for UnitCircle