Skip to main content

PTO-ARCH-DATA-TYPES-FORMAT-E4M3

PTO-ARCH-DATA-TYPES-FORMAT-E4M3

ASL pseudocode

This Operation comes directly from the instruction owner; the page does not rewrite its behavior.

// PTO-REQ-HARDWARE-NUMERIC-001: exact E4M3 encoding and finite values.
pure func E4M3NumericFormatDescriptor() => NumericFormatDescriptorbegin    return NumericFormatDescriptor {        available = TRUE, kind = NumericFormatKind_FixedBinary,        carrier_bits = 8, lane_bits = 8, lanes_per_carrier = 1,        sign_bits = 1, sign_bit = 7,        exponent_bits_min = 4, exponent_bits_max = 4,        fraction_bits_min = 3, fraction_bits_max = 3,        exponent_bias_available = TRUE, exponent_bias = 7,        required_low_zero_bits = 0, required_high_zero_bits = 0,        has_zero = TRUE, has_signed_zero = TRUE, has_subnormal = TRUE,        has_infinity = FALSE, has_quiet_nan = TRUE,        has_signaling_nan = FALSE    };end;
pure func E4M3FiniteDecomposition(value: bits(8))    => (boolean, boolean, Word, integer {-1074..1023})begin    let exponent = value[6:3];    let fraction = value[2:0];    if exponent == Ones{4} && fraction == Ones{3} then        return (FALSE, FALSE, Zeros{PTO_XLEN}, 0);    elsif exponent == Zeros{4} then        if fraction == Zeros{3} then            return (TRUE, value[7] == '1', Zeros{PTO_XLEN}, 0);        else return (TRUE, value[7] == '1',                     ZeroExtend{PTO_XLEN}(fraction), -9);        end;    else return (TRUE, value[7] == '1',                 LSL(Zeros{PTO_XLEN} + 1, 3) +                     ZeroExtend{PTO_XLEN}(fraction),                 (UInt(exponent) - (7 + 3))                     as integer {-1074..1023});    end;end;pure func ClassifyE4M3(value: bits(8)) => NumericValueClassbegin    let exponent = value[6:3];    let fraction = value[2:0];    if exponent == Ones{4} && fraction == Ones{3} then        return NumericValue_QuietNaN;    end;    return NumericValueClassFromFiniteSign(value[7],        exponent == Zeros{4} && fraction == Zeros{3},        exponent == Zeros{4} && fraction != Zeros{3});end;
pure func E4M3CanonicalNaN() => Wordbegin    return Zeros{PTO_XLEN} + 0x7f;end;
pure func E4M3SignedZeroEncodings() => (Word, Word)begin    return (Zeros{PTO_XLEN}, Zeros{PTO_XLEN} + 0x80);end;
View the complete ASL owner
// PTO-UNIT: {"id":"PTO-ARCH-DATA-TYPES-FORMAT-E4M3","surface":"arch","classification":["data-types","formats","e4m3"],"depends_on":["PTO-ARCH-DATA-TYPES-FORMAT-DESCRIPTOR"]}// DOC-BEGIN: operation// PTO-REQ-HARDWARE-NUMERIC-001: exact E4M3 encoding and finite values.
pure func E4M3NumericFormatDescriptor() => NumericFormatDescriptorbegin    return NumericFormatDescriptor {        available = TRUE, kind = NumericFormatKind_FixedBinary,        carrier_bits = 8, lane_bits = 8, lanes_per_carrier = 1,        sign_bits = 1, sign_bit = 7,        exponent_bits_min = 4, exponent_bits_max = 4,        fraction_bits_min = 3, fraction_bits_max = 3,        exponent_bias_available = TRUE, exponent_bias = 7,        required_low_zero_bits = 0, required_high_zero_bits = 0,        has_zero = TRUE, has_signed_zero = TRUE, has_subnormal = TRUE,        has_infinity = FALSE, has_quiet_nan = TRUE,        has_signaling_nan = FALSE    };end;
pure func E4M3FiniteDecomposition(value: bits(8))    => (boolean, boolean, Word, integer {-1074..1023})begin    let exponent = value[6:3];    let fraction = value[2:0];    if exponent == Ones{4} && fraction == Ones{3} then        return (FALSE, FALSE, Zeros{PTO_XLEN}, 0);    elsif exponent == Zeros{4} then        if fraction == Zeros{3} then            return (TRUE, value[7] == '1', Zeros{PTO_XLEN}, 0);        else return (TRUE, value[7] == '1',                     ZeroExtend{PTO_XLEN}(fraction), -9);        end;    else return (TRUE, value[7] == '1',                 LSL(Zeros{PTO_XLEN} + 1, 3) +                     ZeroExtend{PTO_XLEN}(fraction),                 (UInt(exponent) - (7 + 3))                     as integer {-1074..1023});    end;end;pure func ClassifyE4M3(value: bits(8)) => NumericValueClassbegin    let exponent = value[6:3];    let fraction = value[2:0];    if exponent == Ones{4} && fraction == Ones{3} then        return NumericValue_QuietNaN;    end;    return NumericValueClassFromFiniteSign(value[7],        exponent == Zeros{4} && fraction == Zeros{3},        exponent == Zeros{4} && fraction != Zeros{3});end;
pure func E4M3CanonicalNaN() => Wordbegin    return Zeros{PTO_XLEN} + 0x7f;end;
pure func E4M3SignedZeroEncodings() => (Word, Word)begin    return (Zeros{PTO_XLEN}, Zeros{PTO_XLEN} + 0x80);end;// DOC-END: operation

