pineforge::hpo::TrialExecutor Class Reference

Deterministic one-shot adapter from serialized parameters to a detached report. More...

#include <pineforge/hpo/trial_executor.hpp>

Public Member Functions
	TrialExecutor (std::shared_ptr< const StrategyPlugin > plugin, std::shared_ptr< const Dataset > dataset, BacktestConfiguration configuration={})
	Binds a validated plugin, immutable dataset, and execution configuration.
TrialExecutionResult	execute (const ParameterValues &inputs, const ParameterValues &strategy_overrides={}) const
	Runs one fresh strategy instance with overrides applied before ordinary inputs.
const BacktestConfiguration &	configuration () const noexcept
	Returns the immutable per-execution configuration.
const Dataset &	dataset () const noexcept
	Returns the shared immutable dataset.
const StrategyPlugin &	plugin () const noexcept
	Returns the loaded strategy plugin.

Detailed Description

Deterministic one-shot adapter from serialized parameters to a detached report.

execute() is const and may be called concurrently: every call creates a fresh strategy handle while all calls share only the immutable plugin function table and Dataset. Report-owned resources are released before the strategy handle on every path.

Definition at line 119 of file trial_executor.hpp.

Constructor & Destructor Documentation

TrialExecutor()

pineforge::hpo::TrialExecutor::TrialExecutor	(	std::shared_ptr< const StrategyPlugin >	plugin,
		std::shared_ptr< const Dataset >	dataset,
		BacktestConfiguration	configuration = {}
	)

Binds a validated plugin, immutable dataset, and execution configuration.

Exceptions

std::invalid_argument

for null dependencies, an ABI-incompatible dataset size, non-positive magnifier samples, or an unknown magnifier distribution.

Member Function Documentation

configuration()

const BacktestConfiguration & pineforge::hpo::TrialExecutor::configuration ( ) const

inlinenoexcept

Returns the immutable per-execution configuration.

Definition at line 137 of file trial_executor.hpp.

dataset()

const Dataset & pineforge::hpo::TrialExecutor::dataset ( ) const

inlinenoexcept

Returns the shared immutable dataset.

Definition at line 139 of file trial_executor.hpp.

execute()

TrialExecutionResult pineforge::hpo::TrialExecutor::execute	(	const ParameterValues &	inputs,
		const ParameterValues &	strategy_overrides = {}
	)		const

Runs one fresh strategy instance with overrides applied before ordinary inputs.

Strategy-reported errors are returned as TrialExecutionStatus::kEngineError. Adapter and plugin contract violations may throw.

plugin()

const StrategyPlugin & pineforge::hpo::TrialExecutor::plugin ( ) const

inlinenoexcept

Returns the loaded strategy plugin.

Definition at line 141 of file trial_executor.hpp.

---

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

• trial_executor.hpp