BinomialDistribution.Sample Method

protected override int Sample<TGenerator>(
	ref TGenerator generator
)
where TGenerator : struct, new(), IRandomGenerator

Protected Overrides Function Sample(Of TGenerator As {Structure, New, IRandomGenerator}) ( 
	ByRef generator As TGenerator
) As Integer

protected:
generic<typename TGenerator>
where TGenerator : value class, gcnew(), IRandomGenerator
virtual int Sample(
	TGenerator% generator
) override

abstract Sample : 
        generator : 'TGenerator byref -> int  when 'TGenerator : struct, new() and IRandomGenerator
override Sample : 
        generator : 'TGenerator byref -> int  when 'TGenerator : struct, new() and IRandomGenerator

Parameters

generator  TGenerator

A reference to a struct implementing IRandomGenerator used to produce uniform variates.

Type Parameters

TGenerator

The underlying generator type of the random source, used to enable optimizations like inlining.

Return Value

Implementations may override this method to provide a more efficient or specialized sampling algorithm that consumes raw uniform variates from generator.

public static int Sample(
	Random random,
	int numberOfTrials
)

Public Shared Function Sample ( 
	random As Random,
	numberOfTrials As Integer
) As Integer

public:
static int Sample(
	Random^ random, 
	int numberOfTrials
)

static member Sample : 
        random : Random * 
        numberOfTrials : int -> int 

Parameters

random  Random

The Random derived random number generator used to generate the sample.

numberOfTrials  Int32

The number of trials.

Return Value

This method is useful when only a single random sample is required, or if the parameters of the distribution change often. To obtain a large number of samples from a distribution with identical parameters, create an instance of the class and call the Sample() method repeatedly.

public static int Sample(
	IRandomSource random,
	int numberOfTrials,
	double probabilityOfSuccess
)

Public Shared Function Sample ( 
	random As IRandomSource,
	numberOfTrials As Integer,
	probabilityOfSuccess As Double
) As Integer

public:
static int Sample(
	IRandomSource^ random, 
	int numberOfTrials, 
	double probabilityOfSuccess
)

static member Sample : 
        random : IRandomSource * 
        numberOfTrials : int * 
        probabilityOfSuccess : float -> int 

Parameters

random  IRandomSource

The random number generator used to generate the sample.

numberOfTrials  Int32

The number of trials.

probabilityOfSuccess  Double

The probability of a trial resulting in success.

Return Value

This method is useful when only a single random sample is required, or if the parameters of the distribution change often. To obtain a large number of samples from a distribution with identical parameters, create an instance of the class and call the Sample() method repeatedly.

public static int Sample<TGenerator>(
	IRandomSource<TGenerator> random,
	int numberOfTrials,
	double probabilityOfSuccess = 0.5
)
where TGenerator : struct, new(), IRandomGenerator

Public Shared Function Sample(Of TGenerator As {Structure, New, IRandomGenerator}) ( 
	random As IRandomSource(Of TGenerator),
	numberOfTrials As Integer,
	Optional probabilityOfSuccess As Double = 0.5
) As Integer

public:
generic<typename TGenerator>
where TGenerator : value class, gcnew(), IRandomGenerator
static int Sample(
	IRandomSource<TGenerator>^ random, 
	int numberOfTrials, 
	double probabilityOfSuccess = 0.5
)

static member Sample : 
        random : IRandomSource<'TGenerator> * 
        numberOfTrials : int * 
        ?probabilityOfSuccess : float 
(* Defaults:
        let _probabilityOfSuccess = defaultArg probabilityOfSuccess 0.5
*)
-> int  when 'TGenerator : struct, new() and IRandomGenerator

Parameters

random  IRandomSource<TGenerator>

The random number generator used to generate the sample.

numberOfTrials  Int32

The number of trials.

probabilityOfSuccess  Double  (Optional)

The probability of a trial resulting in success.

Type Parameters

TGenerator

The type of the random generator.

Return Value

This method is useful when only a single random sample is required, or if the parameters of the distribution change often. To obtain a large number of samples from a distribution with identical parameters, create an instance of the class and call the Sample() method repeatedly.

public static int Sample(
	Random random,
	int numberOfTrials,
	double probabilityOfSuccess
)

Public Shared Function Sample ( 
	random As Random,
	numberOfTrials As Integer,
	probabilityOfSuccess As Double
) As Integer

public:
static int Sample(
	Random^ random, 
	int numberOfTrials, 
	double probabilityOfSuccess
)

static member Sample : 
        random : Random * 
        numberOfTrials : int * 
        probabilityOfSuccess : float -> int 

Parameters

random  Random

The random number generator used to generate the sample.

numberOfTrials  Int32

The number of trials.

probabilityOfSuccess  Double

The probability of a trial resulting in success.

Return Value

This method is useful when only a single random sample is required, or if the parameters of the distribution change often. To obtain a large number of samples from a distribution with identical parameters, create an instance of the class and call the Sample() method repeatedly.

Reference