Struct TrialMeta 

pub struct TrialMeta {
    pub id: TrialId,
    pub number: TrialNumber,
    pub sampler_seed: u64,
}

The lightweight handle a sampler receives for the trial it is sampling.

Why the seed is precomputed

sampler_seed is seed_for(study_seed, number, Stream::Sampler), derived by the framework before the sampler is called. A stateless sampler therefore does not need — and must not use — any ambient randomness: it seeds ChaCha8Rng from this value and is automatically deterministic per trial number, regardless of which worker runs the trial, in which order trials complete, or how many threads exist. That is the determinism contract, and it is what lets a multithreaded study evaluate exactly the configuration set a single-threaded one would.

use atune_core::id::{TrialId, TrialNumber};
use atune_core::seed::{Stream, seed_for};
use atune_core::trial::TrialMeta;

let meta = TrialMeta::derive(TrialId::new(99), TrialNumber::new(3), 42);
assert_eq!(meta.sampler_seed, seed_for(42, 3, Stream::Sampler));

Fields

id: TrialId

Storage-global identity.

number: TrialNumber

Per-study ordinal — what the seed is derived from.

sampler_seed: u64

The precomputed Stream::Sampler seed for this trial.

Implementations

impl TrialMeta

pub const fn new(id: TrialId, number: TrialNumber, sampler_seed: u64) -> Self

Builds a handle from an already-derived seed.

pub const fn derive(id: TrialId, number: TrialNumber, study_seed: u64) -> Self

Builds a handle, deriving the sampler seed from the study seed.

Trait Implementations

impl Clone for TrialMeta

fn clone(&self) -> TrialMeta

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TrialMeta

impl Debug for TrialMeta

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TrialMeta

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for TrialMeta

impl Hash for TrialMeta

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for TrialMeta

fn eq(&self, other: &TrialMeta) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for TrialMeta

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for TrialMeta