Sfc64 Class

Represents a pseudo-random number generator based on the SFC64 algorithm.

Definition

Namespace: Numerics.NET.Random
Assembly: Numerics.NET (in Numerics.NET.dll) Version: 10.3.0

public sealed class Sfc64 : RandomSource<ScalarGenerator64<Sfc64Engine>>, 
	IRandomSourceFactory<Sfc64>

Visual Basic

Public NotInheritable Class Sfc64
	Inherits RandomSource(Of ScalarGenerator64(Of Sfc64Engine))
	Implements IRandomSourceFactory(Of Sfc64)

C++/CLI

public ref class Sfc64 sealed : public RandomSource<ScalarGenerator64<Sfc64Engine>>, 
	IRandomSourceFactory<Sfc64^>

[<SealedAttribute>]
type Sfc64 = 
    class
        inherit RandomSource<ScalarGenerator64<Sfc64Engine>>
        interface IRandomSourceFactory<Sfc64>
    end

Inheritance: Object → RandomSource<ScalarGenerator64<Sfc64Engine>> → Sfc64

Implements: IRandomSourceFactory<Sfc64>

Remarks

Use the Sfc64 class to represent a pseudo-random number generator that uses the Small Fast Chaotic 64-bit algorithm by Chris Doty-Humphrey.

SFC64 (Small Fast Counting) is a chaotic pseudo-random number generator with a minimum period of 2⁶⁴ and an average period of approximately 2²⁵⁵. It passes all statistical tests including BigCrush and PractRand.

This generator is very fast and has excellent statistical properties. It uses only simple operations (addition, rotation, and XOR) making it ideal for high-performance computing.

Reference: Chris Doty-Humphrey. "PractRand: Practical PRNG Testing." http://pracrand.sourceforge.net/

Example

var rng = new Sfc64(12345);
double value = rng.NextDouble();
int n = rng.Next(1, 10);

Constructors

Sfc64()	Initializes a new instance of the Sfc64 class using OS entropy.
Sfc64(RandomOptions)	Initializes a new instance of the Sfc64 class with the specified options.
Sfc64(ReadOnlySpan<Byte>)	Initializes a new instance of the Sfc64 class from saved state.
Sfc64(Int64, SeedProfile)	Initializes a new instance of the Sfc64 class with the specified seed.
Sfc64(ReadOnlySpan<UInt64>, SeedProfile)	Initializes a new instance of the Sfc64 class with the specified seed array.
Sfc64(Int64, StreamAddress, SeedProfile)	Initializes a new instance of the Sfc64 class with the specified seed.
Sfc64(ReadOnlySpan<UInt64>, StreamAddress, SeedProfile)	Initializes a new instance of the Sfc64 class with the specified seed array.
Sfc64(UInt64, UInt64, UInt64, UInt64)	Initializes a new instance of the Sfc64 class with direct state initialization.

Properties

BitsPerWord	Gets the number of bits per word in the generator's native output. (Overrides RandomSource<TGenerator>.BitsPerWord)
Name	Gets a human-readable name for this random number generator. (Overrides RandomSource<TGenerator>.Name)
StateSize	Gets the number of bytes required to save/load this generator's state. (Inherited from RandomSource<TGenerator>)
Uncached	Gets an uncached facade for this random number generator. (Inherited from RandomSource<TGenerator>)

Methods

Copy	Returns a deep copy of this RNG.
Create	Creates a new Sfc64 instance from the specified options.
CreateStreamTree	Creates a hierarchical stream tree for generating independent RNG streams.
Equals	Determines whether the specified object is equal to the current object. (Inherited from Object)
Fill(Span<UInt32>)	Fills a span with random 32-bit unsigned integer values. (Inherited from RandomSource<TGenerator>)
Fill(Span<Int32>, Int32)	Fills a span with random 32-bit signed integers less than the specified maximum. (Inherited from RandomSource<TGenerator>)
Fill(Span<Int64>, Int64)	Fills a span with random 64-bit signed integers less than the specified maximum. (Inherited from RandomSource<TGenerator>)
Fill(Span<Int32>, Int32, Int32)	Fills a span with random 32-bit signed integers within a specified range. (Inherited from RandomSource<TGenerator>)
Fill(Span<Int64>, Int64, Int64)	Fills a span with random 64-bit signed integers within a specified range. (Inherited from RandomSource<TGenerator>)
GetHashCode	Serves as the default hash function. (Inherited from Object)
GetState	Returns the current state of the generator as a byte array. (Inherited from RandomSource<TGenerator>)
GetType	Gets the Type of the current instance. (Inherited from Object)
LoadState	Loads the generator's state from the source span in a stable little-endian format. (Inherited from RandomSource<TGenerator>)
Next()	Returns a non-negative random integer. (Inherited from RandomSource<TGenerator>)
Next(Int32)	Returns a non-negative random integer less than the specified maximum. (Inherited from RandomSource<TGenerator>)
Next(Int32, Int32)	Returns a random integer within a specified range. (Inherited from RandomSource<TGenerator>)
NextBytes(Byte[])	Fills the elements of a specified array of bytes with random numbers. (Inherited from RandomSource<TGenerator>)
NextBytes(Span<Byte>)	Fills the elements of a specified span of bytes with random numbers. (Inherited from RandomSource<TGenerator>)
NextBytes(Byte[], Boolean)	Fills the elements of a specified span of bytes with random numbers. (Inherited from RandomSource<TGenerator>)
NextBytes(Span<Byte>, Boolean)	Fills the elements of a specified span of bytes with random numbers. (Inherited from RandomSource<TGenerator>)
NextDouble	Returns a random floating-point number in the range [0.0, 1.0). (Inherited from RandomSource<TGenerator>)
NextInt64()	Returns a non-negative random 64-bit integer. (Inherited from RandomSource<TGenerator>)
NextInt64(Int64)	Returns a non-negative random 64-bit integer less than the specified maximum. (Inherited from RandomSource<TGenerator>)
NextInt64(Int64, Int64)	Returns a random 64-bit integer within a specified range. (Inherited from RandomSource<TGenerator>)
NextSingle	Returns a random single-precision floating-point number in the range [0.0, 1.0). (Inherited from RandomSource<TGenerator>)
NextUInt32	Returns a random 32-bit unsigned integer. (Inherited from RandomSource<TGenerator>)
NextUInt64	Returns a random 64-bit unsigned integer. (Inherited from RandomSource<TGenerator>)
Reinitialize	Reinitializes this random number generator using the specified initialization options. (Inherited from RandomSource<TGenerator>)
SaveState	Saves the generator's state to the destination span in a stable little-endian format. (Inherited from RandomSource<TGenerator>)
ToString	Returns a string that represents the current object. (Inherited from Object)