Struct e5m2 

pub struct e5m2(/* private fields */);

A 8-bit floating point type with 5 exponent bits and 2 mantissa bits.

Implementations

impl e5m2

pub const MAX: e5m2

Maximum representable value

pub const MIN: e5m2

Minimum representable value

pub const EPSILON: e5m2

the difference between 1.0 and the next largest representable number.

pub const MIN_POSITIVE: e5m2

Minimum representable value

pub const DIGITS: u32 = F8E5M2::DIGITS

Approximate number of significant digits in base 10

pub const MANTISSA_DIGITS: u32 = F8E5M2::MANTISSA_DIGITS

Number of mantissa digits

pub const MAX_10_EXP: i32 = F8E5M2::MAX_10_EXP

Maximum possible normal power of 10 exponent

pub const MAX_EXP: i32 = F8E5M2::MAX_EXP

Maximum possible normal power of 2 exponent

pub const MIN_10_EXP: i32 = F8E5M2::MIN_10_EXP

Minimum possible normal power of 10 exponent

pub const MIN_EXP: i32 = F8E5M2::MIN_EXP

Minimum possible normal power of 2 exponent

pub const RADIX: u32 = 2

The radix, or base, of the floating-point representation.

pub const NAN: e5m2

nan

pub const ZERO: e5m2

Zero

pub const NEG_ZERO: e5m2

Negative Zero

pub const ONE: e5m2

One

pub const fn from_bits(bits: u8) -> e5m2

Constructs a e5m2 value from the raw bits.

pub const fn from_f32(value: f32) -> e5m2

Constructs a e5m2 value from a 32-bit floating point value.

This operation is lossy. If the 32-bit value is too large to fit, ±∞ will result. NaN values are preserved. Subnormal values that are too tiny to be represented will result in ±0. All other values are truncated and rounded to the nearest representable value.

pub const fn from_f64(value: f64) -> e5m2

Constructs a e5m2 value from a 64-bit floating point value.

This operation is lossy. If the 64-bit value is to large to fit, ±∞ will result. NaN values are preserved. 64-bit subnormal values are too tiny to be represented and result in ±0. Exponents that underflow the minimum exponent will result in subnormals or ±0. All other values are truncated and rounded to the nearest representable value.

pub const fn to_bits(self) -> u8

Converts a e5m2 into the underlying bit representation.

pub fn is_nan(self) -> bool

check if an e5m2 value is Nan

pub const fn to_f32(self) -> f32

Converts a e5m2 value into an f32 value.

This conversion is lossless as all values can be represented exactly in f32.

pub const fn to_f64(self) -> f64

Converts a e5m2 value into an f64 value.

This conversion is lossless as all values can be represented exactly in f64.

pub fn total_cmp(self, other: e5m2) -> Ordering

Compares e5m2 values

Trait Implementations

impl Abs for e5m2

fn abs(self) -> Self

fn __expand_abs(scope: &Scope, x: NativeExpand<Self>) -> NativeExpand<Self>

impl Add for e5m2

type Output = e5m2

The resulting type after applying the + operator.

fn add(self, rhs: e5m2) -> <e5m2 as Add>::Output

Performs the + operation.

impl AddAssign for e5m2

fn add_assign(&mut self, rhs: e5m2)

Performs the += operation.

impl Clone for e5m2

fn clone(&self) -> e5m2

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for e5m2

impl CubeDebug for e5m2

