RunOptions Struct

Per-Run runtime options. More...

Declaration

struct simaai::neat::RunOptions { ... }

Included Headers

#include <Run.h>

Public Member Functions Index

RunOptions &	enable_board_power (int sample_interval_ms=100)
	Enable board power monitoring using built-in auto-detect. More...
RunOptions &	enable_modalix_som_power (int sample_interval_ms=100)
	Enable default Modalix SOM PMIC rail power monitoring for this Run. More...
RunOptions &	enable_modalix_dvt_power (int sample_interval_ms=100)
	Enable the built-in Modalix DVT PMIC table for this Run. More...
RunOptions &	disable_power_monitor ()
	Disable power monitoring after it was enabled/configured. More...

Public Member Attributes Index

RunPreset	preset = RunPreset::Balanced
	Convenience preset that tunes the other fields. More...
int	queue_depth = 4
	Capacity of the input/output buffer queues. More...
OverflowPolicy	overflow_policy = ...
	What to do when the input queue is full. More...
OutputMemory	output_memory = ...
	Whether output tensors are zero-copy or owned. More...
bool	enable_metrics = false
	Collect detailed per-stage metrics in the Run's stats vectors. More...
int	input_timeout_ms = -1
	Default pull timeout for build()/run() input-mode paths, in milliseconds. More...
RunAdvancedOptions	advanced {}
	Advanced tuning (rarely needed). More...
PowerMonitorOptions	power_monitor {}
	Optional board rail power telemetry. More...
std::function< void(const struct InputDropInfo &)>	on_input_drop
	Optional callback invoked when an input frame is dropped by the overflow policy. More...

Description

Per-Run runtime options.

Passed to Session::build() and Model::run().

Most fields default to sensible values. The most commonly customized are queue_depth (deeper for jittery sources, shallower for low latency) and overflow_policy (driven by the input source's behavior — see the OverflowPolicy enum docs).

Definition at line 124 of file Run.h.

Public Member Functions

disable_power_monitor()

RunOptions & simaai::neat::RunOptions::disable_power_monitor ()

inline

Disable power monitoring after it was enabled/configured.

Definition at line 181 of file Run.h.

181 RunOptions& disable_power_monitor() {

182 power_monitor = PowerMonitorOptions{};

183 return *this;

184 }

enable_board_power()

RunOptions & simaai::neat::RunOptions::enable_board_power (int sample_interval_ms=100)

inline

Enable board power monitoring using built-in auto-detect.

This is the preferred no-env path for capturing latency, throughput, and power together from any Run.

Definition at line 148 of file Run.h.

148 RunOptions& enable_board_power(int sample_interval_ms = 100) {

149 power_monitor = board_power_monitor_options(sample_interval_ms);

150 return *this;

151 }

enable_modalix_dvt_power()

RunOptions & simaai::neat::RunOptions::enable_modalix_dvt_power (int sample_interval_ms=100)

inline

Enable the built-in Modalix DVT PMIC table for this Run.

Definition at line 173 of file Run.h.

173 RunOptions& enable_modalix_dvt_power(int sample_interval_ms = 100) {

174 power_monitor = modalix_dvt_power_monitor_options(sample_interval_ms);

175 return *this;

176 }

enable_modalix_som_power()

RunOptions & simaai::neat::RunOptions::enable_modalix_som_power (int sample_interval_ms=100)

inline

Enable default Modalix SOM PMIC rail power monitoring for this Run.

Prefer enable_board_power() unless you need to force the SOM profile:

 RunOptions opt;

 opt.enable_board_power();

 auto run = session.build(inputs, RunMode::Async, opt);

 auto metrics = run.metrics();

Definition at line 165 of file Run.h.

165 RunOptions& enable_modalix_som_power(int sample_interval_ms = 100) {

166 power_monitor = modalix_som_power_monitor_options(sample_interval_ms);

167 return *this;

168 }

Public Member Attributes

advanced

RunAdvancedOptions simaai::neat::RunOptions::advanced {}

Advanced tuning (rarely needed).

Definition at line 139 of file Run.h.

139 RunAdvancedOptions advanced{};

enable_metrics

bool simaai::neat::RunOptions::enable_metrics = false

Collect detailed per-stage metrics in the Run's stats vectors.

Definition at line 131 of file Run.h.

131 bool enable_metrics = false;

input_timeout_ms

int simaai::neat::RunOptions::input_timeout_ms = -1

Default pull timeout for build()/run() input-mode paths, in milliseconds.

-1 keeps framework defaults (and legacy env-var fallback). Override per-call by passing an explicit timeout_ms to the relevant pull() or run() overload.

Definition at line 138 of file Run.h.

138 int input_timeout_ms = -1;

on_input_drop

std::function<void(const struct InputDropInfo&)> simaai::neat::RunOptions::on_input_drop

Optional callback invoked when an input frame is dropped by the overflow policy.

Useful for telemetry — log the drop reason, update a counter, etc. Callback runs on the pushing thread; keep it short.

Definition at line 192 of file Run.h.

192 std::function<void(const struct InputDropInfo&)> on_input_drop;

output_memory

OutputMemory simaai::neat::RunOptions::output_memory

Whether output tensors are zero-copy or owned.

Initialiser

= OutputMemory::Auto

Definition at line 129 of file Run.h.

129 OutputMemory output_memory =

overflow_policy

OverflowPolicy simaai::neat::RunOptions::overflow_policy

What to do when the input queue is full.

Initialiser

= OverflowPolicy::Block

Definition at line 127 of file Run.h.

127 OverflowPolicy overflow_policy =

power_monitor

PowerMonitorOptions simaai::neat::RunOptions::power_monitor {}

Optional board rail power telemetry.

Definition at line 140 of file Run.h.

140 PowerMonitorOptions power_monitor{};

preset

RunPreset simaai::neat::RunOptions::preset = RunPreset::Balanced

Convenience preset that tunes the other fields.

Definition at line 125 of file Run.h.

125 RunPreset preset = RunPreset::Balanced;

queue_depth

int simaai::neat::RunOptions::queue_depth = 4

Capacity of the input/output buffer queues.

Definition at line 126 of file Run.h.

126 int queue_depth = 4;

---

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

• Run.h

---

Generated via doxygen2docusaurus 2.0.0 by Doxygen 1.9.8.