Skip to main content

Precision

Enum Precision 

Source
#[non_exhaustive]
pub enum Precision { Float, Fixed, }
Available on crate feature alloc only.
Expand description

Compute precision for SNN weight and activation storage.

Controls whether the network operates in floating-point or fixed-point mode. The default is platform-dependent:

  • When std is available (desktop / server), Float (f32) is the default. f32 offers fast IEEE-754 arithmetic and is sufficient for online learning workloads where weights are updated continuously.

  • When std is absent (cortex_m / bare-metal no_std), Fixed (Q1.14 i16) is the default. Fixed-point is mandatory on Cortex-M0+ and RISC-V parts without FPU hardware; it also reduces SRAM footprint by 2x versus f32 (2 bytes vs 4 per weight).

This is a principled default, not an arbitrary one: the selection criterion is memory budget and FPU availability, both of which are unambiguous at compile time. A desktop build never needs the 2x SRAM saving; a bare-metal build never has a hardware FPU to benefit from.

§Note on Current State

SpikeNetFixed unconditionally uses Q1.14 arithmetic at the compute level. This enum documents the intended precision and is used as a config field for future path selection. Selecting Precision::Float on a std build currently behaves identically to Precision::Fixed (the fixed-point kernel is always used). When an f32 kernel lands, Float will activate it.

Variants (Non-exhaustive)§

This enum is marked as non-exhaustive
Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.
§

Float

32-bit IEEE-754 floating-point. Default on std targets.

Best for: desktop / server workloads with hardware FPU.

§

Fixed

Q1.14 fixed-point (i16). Default on no_std / cortex_m targets.

Best for: microcontrollers without FPU, minimum SRAM footprint.

Trait Implementations§

Source§

impl Clone for Precision

Source§

fn clone(&self) -> Precision

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Precision

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for Precision

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl PartialEq for Precision

Source§

fn eq(&self, other: &Precision) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl Copy for Precision

Source§

impl Eq for Precision

Source§

impl StructuralPartialEq for Precision

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.