Struct RandomSampler 

pub struct RandomSampler { /* private fields */ }

順列でバッチ添字を供給する（PyTorch RandomSampler 相当。イシュー #2182）。同一の manual_seed の下で DataLoader{shuffle=true} と 添字順が bit 完全一致する（start_epoch が shuffled_indices を 1 回の crate::rng::with_global_rng クロージャ内で呼ぶため）。

Implementations

impl RandomSampler

pub fn new( len: usize, batch_size: usize, drop_last: bool, ) -> Result<RandomSampler, DataError>

batch_size == 0 は DataError::ZeroBatchSize。

Trait Implementations

impl Debug for RandomSampler

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Sampler for RandomSampler

fn start_epoch(&mut self) -> Result<(), DataError>

epoch 開始時に 1 回呼ぶ。抽選を伴う実装はここで確定させる。

fn next_batch(&mut self) -> Vec<usize>

次バッチの添字列。空の Vec は epoch 終了の番兵。

fn num_batches(&self) -> Option<usize>

1 epoch あたりのバッチ数（既知なら Some。既定は None）。 SamplerBatches::size_hint・HookedBatches::size_hint は 本メソッドの戻り値（epoch 全体の静的総数）と、各イテレータ自身が 追跡する「これまでに yield した数」の差分で残数を計算する （レビュー指摘: イシュー #2182 review・PR #2310 codex-review P2 是正）。カスタム Sampler 実装が進捗追跡用の別メソッドを override する必要はなく、本メソッドだけを実装すれば途中経過・ epoch 終了後のどちらでも Iterator::size_hint の「残り要素数」 契約（下限の非過大申告）を満たす。