Skip to main content

PTO-ARCH-DATA-TYPES-FORMAT-E3M2

PTO-ARCH-DATA-TYPES-FORMAT-E3M2

ASL pseudocode

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

// PTO-REQ-HARDWARE-NUMERIC-001: exact zero-extended E3M2 values.
pure func E3M2NumericFormatDescriptor() => NumericFormatDescriptorbegin    return NumericFormatDescriptor {        available = TRUE, kind = NumericFormatKind_FixedBinary,        carrier_bits = 8, lane_bits = 6, lanes_per_carrier = 1,        sign_bits = 1, sign_bit = 5,        exponent_bits_min = 3, exponent_bits_max = 3,        fraction_bits_min = 2, fraction_bits_max = 2,        exponent_bias_available = TRUE, exponent_bias = 3,        required_low_zero_bits = 0, required_high_zero_bits = 2,        has_zero = TRUE, has_signed_zero = TRUE, has_subnormal = TRUE,        has_infinity = FALSE, has_quiet_nan = FALSE,        has_signaling_nan = FALSE    };end;
pure func E3M2FiniteDecomposition(value: bits(8))    => (boolean, boolean, Word, integer {-1074..1023})begin    if value[7:6] != Zeros{2} then        return (FALSE, FALSE, Zeros{PTO_XLEN}, 0);    end;    let exponent = value[4:2];    let fraction = value[1:0];    if exponent == Zeros{3} then        if fraction == Zeros{2} then            return (TRUE, value[5] == '1', Zeros{PTO_XLEN}, 0);        else return (TRUE, value[5] == '1',                     ZeroExtend{PTO_XLEN}(fraction), -4);        end;    else return (TRUE, value[5] == '1',                 LSL(Zeros{PTO_XLEN} + 1, 2) +                     ZeroExtend{PTO_XLEN}(fraction),                 (UInt(exponent) - (3 + 2))                     as integer {-1074..1023});    end;end;
pure func E3M2EncodingValid(value: bits(8)) => booleanbegin    return value[7:6] == Zeros{2};end;pure func ClassifyE3M2(value: bits(8)) => NumericValueClassbegin    let exponent = value[4:2];    let fraction = value[1:0];    return NumericValueClassFromFiniteSign(value[5],        exponent == Zeros{3} && fraction == Zeros{2},        exponent == Zeros{3} && fraction != Zeros{2});end;
pure func E3M2SignedZeroEncodings() => (Word, Word)begin    return (Zeros{PTO_XLEN}, Zeros{PTO_XLEN} + 0x20);end;
View the complete ASL owner
// PTO-UNIT: {"id":"PTO-ARCH-DATA-TYPES-FORMAT-E3M2","surface":"arch","classification":["data-types","formats","e3m2"],"depends_on":["PTO-ARCH-DATA-TYPES-FORMAT-DESCRIPTOR"]}// DOC-BEGIN: operation// PTO-REQ-HARDWARE-NUMERIC-001: exact zero-extended E3M2 values.
pure func E3M2NumericFormatDescriptor() => NumericFormatDescriptorbegin    return NumericFormatDescriptor {        available = TRUE, kind = NumericFormatKind_FixedBinary,        carrier_bits = 8, lane_bits = 6, lanes_per_carrier = 1,        sign_bits = 1, sign_bit = 5,        exponent_bits_min = 3, exponent_bits_max = 3,        fraction_bits_min = 2, fraction_bits_max = 2,        exponent_bias_available = TRUE, exponent_bias = 3,        required_low_zero_bits = 0, required_high_zero_bits = 2,        has_zero = TRUE, has_signed_zero = TRUE, has_subnormal = TRUE,        has_infinity = FALSE, has_quiet_nan = FALSE,        has_signaling_nan = FALSE    };end;
pure func E3M2FiniteDecomposition(value: bits(8))    => (boolean, boolean, Word, integer {-1074..1023})begin    if value[7:6] != Zeros{2} then        return (FALSE, FALSE, Zeros{PTO_XLEN}, 0);    end;    let exponent = value[4:2];    let fraction = value[1:0];    if exponent == Zeros{3} then        if fraction == Zeros{2} then            return (TRUE, value[5] == '1', Zeros{PTO_XLEN}, 0);        else return (TRUE, value[5] == '1',                     ZeroExtend{PTO_XLEN}(fraction), -4);        end;    else return (TRUE, value[5] == '1',                 LSL(Zeros{PTO_XLEN} + 1, 2) +                     ZeroExtend{PTO_XLEN}(fraction),                 (UInt(exponent) - (3 + 2))                     as integer {-1074..1023});    end;end;
pure func E3M2EncodingValid(value: bits(8)) => booleanbegin    return value[7:6] == Zeros{2};end;pure func ClassifyE3M2(value: bits(8)) => NumericValueClassbegin    let exponent = value[4:2];    let fraction = value[1:0];    return NumericValueClassFromFiniteSign(value[5],        exponent == Zeros{3} && fraction == Zeros{2},        exponent == Zeros{3} && fraction != Zeros{2});end;
pure func E3M2SignedZeroEncodings() => (Word, Word)begin    return (Zeros{PTO_XLEN}, Zeros{PTO_XLEN} + 0x20);end;// DOC-END: operation

