PreprocOptions Struct

Construction options for a Preproc Node. More...

Declaration

struct simaai::neat::PreprocOptions { ... }

Included Headers

#include <Preproc.h>

Public Constructors Index

	PreprocOptions ()=default
	Default-construct with framework-default values; tune fields after construction. More...
	PreprocOptions (const simaai::neat::Model &model)
	Initialize options from a loaded Model (pulls input/output shapes, dtype, scale/zp). More...

Public Member Functions Index

void	set_input_shape (std::vector< int > shape)
	Replace the input image shape (H, W, C). More...
void	set_output_shape (std::vector< int > shape)
	Replace the output tensor shape. More...
void	set_slice_shape (std::vector< int > shape)
	Replace the slice/tile shape used for batched processing. More...
int	input_height () const
	Input image height (axis 0 of input_shape). More...
int	input_width () const
	Input image width (axis 1 of input_shape). More...
int	input_channels () const
	Input channel count. More...
int	output_height () const
	Output tensor height. More...
int	output_width () const
	Output tensor width. More...
int	output_channels () const
	Output channel count. More...
int	slice_height () const
	Slice height. More...
int	slice_width () const
	Slice width. More...
int	slice_channels () const
	Slice channel count. More...
bool	has_input_shape () const
	True if input_shape is fully populated. More...
bool	has_output_shape () const
	True if output_shape is fully populated. More...
bool	has_slice_shape () const
	True if slice_shape is fully populated. More...

Public Member Attributes Index

std::vector< int >	input_shape
	Input image shape (H, W, C). More...
std::vector< int >	output_shape
	Output tensor shape after resize/normalize. More...
std::vector< int >	slice_shape
	Optional slice/tile shape used for batched processing. More...
int	scaled_width = 0
	Intermediate scaled width (before crop/pad), pixels. More...
int	scaled_height = 0
	Intermediate scaled height (before crop/pad), pixels. More...
int	batch_size = 1
	Batch size processed per invocation. More...
bool	normalize = true
	Apply mean/stddev normalization. More...
bool	aspect_ratio = true
	Preserve aspect ratio during resize (letterbox). More...
bool	tessellate = true
	Tessellate output into MLA tile geometry. More...
bool	dynamic_input_dims = true
	Allow dynamic input dimensions at runtime. More...
bool	single_output_handoff = true
	Hand off a single output buffer per cycle (vs. ping-pong). More...
int	input_offset = 0
	Byte offset into the input buffer. More...
int	input_stride = 1
	Element stride for input addressing. More...
int	output_stride = 1
	Element stride for output addressing. More...
std::optional< std::int64_t >	q_zp
	Output quantization zero-point (when emitting INT8/INT16). More...
std::optional< double >	q_scale
	Output quantization scale (when emitting INT8/INT16). More...
std::vector< float >	channel_mean = {0.0f, 0.0f, 0.0f}
	Per-channel mean used by normalize. More...
std::vector< float >	channel_stddev = {1.0f, 1.0f, 1.0f}
	Per-channel stddev used by normalize. More...
std::string	input_img_type
	Input pixel format (e.g. "NV12", "RGB"). More...
std::string	output_img_type = "RGB"
	Output color space. More...
std::string	output_dtype = "INT16"
	Output element dtype (e.g. "INT16", "BF16"). More...
std::string	scaling_type = "BILINEAR"
	Resize interpolation ("BILINEAR", "NEAREST"). More...
std::string	padding_type = "CENTER"
	Letterbox padding mode ("CENTER", "TOPLEFT"). More...
int	pad_value = 0
	Raw image-space letterbox pad fill value. More...
std::string	graph_name = "preproc"
	CVU graph name in the kernel config. More...
std::string	node_name = "preproc"
	CVU node name in the kernel config. More...
std::string	element_name
	Optional GStreamer element name. More...
std::string	cpu = "CVU"
	CPU/accelerator this stage runs on. More...
std::string	next_cpu = "CVU"
	CPU/accelerator the downstream stage runs on. More...
std::string	debug = "EVXX_DBG_DISABLED"
	Debug-output flag passed to the CVU kernel. More...
std::string	upstream_name = "decoder"
	Name of the upstream element for tag wiring. More...
std::string	graph_input_name = "input_image"
	Input tensor name within the CVU graph. More...
int	num_buffers = 0
	Override for the element's buffer pool size. More...
int	num_buffers_model = 0
	Buffer count derived from the bound model. More...
bool	num_buffers_locked = false
	If true, planner won't override num_buffers. More...
bool	model_managed_contract = false
	If true, the model owns the node contract resolution. More...

Public Static Functions Index

static int	shape_dim (const std::vector< int > &shape, std::size_t index)
	Safe accessor: return shape[index] or 0 if out of bounds. More...
static int	shape_channels (const std::vector< int > &shape)
	Last-axis channel count for an HWC-style shape, or 0 if rank < 3. More...

Description

Construction options for a Preproc Node.

