Skip to main content

PTO-TILE-MODEL-ORDERING-SORTING

PTO-TILE-MODEL-ORDERING-SORTING

ASL pseudocode

The complete ASL owner is shown directly below.

// PTO-UNIT: {"id":"PTO-TILE-MODEL-ORDERING-SORTING","surface":"tile","classification":["model","ordering","sorting"],"depends_on":["PTO-TILE-MODEL-EXECUTION-COMPARISON"]}
pure func TileSortDataTypeSupported(    data_type: TileDataType) => booleanbegin    return data_type == TileDataType_FP32 ||           data_type == TileDataType_FP16;end;
pure func TileSortValueIsSignalingNaN(    data_type: TileDataType,    value: Word) => booleanbegin    return TileNumericValueClass(data_type, value) ==        NumericValue_SignalingNaN;end;
pure func TileSortLeftBefore(    left: Word,    right: Word,    descending: boolean,    data_type: TileDataType) => booleanbegin    let left_class = TileNumericValueClass(data_type, left);    let right_class = TileNumericValueClass(data_type, right);    let left_nan = NumericValueClassIsNaN(left_class);    let right_nan = NumericValueClassIsNaN(right_class);
    // Every numeric value precedes every quiet NaN in both directions.    // Two NaNs retain their incoming order.    if left_nan then        return right_nan;    elsif right_nan then        return TRUE;    end;
    let both_zero =        NumericValueClassIsZero(left_class) &&        NumericValueClassIsZero(right_class);    if both_zero || left == right then        return TRUE;    end;
    let left_key = TileFloatingOrderKey(data_type, left);    let right_key = TileFloatingOrderKey(data_type, right);    if descending then        return UInt(left_key) > UInt(right_key);    end;    return UInt(left_key) < UInt(right_key);end;
readonly func TileSortSourceValuesLegal(    source: TileIndex) => booleanbegin    return TileSourceContentsDefined(source) &&           TileSourceEncodingsValid(source);end;
readonly func TileSortSourceHasSignalingNaN(    source: TileIndex) => booleanbegin    let source_tile = _Tiles[[source]];    for row = 0 to source_tile.valid_rows - 1 looplimit 65536 do        for column = 0 to source_tile.valid_columns - 1 looplimit 65536 do            let element = TileLogicalLinearIndex(                source_tile,                row as integer {0..65535},                column as integer {0..65535});            if TileSortValueIsSignalingNaN(                   source_tile.data_type,                   TileReadLogicalElement(source_tile, element)) then                return TRUE;            end;        end;    end;    return FALSE;end;
readonly func TileSortSequenceOrdered(    source: TileIndex,    descending: boolean) => booleanbegin    let source_tile = _Tiles[[source]];    if source_tile.valid_columns <= 1 then        return TRUE;    end;
    for column = 0 to source_tile.valid_columns - 2 looplimit 65536 do        let left_element = TileLogicalLinearIndex(            source_tile,            0,            column as integer {0..65535});        let right_element = TileLogicalLinearIndex(            source_tile,            0,            (column + 1) as integer {0..65535});        if !TileSortLeftBefore(               TileReadLogicalElement(source_tile, left_element),               TileReadLogicalElement(source_tile, right_element),               descending,               source_tile.data_type) then            return FALSE;        end;    end;    return TRUE;end;

Architecture behavior

This internal model unit is documented through its normative ASL/NDF owners and validation evidence; it has no reader-guide migration target.

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

9 matching entries