Architecture behavior

purpose scope

Purpose and scope

E4M3 is an assigned PTO numeric format. This page helps a reader connect its carrier layout, finite-value decomposition, and value classification; the exact contract remains in E4M3NumericFormatDescriptor, E4M3FiniteDecomposition, and ClassifyE4M3 in the ASL owner.

concepts state

Carrier and fields

The descriptor uses a 8-bit carrier, a 8-bit logical lane, and 1 lane(s) per carrier. The lane has one sign bit at position 7, 4 exponent bit(s), 3 fraction bit(s), and exponent bias 7.

No carrier bits are constrained outside the sign, exponent, and fraction fields.

rules interactions

Decomposition and classification

E4M3FiniteDecomposition reports whether a finite decomposition is available and, when available, returns the sign, an integer significand, and a binary exponent. ClassifyE4M3 separately assigns the raw lane to zero, subnormal, normal, infinity, or NaN classes supported by this format.

It has signed zero, subnormals, and a quiet-NaN class, but no infinity or signaling-NaN class. Only an all-one exponent together with an all-one fraction is non-finite.

boundaries

Boundaries and exact encodings

0x00 and 0x80 are positive and negative zero; 0x7f is the canonical quiet NaN.

The finite-decomposition function reports availability with its returned tuple; value classification is a separate function result.

example usage

illustrative reading example

This example illustrates how to read the functions; it does not add an encoding rule.

For example, 0x01 decomposes to positive significand 1 with exponent -9, while 0x7f is a quiet NaN and has no finite decomposition.

NDF clauses

Bodies come from owning ASL. Dragging or buttons change only this page-session view order.

No NDF clause is attached to this unit.

Evidence index

8 matching entries