Most fields are derived from the bound Model when the constructor that takes a Model is used; explicit setters are provided for graphs that don't have a model yet at Node-construction time.

Definition at line 44 of file Preproc.h.

Public Constructors

PreprocOptions()

simaai::neat::PreprocOptions::PreprocOptions ()

default

Default-construct with framework-default values; tune fields after construction.

Definition at line 46 of file Preproc.h.

PreprocOptions()

simaai::neat::PreprocOptions::PreprocOptions (const simaai::neat::Model & model)

explicit

Initialize options from a loaded Model (pulls input/output shapes, dtype, scale/zp).

Definition at line 48 of file Preproc.h.

Public Member Functions

has_input_shape()

bool simaai::neat::PreprocOptions::has_input_shape ()

inline

True if input_shape is fully populated.

Definition at line 171 of file Preproc.h.

has_output_shape()

bool simaai::neat::PreprocOptions::has_output_shape ()

inline

True if output_shape is fully populated.

Definition at line 176 of file Preproc.h.

has_slice_shape()

bool simaai::neat::PreprocOptions::has_slice_shape ()

inline

True if slice_shape is fully populated.

Definition at line 181 of file Preproc.h.

input_channels()

int simaai::neat::PreprocOptions::input_channels ()

inline

Input channel count.

Definition at line 136 of file Preproc.h.

input_height()

int simaai::neat::PreprocOptions::input_height ()

inline

Input image height (axis 0 of input_shape).

Definition at line 126 of file Preproc.h.

input_width()

int simaai::neat::PreprocOptions::input_width ()

inline

Input image width (axis 1 of input_shape).

Definition at line 131 of file Preproc.h.

output_channels()

int simaai::neat::PreprocOptions::output_channels ()

inline

Output channel count.

Definition at line 151 of file Preproc.h.

output_height()

int simaai::neat::PreprocOptions::output_height ()

inline

Output tensor height.

Definition at line 141 of file Preproc.h.

output_width()

int simaai::neat::PreprocOptions::output_width ()

inline

Output tensor width.

Definition at line 146 of file Preproc.h.

set_input_shape()

void simaai::neat::PreprocOptions::set_input_shape (std::vector< int > shape)

inline

Replace the input image shape (H, W, C).

Definition at line 101 of file Preproc.h.

set_output_shape()

void simaai::neat::PreprocOptions::set_output_shape (std::vector< int > shape)

inline

Replace the output tensor shape.

Definition at line 106 of file Preproc.h.

set_slice_shape()

void simaai::neat::PreprocOptions::set_slice_shape (std::vector< int > shape)

inline

Replace the slice/tile shape used for batched processing.

Definition at line 111 of file Preproc.h.

slice_channels()

int simaai::neat::PreprocOptions::slice_channels ()

inline

Slice channel count.

Definition at line 166 of file Preproc.h.

slice_height()

int simaai::neat::PreprocOptions::slice_height ()

inline

Slice height.

Definition at line 156 of file Preproc.h.

slice_width()

int simaai::neat::PreprocOptions::slice_width ()

inline

Slice width.

Definition at line 161 of file Preproc.h.

Public Member Attributes

aspect_ratio

bool simaai::neat::PreprocOptions::aspect_ratio = true

Preserve aspect ratio during resize (letterbox).

Definition at line 60 of file Preproc.h.

batch_size

int simaai::neat::PreprocOptions::batch_size = 1

Batch size processed per invocation.

Definition at line 57 of file Preproc.h.

channel_mean

std::vector<float> simaai::neat::PreprocOptions::channel_mean = {0.0f, 0.0f, 0.0f}

Per-channel mean used by normalize.

Definition at line 72 of file Preproc.h.

channel_stddev

std::vector<float> simaai::neat::PreprocOptions::channel_stddev = {1.0f, 1.0f, 1.0f}

Per-channel stddev used by normalize.

Definition at line 73 of file Preproc.h.

cpu

std::string simaai::neat::PreprocOptions::cpu = "CVU"

CPU/accelerator this stage runs on.

Definition at line 85 of file Preproc.h.

debug

std::string simaai::neat::PreprocOptions::debug = "EVXX_DBG_DISABLED"

Debug-output flag passed to the CVU kernel.

Definition at line 87 of file Preproc.h.

dynamic_input_dims

bool simaai::neat::PreprocOptions::dynamic_input_dims = true

Allow dynamic input dimensions at runtime.

Definition at line 62 of file Preproc.h.

element_name

std::string simaai::neat::PreprocOptions::element_name

Optional GStreamer element name.

Definition at line 84 of file Preproc.h.

graph_input_name

std::string simaai::neat::PreprocOptions::graph_input_name = "input_image"

Input tensor name within the CVU graph.

Definition at line 90 of file Preproc.h.

graph_name

std::string simaai::neat::PreprocOptions::graph_name = "preproc"

CVU graph name in the kernel config.

Definition at line 82 of file Preproc.h.

input_img_type

std::string simaai::neat::PreprocOptions::input_img_type

