Struct Generator 

pub struct Generator { /* private fields */ }

プロセスグローバルな RNG（manual_seed／with_global_rng）とは 完全に独立した状態を持つ乱数源（PyTorch torch.Generator 相当。 イシュー #2156・親 #2131）。

用途は「グローバル状態を汚さない再現可能なサンプリング」。 Generator::new(seed) と manual_seed(seed) の直後に グローバル自由関数（bernoulli／multinomial／normal）を 呼んだ結果は bit 完全一致する（いずれも Xorshift64Star::new(seed) から始まるため。crates/autodiff/tests/ random_parity.rs で固定）。

&mut self で操作するためロックは不要（呼び出し元が所有権・借用で 排他制御を担う。with_global_rng の Mutex とは異なる設計）。

用途限定

xorshift64* は暗号学的に安全な PRNG ではない（モジュール冒頭コメント 参照。OWASP A02）。鍵・トークン生成などセキュリティ用途には使用 しないこと。

Implementations

impl Generator

pub fn new(seed: u64) -> Generator

seed から新規の独立した RNG 状態を作る （Xorshift64Star::new(seed) と同じ 0 補正を継承する）。

pub fn manual_seed(&mut self, seed: u64)

状態を seed からやり直す（manual_seed の Generator 版。 グローバル状態には一切触れない）。

pub fn initial_seed(&self) -> u64

Self::new／Self::manual_seed に渡された、補正前のシード値を 返す（PyTorch Generator.initial_seed() と同じ意味論）。

pub fn bernoulli( &mut self, probs: &Tensor<f32>, ) -> Result<Tensor<f32>, RngError>

bernoulli の Generator 版。グローバル RNG は消費しない。

pub fn normal( &mut self, mean: f32, std: f32, shape: &[usize], ) -> Result<Tensor<f32>, RngError>

normal の Generator 版。グローバル RNG は消費しない。

pub fn multinomial( &mut self, weights: &Tensor<f32>, num_samples: usize, replacement: bool, ) -> Result<Tensor<i32>, RngError>

multinomial の Generator 版。グローバル RNG は消費しない。 検証本体は自由関数版と validate_multinomial を共有する （イシュー #2156。ドリフト防止）。

Trait Implementations

impl Clone for Generator

fn clone(&self) -> Generator

内部状態を複製する（Xorshift64Star 自体に Clone を derive しない設計判断を保つため、フィールド単位で複製する。同一系列を 独立に分岐させる用途——例えば複数の Generator を並行してドリフト なく使い比べるテスト——を想定する）。

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Generator

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

内部状態（Xorshift64Star の state）は表示しない。initial_seed のみを表示する（内部実装詳細を Debug 出力経由で公開面へ漏らさない ための最小限の情報開示）。