Executable evidence2
  • PTO-ARCH-DATA-TYPES-FORMAT-E4M3 compiles as an independent normative unit
    1. surfaceARCH
    2. ownerPTO-ARCH-DATA-TYPES-FORMAT-E4M3
    3. categorySTATIC-INVARIANT
    4. case001
    Show exact test source
    Sources and references
    Complete stable ID
    PTO-AVS-ARCH-DATA-TYPES-FORMAT-E4M3-STATIC-001
    Path
    tests/asl/arch/data-types/formats/e4m3/arch-static-e4m3-contract-001.asl
    Kind / role
    static-invariant
    Pass condition
    the complete model and this unit's static invariant compile
    SHA-256
    ebb232f912ad649cece4a3f1736da5134d0d85a7ecc55ac9b2cb6a860aab62fa
    Open exact source ↗ for PTO-AVS-ARCH-DATA-TYPES-FORMAT-E4M3-STATIC-001
  • E4M3 exposes its exact descriptor and finite-value decomposition.
    1. surfaceARCH
    2. ownerPTO-ARCH-DATA-TYPES-FORMAT-E4M3
    3. categoryBOUNDARY
    4. case001
    Show exact test source
    Sources and references
    Complete stable ID
    PTO-AVS-ARCH-E4M3-DECOMP-001
    Path
    tests/asl/arch/data-types/formats/e4m3/arch-bound-e4m3-decomp-001.asl
    Kind / role
    boundary
    Requirements
    PTO-NUMERIC-FINITE-DECOMPOSITION-001
    Pass condition
    Field metadata, finite boundaries, unavailable special values, and existing value-class rules agree.
    SHA-256
    fefdb43f96bc09e0d33caeb9f35974ceafbfe71e8a3cf973c11991e0675e9a12
    Open exact source ↗ for PTO-AVS-ARCH-E4M3-DECOMP-001
Commit-scoped evidence5
  • spec/evidence/release-traceability-readiness.json · closedPTO-EVIDENCE-RELEASE-TRACEABILITY
    Sources and references
    Complete stable ID
    PTO-EVIDENCE-RELEASE-TRACEABILITY
    Path
    spec/evidence/release-traceability-readiness.json
    Kind / role
    ASL/NDF/documentation/AVS traceability
    SHA-256
    c7327021d39dc67ac5564bc55073b3870a397d79ac8d9648284d56e33bc14a3e
    Open exact source ↗ for PTO-EVIDENCE-RELEASE-TRACEABILITY
  • spec/evidence/instruction-contract-closure.json · closedPTO-EVIDENCE-INSTRUCTION-CONTRACT-CLOSURE
    Sources and references
    Complete stable ID
    PTO-EVIDENCE-INSTRUCTION-CONTRACT-CLOSURE
    Path
    spec/evidence/instruction-contract-closure.json
    Kind / role
    mnemonic and encoding contract closure
    SHA-256
    3ef2bb62421c79dff8fa77a1c7983923b523244b8090812883ef81286ca8106a
    Open exact source ↗ for PTO-EVIDENCE-INSTRUCTION-CONTRACT-CLOSURE
  • spec/evidence/architecture-readiness.json · openPTO-EVIDENCE-ARCHITECTURE-READINESS
    Sources and references
    Complete stable ID
    PTO-EVIDENCE-ARCHITECTURE-READINESS
    Path
    spec/evidence/architecture-readiness.json
    Kind / role
    architecture maturity and blockers
    SHA-256
    4b0b85199101251bea744e0f3591cc31906909dc80d5ab651c417a936036a004
    Open exact source ↗ for PTO-EVIDENCE-ARCHITECTURE-READINESS
  • spec/evidence/release-gate-readiness.json · ready-for-exact-head-verificationPTO-EVIDENCE-RELEASE-GATE-READINESS
    Sources and references
    Complete stable ID
    PTO-EVIDENCE-RELEASE-GATE-READINESS
    Path
    spec/evidence/release-gate-readiness.json
    Kind / role
    exact-head gate readiness
    SHA-256
    a0f4d2b6920c08981ea55fd8ef820708a40d4feb5402c5150e8e9ab532d84ce0
    Open exact source ↗ for PTO-EVIDENCE-RELEASE-GATE-READINESS
  • spec/release-manifest.json · draftPTO-EVIDENCE-RELEASE-MANIFEST
    Sources and references
    Complete stable ID
    PTO-EVIDENCE-RELEASE-MANIFEST
    Path
    spec/release-manifest.json
    Kind / role
    release content and encoding fingerprints
    SHA-256
    1a64c109ed7a90351c41e2a418b3c0ebaf8ad975838986d2101385186b85c0d8
    Open exact source ↗ for PTO-EVIDENCE-RELEASE-MANIFEST
