Struct SearchSpace 

pub struct SearchSpace {
    pub parameters: Vec<ParameterRange>,
}

The set of parameter ranges that define the experiment search space.

The default search space covers five parameters: temperature, top_p, top_k, frequency_penalty, and presence_penalty. Custom spaces can be constructed by providing any subset of ParameterRange values.

When deserialized from config with [serde(default)], missing fields are filled from Default::default.

Examples

use zeph_experiments::{SearchSpace, ParameterKind};

let space = SearchSpace::default();
assert!(space.is_valid());
assert!(space.grid_size() > 0);
assert!(space.range_for(ParameterKind::Temperature).is_some());

Fields

parameters: Vec<ParameterRange>

The parameter ranges in this search space.

Implementations

impl SearchSpace

pub fn range_for(&self, kind: ParameterKind) -> Option<&ParameterRange>

Find the range for a given ParameterKind, if present.

Returns None if the search space does not include the requested kind.

Examples

use zeph_experiments::{SearchSpace, ParameterKind};

let space = SearchSpace::default();
let temp = space.range_for(ParameterKind::Temperature).unwrap();
assert!((temp.default - 0.7).abs() < f64::EPSILON);

// RetrievalTopK is not in the default space
assert!(space.range_for(ParameterKind::RetrievalTopK).is_none());

pub fn is_valid(&self) -> bool

Return true if all parameter ranges in this space are internally consistent.

Examples

use zeph_experiments::SearchSpace;

assert!(SearchSpace::default().is_valid());
assert!(SearchSpace { parameters: vec![] }.is_valid()); // empty is valid

pub fn grid_size(&self) -> usize

Total number of discrete grid points across all parameters that have a step.

This equals the number of distinct variations a GridStep generator will produce before returning None. Parameters without a step are not counted.

Examples

use zeph_experiments::SearchSpace;

let size = SearchSpace::default().grid_size();
assert!(size > 0);

assert_eq!(SearchSpace { parameters: vec![] }.grid_size(), 0);

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() -> Self

Returns the “default value” for a type.

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

where SearchSpace: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

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.