RandomStreamPartition<TRandom> Class

public sealed class RandomStreamPartition<TRandom> : RandomStreamSource<TRandom>
where TRandom : Object, IJumpable, IRandomSourceFactory<TRandom>

Public NotInheritable Class RandomStreamPartition(Of TRandom As {Object, IJumpable, IRandomSourceFactory(Of TRandom)})
	Inherits RandomStreamSource(Of TRandom)

generic<typename TRandom>
where TRandom : Object, IJumpable, IRandomSourceFactory<TRandom>
public ref class RandomStreamPartition sealed : public RandomStreamSource<TRandom>

[<SealedAttribute>]
type RandomStreamPartition<'TRandom when 'TRandom : Object and IJumpable and IRandomSourceFactory<'TRandom>> = 
    class
        inherit RandomStreamSource<'TRandom>
    end

Inheritance

Object  →  RandomStreamSource<TRandom>  →  RandomStreamPartition<TRandom>

Type Parameters

TRandom

The type of random number generator to produce. Must implement IJumpable.

RandomStreamPartition<TRandom> provides RngStreams-style stream partitioning where streams are created by jumping forward along a single sequence. This approach:

• Partitions a sequence: Each stream continues from where the previous left off
• Requires jumping: Only works with RNGs that implement IJumpable
• O(N) enumeration: Generating N streams requires N jump operations
• Supports hierarchical partitioning: Different strides at different levels

Cursor-Based Incremental Enumeration:

Unlike mixing-based streams, jump-based partitioning maintains an internal cursor RNG that tracks the current position in the sequence. Each call to NextStream() returns a copy of the cursor, then advances it by one stride. This ensures O(N) total cost for N streams, not O(N²).

Stride Control:

The Stride property controls the spacing between streams:

• Jump: Standard jump distance (e.g., 2^128 for Xoshiro256)
• LongJump: Extended jump distance (e.g., 2^192 for Xoshiro256)

Hierarchical Partitioning:

Different strides can be used at different hierarchy levels to create two-level partitioning schemes similar to RngStreams:

Path Interpretation:

Each element in the path represents a number of stride jumps from the anchor point. For example, path [2, 3] with Jump stride means:

1. Start from base options
2. Jump 2 times (level 1)
3. Jump 3 times (level 2)

Reference