Class RandomSampler

Namespace

AiDotNet.Data.Sampling

Assembly

AiDotNet.dll

A sampler that randomly shuffles the dataset indices each epoch.

public class RandomSampler : DataSamplerBase, IDataSampler

Inheritance

object

DataSamplerBase

RandomSampler

Implements

IDataSampler

Inherited Members

DataSamplerBase.Random

DataSamplerBase.CurrentEpoch

DataSamplerBase.GetIndices()

DataSamplerBase.SetSeed(int)

DataSamplerBase.OnEpochStart(int)

DataSamplerBase.ShuffleIndices(int[])

DataSamplerBase.CreateSequentialIndices(int)

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Remarks

RandomSampler is the default sampling strategy for most training scenarios. It shuffles the dataset indices using the Fisher-Yates algorithm for O(n) time complexity.

For Beginners: This sampler shuffles your data randomly before each training epoch. Shuffling is important because: - It prevents the model from learning patterns based on data order - It helps the model generalize better - It ensures different batches each epoch for varied gradient updates

Example:

var sampler = new RandomSampler(datasetSize: 1000, seed: 42);
foreach (var index in sampler.GetIndices())
{
    // Process sample at index
}

Constructors

RandomSampler(int, int?)

Initializes a new instance of the RandomSampler class.

public RandomSampler(int datasetSize, int? seed = null)

Parameters

datasetSize int

The total number of samples in the dataset.

seed int?

Optional random seed for reproducibility.

Exceptions

ArgumentOutOfRangeException

Thrown when datasetSize is less than 1.

Properties

Length

Gets the total number of samples this sampler will produce per epoch.

public override int Length { get; }

Property Value

int

Remarks

This may differ from the dataset size for oversampling or undersampling strategies.

Methods

GetIndicesCore()

Core implementation for generating indices. Override this in derived classes.

protected override IEnumerable<int> GetIndicesCore()

Returns

IEnumerable<int>

An enumerable of sample indices.