fn set_debug_name(&self, scope: &Scope, name: &'static str)

Set the debug name of this type’s expansion. Should do nothing for types that don’t appear at runtime

impl CubeElement for e5m2

fn type_name() -> &'static str

Returns the name of the type.

fn as_bytes(slice: &[Self]) -> &[u8]

Convert a slice of elements to a slice of bytes.

fn from_bytes(bytes: &[u8]) -> &[Self]

Convert a slice of bytes to a slice of elements.

fn cube_type() -> StorageType

Element representation for cubecl.

fn maximum_value() -> Self

Highest possible value

fn minimum_value() -> Self

Lowest possible value

impl CubePrimitive for e5m2

fn as_type_native() -> Option<Type>

Return the element type to use on GPU

type Scalar = e5m2

type Size = Const<1>

type WithScalar<S: Scalar> = S

fn from_const_value(value: ConstantValue) -> Self

fn as_type() -> Type

Return the element type to use on GPU.

fn as_type_native_unchecked() -> Type

Native or static element type.

fn size() -> Option<usize>

Only native element types have a size.

fn size_bits() -> Option<usize>

Only native element types have a size.

fn size_bits_unchecked() -> usize

Only native element types have a size.

fn from_expand_elem(elem: Value) -> Self::ExpandType

fn into_lit_unchecked(self) -> Self

fn supported_uses<R: Runtime>(client: &ComputeClient<R>) -> EnumSet<TypeUsage>

fn type_size() -> usize

fn type_size_bits() -> usize

fn packing_factor() -> usize

fn vector_size() -> usize

fn __expand_as_type(_scope: &Scope) -> Type

fn __expand_type_size(scope: &Scope) -> usize

fn __expand_type_size_bits(scope: &Scope) -> usize

fn __expand_packing_factor(scope: &Scope) -> usize

fn __expand_vector_size(scope: &Scope) -> usize

impl CubeType for e5m2

type ExpandType = NativeExpand<e5m2>

impl Debug for e5m2

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

Formats the value using the given formatter.

impl Default for e5m2

fn default() -> e5m2

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for e5m2

fn deserialize<__D>( __deserializer: __D, ) -> Result<e5m2, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for e5m2

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

Formats the value using the given formatter.

impl Div for e5m2

type Output = e5m2

The resulting type after applying the / operator.

fn div(self, rhs: e5m2) -> <e5m2 as Div>::Output

Performs the / operation.

impl DivAssign for e5m2

fn div_assign(&mut self, rhs: e5m2)

Performs the /= operation.

impl FloatBits for e5m2

type Bits = u8

fn __expand_from_bits( scope: &Scope, bits: NativeExpand<Self::Bits>, ) -> NativeExpand<Self>

fn __expand_to_bits( scope: &Scope, this: NativeExpand<Self>, ) -> NativeExpand<Self::Bits>

impl From<F8E5M2> for e5m2

fn from(value: F8E5M2) -> e5m2

Converts to this type from the input type.

impl From<e5m2> for NativeExpand<e5m2>

fn from(value: e5m2) -> Self

Converts to this type from the input type.

impl IntoExpand for e5m2

type Expand = NativeExpand<e5m2>

fn into_expand(self, _scope: &Scope) -> Self::Expand

impl IntoRuntime for e5m2

fn __expand_runtime_method(self, _scope: &Scope) -> NativeExpand<Self>

fn runtime(self) -> Self

impl Mul for e5m2

type Output = e5m2

The resulting type after applying the * operator.

fn mul(self, rhs: e5m2) -> <e5m2 as Mul>::Output

Performs the * operation.

impl MulAssign for e5m2

fn mul_assign(&mut self, rhs: e5m2)

Performs the *= operation.

impl NativeAssign for e5m2

fn elem_init_mut(scope: &Scope, elem: Value) -> Value

impl Neg for e5m2

type Output = e5m2

The resulting type after applying the - operator.

fn neg(self) -> <e5m2 as Neg>::Output

Performs the unary - operation.

impl Num for e5m2

type FromStrRadixErr = ParseFloatError

fn from_str_radix( src: &str, radix: u32, ) -> Result<e5m2, <e5m2 as Num>::FromStrRadixErr>

Convert from a string and radix (typically 2..=36).

impl NumCast for e5m2

fn from<T>(n: T) -> Option<e5m2>

where T: ToPrimitive,

Creates a number from another value that can be converted into a primitive via the ToPrimitive trait. If the source value cannot be represented by the target type, then None is returned.

impl One for e5m2

fn one() -> e5m2

Returns the multiplicative identity element of Self, 1.

fn is_one(&self) -> bool

Returns true if self is equal to the multiplicative identity.

fn set_one(&mut self)

Sets self to the multiplicative identity element of Self, 1.

impl PartialEq for e5m2

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for e5m2

fn partial_cmp(&self, other: &e5m2) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Pod for e5m2

impl Rem for e5m2

type Output = e5m2

The resulting type after applying the % operator.

fn rem(self, rhs: e5m2) -> <e5m2 as Rem>::Output

Performs the % operation.

impl RemAssign for e5m2

fn rem_assign(&mut self, rhs: e5m2)

Performs the %= operation.

impl Scalar for e5m2

impl Serialize for e5m2

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for e5m2

impl Sub for e5m2

type Output = e5m2

The resulting type after applying the - operator.

fn sub(self, rhs: e5m2) -> <e5m2 as Sub>::Output

Performs the - operation.

impl SubAssign for e5m2

fn sub_assign(&mut self, rhs: e5m2)

Performs the -= operation.

impl ToPrimitive for e5m2

fn to_i64(&self) -> Option<i64>

Converts the value of self to an i64. If the value cannot be represented by an i64, then None is returned.

fn to_u64(&self) -> Option<u64>

Converts the value of self to a u64. If the value cannot be represented by a u64, then None is returned.

fn to_f32(&self) -> Option<f32>

Converts the value of self to an f32. Overflows may map to positive or negative inifinity, otherwise None is returned if the value cannot be represented by an f32.

fn to_f64(&self) -> Option<f64>

Converts the value of self to an f64. Overflows may map to positive or negative inifinity, otherwise None is returned if the value cannot be represented by an f64.

fn to_isize(&self) -> Option<isize>

Converts the value of self to an isize. If the value cannot be represented by an isize, then None is returned.

fn to_i8(&self) -> Option<i8>

Converts the value of self to an i8. If the value cannot be represented by an i8, then None is returned.

fn to_i16(&self) -> Option<i16>

Converts the value of self to an i16. If the value cannot be represented by an i16, then None is returned.

fn to_i32(&self) -> Option<i32>

Converts the value of self to an i32. If the value cannot be represented by an i32, then None is returned.

fn to_i128(&self) -> Option<i128>

Converts the value of self to an i128. If the value cannot be represented by an i128 (i64 under the default implementation), then None is returned.

fn to_usize(&self) -> Option<usize>

Converts the value of self to a usize. If the value cannot be represented by a usize, then None is returned.

fn to_u8(&self) -> Option<u8>

Converts the value of self to a u8. If the value cannot be represented by a u8, then None is returned.

fn to_u16(&self) -> Option<u16>

Converts the value of self to a u16. If the value cannot be represented by a u16, then None is returned.

fn to_u32(&self) -> Option<u32>

Converts the value of self to a u32. If the value cannot be represented by a u32, then None is returned.

fn to_u128(&self) -> Option<u128>

Converts the value of self to a u128. If the value cannot be represented by a u128 (u64 under the default implementation), then None is returned.

impl VectorSum for e5m2

fn vector_sum(self) -> Self::Scalar

fn __expand_vector_sum( scope: &Scope, x: NativeExpand<Self>, ) -> NativeExpand<Self::Scalar>

impl Zero for e5m2

fn zero() -> e5m2

Returns the additive identity element of Self, 0.

fn is_zero(&self) -> bool

Returns true if self is equal to the additive identity.

fn set_zero(&mut self)

Sets self to the additive identity element of Self, 0.

impl Zeroable for e5m2

fn zeroed() -> Self

Calls zeroed.