Input pixel format (e.g. "NV12", "RGB").

Definition at line 75 of file Preproc.h.

input_offset

int simaai::neat::PreprocOptions::input_offset = 0

Byte offset into the input buffer.

Definition at line 65 of file Preproc.h.

input_shape

std::vector<int> simaai::neat::PreprocOptions::input_shape

Input image shape (H, W, C).

Definition at line 50 of file Preproc.h.

input_stride

int simaai::neat::PreprocOptions::input_stride = 1

Element stride for input addressing.

Definition at line 66 of file Preproc.h.

model_managed_contract

bool simaai::neat::PreprocOptions::model_managed_contract = false

If true, the model owns the node contract resolution.

Definition at line 95 of file Preproc.h.

next_cpu

std::string simaai::neat::PreprocOptions::next_cpu = "CVU"

CPU/accelerator the downstream stage runs on.

Definition at line 86 of file Preproc.h.

node_name

std::string simaai::neat::PreprocOptions::node_name = "preproc"

CVU node name in the kernel config.

Definition at line 83 of file Preproc.h.

normalize

bool simaai::neat::PreprocOptions::normalize = true

Apply mean/stddev normalization.

Definition at line 59 of file Preproc.h.

num_buffers

int simaai::neat::PreprocOptions::num_buffers = 0

Override for the element's buffer pool size.

Definition at line 92 of file Preproc.h.

num_buffers_locked

bool simaai::neat::PreprocOptions::num_buffers_locked = false

If true, planner won't override num_buffers.

Definition at line 94 of file Preproc.h.

num_buffers_model

int simaai::neat::PreprocOptions::num_buffers_model = 0

Buffer count derived from the bound model.

Definition at line 93 of file Preproc.h.

output_dtype

std::string simaai::neat::PreprocOptions::output_dtype = "INT16"

Output element dtype (e.g. "INT16", "BF16").

Definition at line 77 of file Preproc.h.

output_img_type

std::string simaai::neat::PreprocOptions::output_img_type = "RGB"

Output color space.

Definition at line 76 of file Preproc.h.

output_shape

std::vector<int> simaai::neat::PreprocOptions::output_shape

Output tensor shape after resize/normalize.

Definition at line 51 of file Preproc.h.

output_stride

int simaai::neat::PreprocOptions::output_stride = 1

Element stride for output addressing.

Definition at line 67 of file Preproc.h.

pad_value

int simaai::neat::PreprocOptions::pad_value = 0

Raw image-space letterbox pad fill value.

Definition at line 80 of file Preproc.h.

padding_type

std::string simaai::neat::PreprocOptions::padding_type = "CENTER"

Letterbox padding mode ("CENTER", "TOPLEFT").

Definition at line 79 of file Preproc.h.

q_scale

std::optional<double> simaai::neat::PreprocOptions::q_scale

Output quantization scale (when emitting INT8/INT16).

Definition at line 70 of file Preproc.h.

q_zp

std::optional<std::int64_t> simaai::neat::PreprocOptions::q_zp

Output quantization zero-point (when emitting INT8/INT16).

Definition at line 69 of file Preproc.h.

scaled_height

int simaai::neat::PreprocOptions::scaled_height = 0

Intermediate scaled height (before crop/pad), pixels.

Definition at line 55 of file Preproc.h.

scaled_width

int simaai::neat::PreprocOptions::scaled_width = 0

Intermediate scaled width (before crop/pad), pixels.

Definition at line 54 of file Preproc.h.

scaling_type

std::string simaai::neat::PreprocOptions::scaling_type = "BILINEAR"

Resize interpolation ("BILINEAR", "NEAREST").

Definition at line 78 of file Preproc.h.

single_output_handoff

bool simaai::neat::PreprocOptions::single_output_handoff = true

Hand off a single output buffer per cycle (vs. ping-pong).

Definition at line 63 of file Preproc.h.

slice_shape

std::vector<int> simaai::neat::PreprocOptions::slice_shape

Optional slice/tile shape used for batched processing.

Definition at line 52 of file Preproc.h.

tessellate

bool simaai::neat::PreprocOptions::tessellate = true

Tessellate output into MLA tile geometry.

Definition at line 61 of file Preproc.h.

upstream_name

std::string simaai::neat::PreprocOptions::upstream_name = "decoder"

Name of the upstream element for tag wiring.

Definition at line 89 of file Preproc.h.

Public Static Functions

shape_channels()

int simaai::neat::PreprocOptions::shape_channels (const std::vector< int > & shape)

inline static

Last-axis channel count for an HWC-style shape, or 0 if rank < 3.

Definition at line 121 of file Preproc.h.

shape_dim()

int simaai::neat::PreprocOptions::shape_dim (const std::vector< int > & shape, std::size_t index)

inline static

Safe accessor: return shape[index] or 0 if out of bounds.

Definition at line 116 of file Preproc.h.

---

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

• Preproc.h

---

Generated via doxygen2docusaurus 2.0.0 by Doxygen 1.9.8.