Struct SearchSpace 

pub struct SearchSpace {
    pub dimensions: Vec<SearchDimension>,
    pub frozen: HashMap<String, Value>,
}

Aggregation of search dimensions from one or more filters.

Fields

dimensions: Vec<SearchDimension>

The dimensions samplers draw from. SearchSpace::freeze removes a dimension from this list, so everything here is actively searched.

frozen: HashMap<String, Value>

Parameters pinned to a fixed value by SearchSpace::freeze, keyed by dimension name. The StudyRunner injects these into every trial’s params so a frozen parameter still reaches the filter (and its cache key).

Implementations

impl SearchSpace

pub fn new() -> Self

An empty search space: no dimensions, nothing frozen.

pub fn add(&mut self, dim: SearchDimension)

Append a dimension. No name-collision check happens here; use SearchSpace::merge_with_prefix when combining spaces from several filters.

pub fn merge_with_prefix(&mut self, prefix: &str, other: SearchSpace)

Merge another search space with a prefix to avoid name collisions.

Every dimension name in other becomes "{prefix}.{name}" (conditional dimensions get their parent prefixed too, so the dependency still resolves). This is how a graph aggregates each filter’s Searchable::search_space into one space keyed by node label.

pub fn freeze(&mut self, name: &str, value: Value)

Freeze a parameter to a fixed value (exclude from search).

Removes the dimension named name from SearchSpace::dimensions and records the value in SearchSpace::frozen; the value is then injected into every trial’s params by the runner. Freezing a name with no matching dimension just records the value.

pub fn active_dimensions(&self) -> &[SearchDimension]

The dimensions still being searched. Since SearchSpace::freeze removes frozen dimensions from the list, this is every entry of SearchSpace::dimensions — the method exists so callers state their intent rather than reach into the field.

pub fn validate(&self) -> Result<(), Vec<String>>

Validate all dimensions, collecting every failure rather than stopping at the first — a study definition should surface all its range errors in one pass. Ok(()) when every dimension passes SearchDimension::validate.

pub fn is_empty(&self) -> bool

true when there is nothing left to search. Frozen values do not count: a space can be empty yet still carry frozen params.

pub fn len(&self) -> usize

Number of searchable dimensions (frozen params excluded).

Trait Implementations

impl Clone for SearchSpace

fn clone(&self) -> SearchSpace

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SearchSpace

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

Formats the value using the given formatter.

impl Default for SearchSpace

fn default() -> SearchSpace

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SearchSpace

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for SearchSpace

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

Formats the value using the given formatter.

impl Serialize for SearchSpace

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

where __S: Serializer,

Serialize this value into the given Serde serializer.