Struct Qmc 

pub struct Qmc;

A quasi-random Sobol sampler.

Stateless and configuration-free: construct with Qmc::new and hand it to a study through StudyBuilder::sampler. See the module-level documentation for the sequence and its guarantees.

use atune_core::sampler::{Qmc, Sampler};
use atune_core::id::{StudyId, TrialId, TrialNumber};
use atune_core::space::{Distribution, ParamSpec, SpaceSchema};
use atune_core::study::StudyView;
use atune_core::trial::TrialMeta;

let space = SpaceSchema::new([
    ParamSpec::new("x", Distribution::float(0.0, 1.0).unwrap()).unwrap(),
    ParamSpec::new("y", Distribution::float(0.0, 1.0).unwrap()).unwrap(),
])
.unwrap();

let qmc = Qmc::new();
let view = StudyView::new(StudyId::new(0), vec![], Some(space.clone()));
let meta = TrialMeta::derive(TrialId::new(1), TrialNumber::new(0), 42);

// The very first Sobol point is the origin of the cube.
let first = qmc.sample_relative(&view, &meta, &space).unwrap();
assert_eq!(first.get("x"), Some(&atune_core::space::ParamValue::F64(0.0)));

Implementations

impl Qmc

pub const fn new() -> Self

Creates the sampler.

Trait Implementations

impl Clone for Qmc

fn clone(&self) -> Qmc

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Qmc

impl Debug for Qmc

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

Formats the value using the given formatter.

impl Default for Qmc

fn default() -> Qmc

Returns the “default value” for a type.

impl Eq for Qmc

impl PartialEq for Qmc

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

Equality operator ==.

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

Inequality operator !=.

impl Sampler for Qmc

fn infer_relative_space(&self, study: &StudyView) -> Result<SpaceSchema>

The study’s declared space, or the intersection of the visible trials’ parameters for a define-by-run study — the same shape every built-in sampler infers.

Errors

Error::InvalidSpace if a recorded parameter name is empty, which no writer of this crate produces.

fn sample_relative( &self, _study: &StudyView, trial: &TrialMeta, space: &SpaceSchema, ) -> Result<Assignment>

The Sobol point of this trial’s number, dimension-assigned by sorted name.

Errors

Error::InvalidSpace if a declared distribution is malformed; Error::Sampler once the trial number leaves the sequence’s SOBOL_POINTS budget.

fn sample_independent( &self, _study: &StudyView, trial: &TrialMeta, name: &str, dist: &Distribution, ) -> Result<ParamValue>

The uniform Random draw.

A parameter outside the relative space has no assigned Sobol dimension, so it cannot take part in the joint low-discrepancy fill; it gets the deterministic per-name uniform draw instead, exactly as Optuna’s QMC sampler does.

Errors

Error::InvalidSpace if dist is malformed.

fn reseed(&self, _seed: u64)

A no-op: the Sobol point is a pure function of the trial number, so a reseed cannot move it without breaking the low-discrepancy guarantee. See Random::reseed for the full argument.

fn after_trial(&self, study: &StudyView, trial: &FrozenTrial) -> Result<()>

Called once a trial reaches a terminal state.

fn state(&self) -> Result<Option<SamplerState>>

The sampler’s persistable state, if it has any.

fn snapshots_space(&self) -> bool

Whether this sampler enumerates a snapshot of the space it was constructed with, rather than the space each ask presents.

fn restore_state(&self, blob: &SamplerState) -> Result<()>

Restores a sampler from a previously persisted blob.

impl StructuralPartialEq for Qmc