Struct FieldVector 

pub struct FieldVector { /* private fields */ }

Signal-based vector for temporal fields.

Each element is a Signal (polarity: i8, magnitude: u8, multiplier: u8). Total size: 3 bytes per element.

Arithmetic operations use the full effective value: polarity × magnitude × multiplier (range ±65,025). Results are decomposed back into (p, m, k) via Signal::from_current.

Implementations

impl FieldVector

pub fn new(dims: usize) -> Self

Create a new zero-initialized vector.

pub fn from_signals(signals: Vec<Signal>) -> Self

Create from raw Signal slice.

pub fn dims(&self) -> usize

Get dimensions.

pub fn get(&self, idx: usize) -> Signal

Get Signal at index.

pub fn set(&mut self, idx: usize, signal: Signal)

Set Signal at index.

pub fn get_current(&self, idx: usize) -> i32

Get the full effective value: polarity × magnitude × multiplier (±65,025).

pub fn set_current(&mut self, idx: usize, value: i32)

Set from a signed i32 value using the full p×m×k range (±65,025).

pub fn get_i16(&self, idx: usize) -> i16

Get as signed i16 (polarity × magnitude only, ignores multiplier).

Deprecated in favor of [get_current] which uses the full range. Retained for backward compatibility with code that needs the narrow range.

pub fn set_i16(&mut self, idx: usize, value: i16)

Set from signed i16 value (clamped to ±255, multiplier=1).

Deprecated in favor of [set_current] which uses the full range. Retained for backward compatibility.

pub fn decay(&mut self, retention: u8)

Decay all values toward zero. retention: u8 where 255 = 1.0 (no decay), 230 ≈ 0.90

Decays the effective value (p×m×k), then re-encodes into Signal. This preserves the full dynamic range during decay.

pub fn add(&mut self, other: &FieldVector)

Add another vector (saturating at ±65,025).

pub fn add_to_range(&mut self, signals: &[Signal], range: Range<usize>)

Add Signals to a range (saturating at ±65,025).

pub fn set_range(&mut self, signals: &[Signal], range: Range<usize>)

Set Signals in a range.

pub fn get_range(&self, range: Range<usize>) -> Vec<Signal>

Get Signals from a range.

pub fn range_energy(&self, range: Range<usize>) -> u64

Compute energy (sum of squared effective magnitudes) in a range. Returns u64 to prevent overflow (max per element: 65025² ≈ 4.2B).

pub fn range_active(&self, range: Range<usize>, threshold: u64) -> bool

Check if range is active (energy above threshold).

pub fn is_zero(&self) -> bool

Check if all signals are zero.

pub fn non_zero_count(&self) -> usize

Count non-zero signals.

pub fn max_magnitude(&self) -> u16

Get maximum effective magnitude.

pub fn scale(&mut self, factor: u8)

Scale all values by factor (u8 where 255 = 1.0).

pub fn as_slice(&self) -> &[Signal]

Get slice reference for direct access.

pub fn as_mut_slice(&mut self) -> &mut [Signal]

Get mutable slice reference.

Trait Implementations

impl Clone for FieldVector

fn clone(&self) -> FieldVector

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FieldVector

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

Formats the value using the given formatter.

impl Default for FieldVector

fn default() -> Self

Returns the “default value” for a type.