Decision history1
  • Numeric format value classification · accepted
    1. decision recordADR
    2. case0048

    Decision record

    Loading ADR-0048…

    Sources and references
    Complete stable ID
    ADR-0048
    Path
    docs/status/decisions/0048-numeric-format-value-classification.md
    Affected units
    PTO-ARCH-DATA-TYPES-FORMAT-BF16, PTO-ARCH-DATA-TYPES-FORMAT-DESCRIPTOR, PTO-ARCH-DATA-TYPES-FORMAT-E1M2X2, PTO-ARCH-DATA-TYPES-FORMAT-E2M1X2, PTO-ARCH-DATA-TYPES-FORMAT-E2M3, PTO-ARCH-DATA-TYPES-FORMAT-E3M2, PTO-ARCH-DATA-TYPES-FORMAT-E4M3, PTO-ARCH-DATA-TYPES-FORMAT-E5M2, PTO-ARCH-DATA-TYPES-FORMAT-E8M0, PTO-ARCH-DATA-TYPES-FORMAT-FP16, PTO-ARCH-DATA-TYPES-FORMAT-FP32, PTO-ARCH-DATA-TYPES-FORMAT-FP64, PTO-ARCH-DATA-TYPES-FORMAT-HF32, PTO-ARCH-DATA-TYPES-FORMAT-HIF4X2, PTO-ARCH-DATA-TYPES-FORMAT-HIF8, PTO-ARCH-DATA-TYPES-FORMAT-TF32, PTO-ARCH-DATA-TYPES-NUMERIC-CLASSIFICATION, PTO-ARCH-DATA-TYPES-NUMERIC-FORMATS, PTO-SCALAR-FMAX, PTO-SCALAR-FMIN, PTO-SCALAR-MODEL-FSU-PROFILE, PTO-TILE-MODEL-EXECUTION-COMPARISON, PTO-TILE-MODEL-EXECUTION-FUSED-MULTIPLY-ADD, PTO-TILE-MODEL-EXECUTION-UNARY, PTO-TILE-MODEL-NUMERIC-FORMATS, PTO-TILE-MODEL-ORDERING-SORTING, PTO-TILE-TMAX, PTO-TILE-TMIN
    Affected NDF
    PTO-FMAX-DECISION-BINDING-001, PTO-FMIN-DECISION-BINDING-001, PTO-NUMERIC-FINITE-DECOMPOSITION-001, PTO-NUMERIC-FORMAT-DESCRIPTOR-001, PTO-TMAX-CONTRACT-001, PTO-TMIN-CONTRACT-001
    SHA-256
    ce3ecd1851e22b5517d07076ab8bd2db36b6b4582111c761db19240275853d9c
    Open exact decision source ↗ for ADR-0048

Unit metadata

Open 4 generated metadata fields
id
PTO-ARCH-DATA-TYPES-FORMAT-E4M3
surface
arch
classification
[
  "data-types",
  "formats",
  "e4m3"
]
depends_on
[
  "PTO-ARCH-DATA-TYPES-FORMAT-DESCRIPTOR"
]
Open generated traceability record
{
  "classification": [
    "data-types",
    "formats",
    "e4m3"
  ],
  "documentation": "docs/arch/data-types/formats/e4m3.md",
  "id": "PTO-ARCH-DATA-TYPES-FORMAT-E4M3",
  "mnemonic": null,
  "readiness_subjects": [
    "ADR-0048"
  ],
  "semantic_tests": [
    "PTO-AVS-ARCH-E4M3-DECOMP-001"
  ],
  "source": "asl/arch/data-types/formats/e4m3.asl",
  "surface": "arch",
  "tests": [
    "PTO-AVS-ARCH-DATA-TYPES-FORMAT-E4M3-STATIC-001",
    "PTO-AVS-ARCH-E4M3-DECOMP-001"
  ]
}

Sources and release identity

Show commit, paths, hashes, version, and canonical owners
Release
0.58.5 · Release candidate
Commit
7dc8b7e5b121d2b2499a2273bebff29e2cd86812
ASL SHA-256
ecbcef1094effdcdb279975c91cbe338371bea28a749d294fc118401d2aec836
Generated documentation
docs/arch/data-types/formats/e4m3.md · embedded in this page
Documentation SHA-256
ad17df55adb842dc8d4347cba3334d64be84b7482db4ffeae43842aeae03ec5b

Exact owners