RandomSource<TGenerator> Constructor

This constructor uses the Independent seed profile. It provides a convenient way to create a unique, statistically sound random source without requiring manual seed management.

For large-scale parallel simulations requiring a high degree of coordination between many streams, consider using the explicit streaming methods provided by RandomStreamTree<TRandom> or RandomStreamPartition<TRandom>.

protected RandomSource(
	 in TGenerator generator
)

Protected Sub New ( 
	 ByRef generator As TGenerator
)

protected:
RandomSource(
	[InAttribute]  TGenerator% generator
)

new : 
         generator : 'TGenerator byref -> RandomSource

Parameters

generator  TGenerator

The pre-initialized generator to use.

This constructor bypasses normal initialization and directly uses the provided generator. Use this for constructors that call engine Seed methods directly.

protected RandomSource(
	 in RandomOptions options
)

Protected Sub New ( 
	 ByRef options As RandomOptions
)

protected:
RandomSource(
	[InAttribute]  RandomOptions% options
)

new : 
         options : RandomOptions byref -> RandomSource

Parameters

options  RandomOptions

The initialization options containing seed, stream ID, and seed profile.

This constructor validates the options and calls Initialize(RandomOptions, TGenerator) to configure the generator.

protected RandomSource(
	ReadOnlySpan<byte> state
)

Protected Sub New ( 
	state As ReadOnlySpan(Of Byte)
)

protected:
RandomSource(
	ReadOnlySpan<unsigned char> state
)

new : 
        state : ReadOnlySpan<byte> -> RandomSource

Parameters

state  ReadOnlySpan<Byte>

The saved state to restore.

This constructor bypasses normal initialization and directly loads the state. Use this for exact continuation from a previously saved state.

protected RandomSource(
	long seed,
	StreamAddress streamAddress,
	SeedProfile seedProfile
)

Protected Sub New ( 
	seed As Long,
	streamAddress As StreamAddress,
	seedProfile As SeedProfile
)

protected:
RandomSource(
	long long seed, 
	StreamAddress streamAddress, 
	SeedProfile seedProfile
)

new : 
        seed : int64 * 
        streamAddress : StreamAddress * 
        seedProfile : SeedProfile -> RandomSource

Parameters

seed  Int64

The initial seed of the generator.

streamAddress  StreamAddress

Optional stream identifier for stream selection (default: empty).

seedProfile  SeedProfile

The seed profile (default: Default).

This constructor validates inputs and calls Initialize(RandomOptions, TGenerator) to configure the generator according to the specified seed profile.

protected RandomSource(
	ReadOnlySpan<uint> seed,
	StreamAddress streamAddress,
	SeedProfile seedProfile
)

Protected Sub New ( 
	seed As ReadOnlySpan(Of UInteger),
	streamAddress As StreamAddress,
	seedProfile As SeedProfile
)

protected:
RandomSource(
	ReadOnlySpan<unsigned int> seed, 
	StreamAddress streamAddress, 
	SeedProfile seedProfile
)

new : 
        seed : ReadOnlySpan<uint32> * 
        streamAddress : StreamAddress * 
        seedProfile : SeedProfile -> RandomSource

Parameters

seed  ReadOnlySpan<UInt32>

The seed array values.

streamAddress  StreamAddress

Optional stream identifier for stream selection (default: null).

seedProfile  SeedProfile

The seed profile (default: Default).

This constructor validates inputs and calls Initialize(RandomOptions, TGenerator) to configure the generator according to the specified seed profile.

Note: ToArray() is necessary here because RandomOptions requires array input for immutability. The span is copied into an array that RandomOptions then stores internally.

protected RandomSource(
	ReadOnlySpan<ulong> seed,
	StreamAddress streamAddress,
	SeedProfile seedProfile
)

Protected Sub New ( 
	seed As ReadOnlySpan(Of ULong),
	streamAddress As StreamAddress,
	seedProfile As SeedProfile
)

protected:
RandomSource(
	ReadOnlySpan<unsigned long long> seed, 
	StreamAddress streamAddress, 
	SeedProfile seedProfile
)

new : 
        seed : ReadOnlySpan<uint64> * 
        streamAddress : StreamAddress * 
        seedProfile : SeedProfile -> RandomSource

Parameters

seed  ReadOnlySpan<UInt64>

The seed array values.

streamAddress  StreamAddress

Optional stream identifier for stream selection (default: null).

seedProfile  SeedProfile

The seed profile (default: Default).

This constructor validates inputs and calls Initialize(RandomOptions, TGenerator) to configure the generator according to the specified seed profile.

Note: ToArray() is necessary here because RandomOptions requires array input for immutability. The span is copied into an array that RandomOptions then stores internally.

Reference