Trait TryRandomSampleFrom 

pub trait TryRandomSampleFrom: Sized {
    type Sample: RawRealTrait;
    type Error: Error;

    // Required method
    fn try_sample_from<D, R>(
        distribution: &D,
        rng: &mut R,
        precision_out: u32,
    ) -> Result<Self, Self::Error>
       where D: Distribution<Self::Sample>,
             R: Rng + ?Sized;
}

A fallible conversion from a distribution sample into Self at a requested precision.

precision_out is interpreted by the target type. Fixed-precision targets such as f32 and f64 require their respective mantissa widths (24 and 53), while rug::Float uses it as the precision of the constructed value.

Required Associated Types

type Sample: RawRealTrait

type Error: Error

The error returned when a sample cannot be converted or validated.

Required Methods

fn try_sample_from<D, R>( distribution: &D, rng: &mut R, precision_out: u32, ) -> Result<Self, Self::Error>

where D: Distribution<Self::Sample>, R: Rng + ?Sized,

Samples a value and converts it to Self at precision_out.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementations on Foreign Types

impl TryRandomSampleFrom for Float

Available on crate feature rug only.

type Sample = f64

type Error = RawRealConversionError<f64, Float>

fn try_sample_from<D, R>( distribution: &D, rng: &mut R, precision_out: u32, ) -> Result<Self, Self::Error>

where D: Distribution<f64>, R: Rng + ?Sized,

impl TryRandomSampleFrom for f32

type Sample = f32

type Error = RawRealConversionError<f32, f32>

fn try_sample_from<D, R>( distribution: &D, rng: &mut R, precision_out: u32, ) -> Result<Self, Self::Error>

where D: Distribution<f32>, R: Rng + ?Sized,

impl TryRandomSampleFrom for f64

type Sample = f64

type Error = RawRealConversionError<f64, f64>

fn try_sample_from<D, R>( distribution: &D, rng: &mut R, precision_out: u32, ) -> Result<Self, Self::Error>

where D: Distribution<f64>, R: Rng + ?Sized,

impl<T> TryRandomSampleFrom for Complex<T>

where T: TryRandomSampleRawReal,

type Sample = <T as TryRandomSampleFrom>::Sample

type Error = RandomSampleComplexErrors<T>

fn try_sample_from<D, R>( distribution: &D, rng: &mut R, precision_out: u32, ) -> Result<Self, Self::Error>

where D: Distribution<Self::Sample>, R: Rng + ?Sized,

Implementors

impl<K> TryRandomSampleFrom for ComplexValidated<K>

where K: NumKernel, K::RawReal: TryRandomSampleRawReal,

type Sample = <<K as RawKernel>::RawReal as TryRandomSampleFrom>::Sample

type Error = RandomSampleComplexErrors<<K as RawKernel>::RawReal>

impl<K> TryRandomSampleFrom for RealValidated<K>

where K: NumKernel, K::RawReal: TryRandomSampleRawReal,

type Sample = <<K as RawKernel>::RawReal as TryRandomSampleFrom>::Sample

type Error = RawRealConversionError<<RealValidated<K> as TryRandomSampleFrom>::Sample, <K as RawKernel>::RawReal>