Skip to main content

NopScheduler

Struct NopScheduler 

pub struct NopScheduler;
Expand description

Lets every trial run to completion.

The degenerate scheduler: it answers Decision::Continue to every report, keeps no state, and persists nothing. It exists so that the study loop has exactly one code path — a study always has a scheduler, and “no pruning” is expressed as a scheduler rather than as an Option and a branch at every call site.

This is what a study runs by default (M1.4). Choosing it is a statement: no trial is ever stopped early, so a multi-fidelity budget is spent in full on every configuration.

§Status

The real schedulers — median stopping, ASHA, Hyperband, and the pause/fork-capable PBT family — arrive in M3 and M4. They are what Decision::Pause and Decision::Fork were declared for; NopScheduler never produces either.

use atune_core::id::{StudyId, TrialId, TrialNumber};
use atune_core::scheduler::{Decision, NopScheduler, Scheduler};
use atune_core::study::StudyView;
use atune_core::trial::TrialMeta;

let scheduler = NopScheduler::new();
let view = StudyView::new(StudyId::new(0), vec![], None);
let trial = TrialMeta::derive(TrialId::new(1), TrialNumber::new(0), 0);

assert_eq!(
    scheduler.on_report(&view, &trial, 10, &[0.5]).unwrap(),
    Decision::Continue
);

Implementations§

§

impl NopScheduler

pub const fn new() -> Self

Creates the scheduler.

Trait Implementations§

§

impl Clone for NopScheduler

§

fn clone(&self) -> NopScheduler

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
§

impl Copy for NopScheduler

§

impl Debug for NopScheduler

§

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

Formats the value using the given formatter. Read more
§

impl Default for NopScheduler

§

fn default() -> NopScheduler

Returns the “default value” for a type. Read more
§

impl Eq for NopScheduler

§

impl PartialEq for NopScheduler

§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
§

impl Scheduler for NopScheduler

§

fn on_report( &self, _study: &StudyView, _trial: &TrialMeta, _step: u64, _values: &[f64], ) -> Result<Decision>

Always Decision::Continue, whatever was reported.

§Errors

Never.

§

fn scripted_capability(&self) -> ScriptedSchedulerCapability

Declares whether scripted ask/tell can recreate this scheduler. Read more
§

fn fan_report_mode(&self) -> FanReportMode

Declares whether this scheduler accepts aligned aggregate fan reports. Read more
§

fn on_trial_end( &self, study: &StudyView, trial: &FrozenTrial, ) -> Result<Vec<Command>>

Called once a trial reaches a terminal state. Read more
§

fn resume_candidates(&self, study: &StudyView) -> Result<Vec<Command>>

Paused trials worth waking on a freed work slot, in priority order. Read more
§

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

The scheduler’s persistable state, if it has any. Read more
§

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

Restores a scheduler from a previously persisted blob. Read more
§

impl StructuralPartialEq for NopScheduler

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more