Executable evidence2
  • PTO-TILE-MODEL-ORDERING-SORTING compiles as an independent normative unit
    1. surfaceTILE
    2. ownerPTO-TILE-MODEL-ORDERING-SORTING
    3. categorySTATIC-INVARIANT
    4. case001
    Show exact test source
    Sources and references
    Complete stable ID
    PTO-AVS-TILE-MODEL-ORDERING-SORTING-STATIC-001
    Path
    tests/asl/tile/model/ordering/sorting/tile-static-sorting-contract-001.asl
    Kind / role
    static-invariant
    Pass condition
    the complete model and this unit's static invariant compile
    SHA-256
    87772ee94c131c8ccbd60ea706ac042068589473ad6c65648878791518c3ee8b
    Open exact source ↗ for PTO-AVS-TILE-MODEL-ORDERING-SORTING-STATIC-001
  • Sorting compares signed zeros as equal and places numeric values before NaNs
    1. surfaceTILE
    2. ownerPTO-TILE-MODEL-ORDERING-SORTING
    3. categoryBOUNDARY
    4. case001
    Show exact test source
    Sources and references
    Complete stable ID
    PTO-AVS-TILE-SORT-ORDER-001
    Path
    tests/asl/tile/model/ordering/sorting/tile-bound-sort-order-001.asl
    Kind / role
    boundary
    Requirements
    PTO-INST-TILE-TSORT, PTO-INST-TILE-TMRGSORT
    Pass condition
    stable zero ties and numeric-before-NaN ordering hold in both directions
    SHA-256
    6afcd2bcb531544f993b32dc12e6b76cd7f8cb82bc551ee38a4ed1f09229ef96
    Open exact source ↗ for PTO-AVS-TILE-SORT-ORDER-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 history2
  • 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
  • Re-encode B.IOT and B.IOS size and PE mode fields · accepted
    1. decision recordADR
    2. case0096

    Decision record

    Loading ADR-0096…

    Sources and references
    Complete stable ID
    ADR-0096
    Path
    docs/status/decisions/0096-b-iot-b-ios-sizecode-pemode.md
    Affected units
    PTO-ARCH-DATA-TYPES-INTEGER, PTO-ARCH-FEATURES-TILE-ALLOCATION, PTO-ARCH-MEMORY-MODEL-GLOBAL-MEMORY-ACCESS, PTO-ARCH-PROFILE-RESET, PTO-ARCH-PROGRAMMING-MODEL-CORE-PE-TOPOLOGY, PTO-BLOCK-B-IOS, PTO-BLOCK-B-IOT, PTO-BLOCK-MODEL-DISPATCH-COMMANDS, PTO-BLOCK-MODEL-DISPATCH-CUBE-TMATMUL, PTO-BLOCK-MODEL-DISPATCH-DESTINATION-SHAPE, PTO-BLOCK-MODEL-DISPATCH-SHARED-CUBE-MATRIX, PTO-BLOCK-MODEL-DISPATCH-SHARED-TLSU, PTO-BLOCK-MODEL-OPERANDS-SHARED-BINDINGS, PTO-BLOCK-MODEL-OPERANDS-TILE-BINDINGS, PTO-BLOCK-MODEL-SCHEMA-PROFILE-ENCODING, PTO-BLOCK-MODEL-STATE-TYPES, PTO-TILE-MODEL-DEFINEDNESS-ELEMENTS, PTO-TILE-MODEL-DEFINEDNESS-PACKED-BOUNDARY, PTO-TILE-MODEL-EXECUTION-COMPARISON, PTO-TILE-MODEL-EXECUTION-COMPLEX, PTO-TILE-MODEL-EXECUTION-CUBE, PTO-TILE-MODEL-EXECUTION-ELEMENTWISE, PTO-TILE-MODEL-EXECUTION-EXPANSION, PTO-TILE-MODEL-EXECUTION-FUSED-MULTIPLY-ADD, PTO-TILE-MODEL-EXECUTION-GENERATION, PTO-TILE-MODEL-EXECUTION-IMAGE-TO-COLUMN, PTO-TILE-MODEL-EXECUTION-INDEXED-REARRANGEMENT, PTO-TILE-MODEL-EXECUTION-REARRANGEMENT, PTO-TILE-MODEL-EXECUTION-REDUCTION, PTO-TILE-MODEL-EXECUTION-SORTING, PTO-TILE-MODEL-EXECUTION-UNARY, PTO-TILE-MODEL-LEGALITY-ALLOCATION-CAPACITY, PTO-TILE-MODEL-LEGALITY-DESCRIPTOR-SHAPE, PTO-TILE-MODEL-LEGALITY-IMAGE-TO-COLUMN, PTO-TILE-MODEL-LEGALITY-INDEXED-REARRANGEMENT, PTO-TILE-MODEL-LEGALITY-MATRIX-INFO-DESCRIPTOR, PTO-TILE-MODEL-LEGALITY-MATRIX-POSTPROCESS, PTO-TILE-MODEL-LEGALITY-PE-MASK, PTO-TILE-MODEL-MEMORY-LOAD-STORE, PTO-TILE-MODEL-MEMORY-SHARED-MOVEMENT, PTO-TILE-MODEL-NUMERIC-FORMATS, PTO-TILE-MODEL-ORDERING-SORTING, PTO-TILE-MODEL-SHAPE-VALID-REGION, PTO-TILE-MODEL-STATE-ALLOCATION, PTO-TILE-MODEL-STATE-DESCRIPTORS, PTO-TILE-MODEL-STATE-FEATURE-MAP-DESCRIPTORS, PTO-TILE-MODEL-STATE-SHARED-REGISTERS, PTO-TILE-MODEL-STATE-TYPES, PTO-TILE-TLOAD
    Affected NDF
    PTO-ARCH-GM-ACCESS-001, PTO-B-IOS-SHARED-STATE-001, PTO-B-IOT-STREAM-001, PTO-CUBE-ACCUMULATOR-OUTPUT-001, PTO-TLOAD-CUBE-001, PTO-TLOAD-MEMORY-001
    SHA-256
    c4b4fb7bc17878f710015207dc19ddaf22a0cf6989d185b16844714c71e23f62
    Open exact decision source ↗ for ADR-0096

Unit metadata

Open 4 generated metadata fields
id
PTO-TILE-MODEL-ORDERING-SORTING
surface
tile
classification
[
  "model",
  "ordering",
  "sorting"
]
depends_on
[
  "PTO-TILE-MODEL-EXECUTION-COMPARISON"
]
Open generated traceability record
{
  "classification": [
    "model",
    "ordering",
    "sorting"
  ],
  "documentation": "docs/tile/model/ordering/sorting.md",
  "id": "PTO-TILE-MODEL-ORDERING-SORTING",
  "mnemonic": null,
  "readiness_subjects": [
    "ADR-0048",
    "ADR-0096"
  ],
  "semantic_tests": [
    "PTO-AVS-TILE-SORT-ORDER-001"
  ],
  "source": "asl/tile/model/ordering/sorting.asl",
  "surface": "tile",
  "tests": [
    "PTO-AVS-TILE-MODEL-ORDERING-SORTING-STATIC-001",
    "PTO-AVS-TILE-SORT-ORDER-001"
  ]
}

Sources and release identity

Show commit, paths, hashes, version, and canonical owners
Release
0.58.5 · Release candidate
Commit
7dc8b7e5b121d2b2499a2273bebff29e2cd86812
ASL SHA-256
c4286a8cda10cce0bebe7ff7cfe29a07d4564004b715c924818ef9881109e743
Generated documentation
docs/tile/model/ordering/sorting.md · embedded in this page
Documentation SHA-256
11833f1b83e6d395886e861a42e0277f2c073583ce3b8a9660e6543fe5a1d010

Exact owners