PineForge HPO 1.11.0
Native hyperparameter optimization for PineForge strategies
Loading...
Searching...
No Matches
pineforge::hpo::Pruner Class Referencefinal

Coordinator-owned rung history. More...

#include <pineforge/hpo/pruner.hpp>

Public Member Functions

 Pruner (PrunerKind kind, std::vector< double > rungs, unsigned eta, bool minimize)
 Validates increasing fractions in (0, 1) and an elimination factor >= 2.
 
std::vector< std::size_t > bar_counts (std::size_t full_size) const
 Returns prefix lengths, including the full window, without duplicates.
 
std::vector< std::optional< double > > cuts () const
 Returns cuts based only on observations already committed by the coordinator.
 
void observe (const std::vector< std::optional< double > > &scores)
 Adds finite rung observations after an entire batch has finished.
 
bool prune (double score, std::optional< double > cut) const noexcept
 Strictly losing scores are pruned; ties and missing cuts survive.
 

Detailed Description

Coordinator-owned rung history.

Workers receive immutable cut snapshots. Enabled policies retain the latest 1,024 finite observations per rung; disabled policies retain none. Cut selection remains independent of worker completion timing.

Definition at line 15 of file pruner.hpp.

Constructor & Destructor Documentation

◆ Pruner()

pineforge::hpo::Pruner::Pruner ( PrunerKind  kind,
std::vector< double >  rungs,
unsigned  eta,
bool  minimize 
)

Validates increasing fractions in (0, 1) and an elimination factor >= 2.

Member Function Documentation

◆ bar_counts()

std::vector< std::size_t > pineforge::hpo::Pruner::bar_counts ( std::size_t  full_size) const

Returns prefix lengths, including the full window, without duplicates.

◆ cuts()

std::vector< std::optional< double > > pineforge::hpo::Pruner::cuts ( ) const

Returns cuts based only on observations already committed by the coordinator.

◆ observe()

void pineforge::hpo::Pruner::observe ( const std::vector< std::optional< double > > &  scores)

Adds finite rung observations after an entire batch has finished.

◆ prune()

bool pineforge::hpo::Pruner::prune ( double  score,
std::optional< double >  cut 
) const
noexcept

Strictly losing scores are pruned; ties and missing cuts survive.


The documentation for this class was generated from the following file: