Struct SimulationKernelConfig 

pub struct SimulationKernelConfig {
    pub column_map: Vec<(String, usize)>,
    pub table_map: Vec<(String, usize)>,
    pub state_field_offsets: Vec<(String, usize)>,
    pub state_schema_id: u32,
    pub column_count: usize,
    pub table_count: usize,
}

Configuration for compiling a simulation kernel.

This provides the field offset mappings needed to generate direct memory access code for the kernel ABI.

Supports two modes:

• Single-series: column_map maps field names (close, volume) to column indices
• Multi-series: table_map maps series names (spy, vix) to series indices

Fields

column_map: Vec<(String, usize)>

Column index mappings: (field_name, column_index) e.g., [(“close”, 3), (“volume”, 4)] Used in single-series mode for accessing columns within one series

table_map: Vec<(String, usize)>

Series index mappings: (series_name, series_index) e.g., [(“spy”, 0), (“vix”, 1), (“temperature”, 2)] Used in multi-series mode for accessing multiple correlated series

CRITICAL for JIT: Resolved at compile time, NOT runtime. context.spy → series_ptrs[0][cursor_idx]

state_field_offsets: Vec<(String, usize)>

State field offsets: (field_name, byte_offset) e.g., [(“cash”, 0), (“position”, 8), (“entry_price”, 16)]

state_schema_id: u32

Schema ID for the state TypedObject

column_count: usize

Total number of columns in the data (single-series mode)

table_count: usize

Total number of series (multi-series mode)

Implementations

impl SimulationKernelConfig

pub fn new(state_schema_id: u32, column_count: usize) -> Self

Create a new kernel config for single-series mode.

pub fn new_multi_table(state_schema_id: u32, table_count: usize) -> Self

Create a new kernel config for multi-series (correlated) mode.

Use this when simulating across multiple aligned time series (e.g., SPY vs VIX, temperature vs pressure).

pub fn map_column(self, field_name: &str, column_index: usize) -> Self

Map a data field name to a column index (single-series mode).

pub fn map_series(self, series_name: &str, series_index: usize) -> Self

Map a series name to a series index (multi-series mode).

CRITICAL: This mapping is resolved at compile time. context.spy in Shape → series_ptrs[0][cursor_idx] in generated code.

pub fn map_state_field(self, field_name: &str, offset: usize) -> Self

Map a state field name to a byte offset.

pub fn get_column_index(&self, field_name: &str) -> Option<usize>

Get column index for a field name (single-series mode).

pub fn get_series_index(&self, series_name: &str) -> Option<usize>

Get series index for a series name (multi-series mode).

This is used by the JIT compiler at compile time.

pub fn get_state_offset(&self, field_name: &str) -> Option<usize>

Get state field offset for a field name.

pub fn is_multi_table(&self) -> bool

Check if this config is for multi-series mode.

Trait Implementations

impl Clone for SimulationKernelConfig

fn clone(&self) -> SimulationKernelConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SimulationKernelConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.