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...
bool	startup_preflight = true
	Validate seeded build(input, ...) calls by pushing/pulling the seed once. More...
RunAdvancedOptions	advanced {}
	Advanced tuning (rarely needed). More...
PowerMonitorOptions	power_monitor {}
	Optional board rail power telemetry. More...
RunAutoExportOptions	run_export {}
	Optional build-time Run/graph JSON export. More...
RunAutoExportOptions	graph_run_export {}
	Backward-compatible spelling for the previous graph-run export field. 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 Graph::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 157 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 231 of file Run.h.

231 RunOptions& disable_power_monitor() {

232 power_monitor = PowerMonitorOptions{};

233 return *this;

234 }

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 198 of file Run.h.

198 RunOptions& enable_board_power(int sample_interval_ms = 100) {

199 power_monitor = board_power_monitor_options(sample_interval_ms);

200 return *this;

201 }

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 223 of file Run.h.

223 RunOptions& enable_modalix_dvt_power(int sample_interval_ms = 100) {

224 power_monitor = modalix_dvt_power_monitor_options(sample_interval_ms);

225 return *this;

226 }

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 = graph.build(inputs, RunMode::Async, opt);

 auto metrics = run.metrics();

Definition at line 215 of file Run.h.

215 RunOptions& enable_modalix_som_power(int sample_interval_ms = 100) {

216 power_monitor = modalix_som_power_monitor_options(sample_interval_ms);

217 return *this;

218 }

Public Member Attributes

advanced

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

Advanced tuning (rarely needed).

Definition at line 186 of file Run.h.

186 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 164 of file Run.h.

164 bool enable_metrics = false;

graph_run_export

RunAutoExportOptions simaai::neat::RunOptions::graph_run_export {}

Backward-compatible spelling for the previous graph-run export field.

Definition at line 190 of file Run.h.

190 RunAutoExportOptions graph_run_export{};

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 171 of file Run.h.

171 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 242 of file Run.h.

242 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 162 of file Run.h.

162 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 160 of file Run.h.

160 OverflowPolicy overflow_policy =

power_monitor

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

Optional board rail power telemetry.

Definition at line 187 of file Run.h.

187 PowerMonitorOptions power_monitor{};

preset

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

Convenience preset that tunes the other fields.

Definition at line 158 of file Run.h.

158 RunPreset preset = RunPreset::Balanced;

queue_depth

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

Capacity of the input/output buffer queues.

Definition at line 159 of file Run.h.

159 int queue_depth = 4;

run_export

RunAutoExportOptions simaai::neat::RunOptions::run_export {}

Optional build-time Run/graph JSON export.

Definition at line 188 of file Run.h.

188 RunAutoExportOptions run_export{};

startup_preflight

bool simaai::neat::RunOptions::startup_preflight = true

Validate seeded build(input, ...) calls by pushing/pulling the seed once.

This applies only to build overloads that receive an initial cv::Mat, TensorList, or Sample. It catches payload-level failures (for example invalid encoded bitstreams or caps that only the GStreamer element can reject) at build time instead of letting the first failure surface asynchronously after a Run has already been returned. Seedless/source builds ignore this option.

Set to false for latency-sensitive callers that only want the seed for caps/shape adaptation and are prepared to observe first-sample errors through Run::last_error() or pull().

Definition at line 185 of file Run.h.

185 bool startup_preflight = true;

---

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

• Run.h

---

Generated via doxygen2docusaurus 2.0.0 by Doxygen 1.9.8.