Architecture behavior

purpose scope

Purpose and scope

E3M2 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 E3M2NumericFormatDescriptor, E3M2FiniteDecomposition, and ClassifyE3M2 in the ASL owner.

concepts state

Carrier and fields

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

Bits 7:6 of the eight-bit carrier must be zero; the six-bit value occupies bits 5:0.

rules interactions

Decomposition and classification

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

It has signed zero and subnormals, but no infinity or NaN class. A carrier with either constrained high bit set is rejected by the encoding-validity and finite-decomposition functions.

boundaries

Boundaries and exact encodings

Encodings 0x00 and 0x20 are positive and negative zero.

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 -4; 0x80 is not a valid E3M2 encoding because bit 7 is set.

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-E3M2 compiles as an independent normative unit
    1. surfaceARCH
    2. ownerPTO-ARCH-DATA-TYPES-FORMAT-E3M2
    3. categorySTATIC-INVARIANT
    4. case001
    Show exact test source
    Sources and references
    Complete stable ID
    PTO-AVS-ARCH-DATA-TYPES-FORMAT-E3M2-STATIC-001
    Path
    tests/asl/arch/data-types/formats/e3m2/arch-static-e3m2-contract-001.asl
    Kind / role
    static-invariant
    Pass condition
    the complete model and this unit's static invariant compile
    SHA-256
    e0335ef6c5baf96ec5fb0961ce961d7b553315fa36358067589aa711e86c1bda
    Open exact source ↗ for PTO-AVS-ARCH-DATA-TYPES-FORMAT-E3M2-STATIC-001
  • E3M2 exposes its exact descriptor and finite-value decomposition.
    1. surfaceARCH
    2. ownerPTO-ARCH-DATA-TYPES-FORMAT-E3M2
    3. categoryBOUNDARY
    4. case001
    Show exact test source
    Sources and references
    Complete stable ID
    PTO-AVS-ARCH-E3M2-DECOMP-001
    Path
    tests/asl/arch/data-types/formats/e3m2/arch-bound-e3m2-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
    e942008d7104703a8ee6e304e04dcca247d221b2a2a5f536a86cbcbb1bef2b93
    Open exact source ↗ for PTO-AVS-ARCH-E3M2-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-E3M2
surface
arch
classification
[
  "data-types",
  "formats",
  "e3m2"
]
depends_on
[
  "PTO-ARCH-DATA-TYPES-FORMAT-DESCRIPTOR"
]
Open generated traceability record
{
  "classification": [
    "data-types",
    "formats",
    "e3m2"
  ],
  "documentation": "docs/arch/data-types/formats/e3m2.md",
  "id": "PTO-ARCH-DATA-TYPES-FORMAT-E3M2",
  "mnemonic": null,
  "readiness_subjects": [
    "ADR-0048"
  ],
  "semantic_tests": [
    "PTO-AVS-ARCH-E3M2-DECOMP-001"
  ],
  "source": "asl/arch/data-types/formats/e3m2.asl",
  "surface": "arch",
  "tests": [
    "PTO-AVS-ARCH-DATA-TYPES-FORMAT-E3M2-STATIC-001",
    "PTO-AVS-ARCH-E3M2-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
7bfe85b0c248ee27de72f0dd20adee81e6378a26231e456ec2bcc6e55536e39d
Generated documentation
docs/arch/data-types/formats/e3m2.md · embedded in this page
Documentation SHA-256
038531b8ecb382ef2aad78b8802c46b7af9132ee8673d13c4078957a22a1b594

Exact owners