RandomStreams.CreatePartitionedStreams<TRandom> Method

public static TRandom[] CreatePartitionedStreams<TRandom>(
	int count,
	 in RandomOptions options,
	JumpStride stride,
	ulong startIndex = 0
)
where TRandom : Object, IRandomSourceFactory<TRandom>, IJumpable

Public Shared Function CreatePartitionedStreams(Of TRandom As {Object, IRandomSourceFactory(Of TRandom), IJumpable}) ( 
	count As Integer,
	 ByRef options As RandomOptions,
	stride As JumpStride,
	Optional startIndex As ULong = 0
) As TRandom()

public:
generic<typename TRandom>
where TRandom : Object, IRandomSourceFactory<TRandom>, IJumpable
static array<TRandom>^ CreatePartitionedStreams(
	int count, 
	[InAttribute]  RandomOptions% options, 
	JumpStride stride, 
	unsigned long long startIndex = 0
)

static member CreatePartitionedStreams : 
        count : int * 
         options : RandomOptions byref * 
        stride : JumpStride * 
        ?startIndex : uint64 
(* Defaults:
        let _startIndex = defaultArg startIndex 0
*)
-> 'TRandom[]  when 'TRandom : Object and IRandomSourceFactory<'TRandom> and IJumpable

Parameters

count  Int32

The number of generators to create (must be non-negative).

options  RandomOptions

The initialization options for the base RNG.

stride  JumpStride

The jump stride to use for spacing between streams.

startIndex  UInt64  (Optional)

The starting index for stream enumeration (default is 0).

Type Parameters

TRandom

Return Value

This method creates streams using jump-based partitioning (RngStreams-style). Streams are generated by jumping forward along a single sequence.

The startIndex parameter allows starting enumeration at a specific offset. For example, startIndex = 5 produces streams at jump positions 5, 6, 7, etc.

Stream creation is O(N) for N streams, with each stream requiring one jump operation. The stride controls the spacing between streams:

• Jump: Standard jump distance
• LongJump: Extended jump distance

Reference