Enum Decision 

pub enum Decision {
    Continue,
    Prune,
    Pause,
    Fork {
        parent: TrialId,
        mutation: Assignment,
    },
}

What should happen to a trial that just reported.

Variants

Continue

Keep going.

Prune

Stop now. The trial’s last intermediate value becomes its objective value (FrozenTrial::objective_value).

Pause

Suspend, keeping the checkpoint. The trial may be resumed later via Command::ResumeTrial.

Declared in M1, executed from M4.0: the study loop transitions the trial to TrialState::Paused — a resumable, non-terminal state that keeps the trial’s checkpoint reference — instead of completing, pruning or failing it.

Fork

Start a child of parent with mutated parameters — PBT’s exploit-and-explore step.

Declared in M1, executed from M4.0. A fork does not stop the trial that reported it (see stops_the_trial): the study loop materializes a new trial whose TrialTemplate carries the parent reference and whose parameters are the parent’s with mutation applied, and the child starts from the parent’s checkpoint reference. Only scalar perturbations are allowed in mutation — a shape/categorical parameter is resume-blocked because the parent checkpoint would not load — and one that is not is refused loudly.

Fields

parent: TrialId

The trial to copy the checkpoint from.

mutation: Assignment

Parameters that differ from the parent’s.

Implementations

impl Decision

pub const fn stops_the_trial(&self) -> bool

true if the trial should stop making progress right now.

Trait Implementations

impl Clone for Decision

fn clone(&self) -> Decision

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Decision

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Decision

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Decision

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Decision

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 Decision