DESCRIBED-DENSE-TENSOR adalah Value tensor yang mencatat shape dan element format pada descriptor Payload, lalu menyimpan payload C-contiguous row-major. Value VALUE-ISSUER-2WORD(0x09DL), Issuer 0x00000002 ADHOC, nomor Codec 0x00000600, keluarga NUMERIC.

Layout

TAG WORD          0000 1001 1101 LLLL      Codec 0x09DL
[TAG ekstensi Length] jika total 15 WORD atau lebih
Issuer            2 WORD  0x00000002 (ADHOC)
Nomor Codec       2 WORD  0x00000600
Payload WORD 1st  [version: 4bit][element-format: 8bit][rank: 4bit]
Payload next      [dimension 1: uint32, 2 WORD] ... [dimension rank: uint32, 2 WORD]
Sisa Payload      [dense payload]

Interpretasi

  • Rank adalah nilai 4bit pada descriptor, sehingga secara struktural hanya 0..15 yang dapat dinyatakan. Setiap dimension adalah uint32 big-endian yang tidak negatif.
  • Seperti aturan tensor logis ONNX, shape [] dengan rank 0 adalah scalar dengan 1 elemen, dan jika salah satu dimension bernilai 0, jumlah elemennya 0. Selain itu, jumlah elemen adalah hasil kali semua dimension.
  • Payload dibaca dengan element format pada descriptor dan berurutan C-contiguous row-major. Jumlah elemen logis hasil perhitungan harus sama dengan jumlah elemen payload setelah descriptor.

Validitas

  • Setelah version dan element format yang didukung ditetapkan, batas payload dipulihkan dengan lebar elemennya, lalu dicocokkan dengan hasil kali shape yang dihitung tanpa overflow.
  • Descriptor, seluruh dimension, dan payload harus sepenuhnya berada di dalam Length record, dan tidak ada ABI padding sembarang.

Dasar standar dan status format

  • Aturan bahwa shape adalah daftar dimension tidak negatif dan jumlah nilai sama dengan hasil kali dimension, serta makna scalar rank 0 dan zero dimension, mengikuti ONNX IR Tensor Definition. Urutan logis C-contiguous row-major disesuaikan dengan urutan pada Apache Arrow canonical fixed-shape tensor extension.
  • Rank 4bit, dimension uint32, field version/element-format, TAG/Length GEUL, dan payload WORD big-endian merupakan descriptor khas GEUL. Ini bukan serialization wire atau memori dari Arrow tensor IPC format, ONNX TensorProto, maupun DLPack C API.

Panjang

  • Totalnya adalah jumlah WORD dari TAG 1 WORD, TAG ekstensi Length (jika ada), Issuer 2 WORD, nomor Codec 2 WORD, dan Payload. Panjang 14 WORD atau kurang memakai panjang langsung, sedangkan 15 WORD atau lebih memakai panjang ekstensi 1110·1111, dan TAG ekstensi masuk dalam total (Record dan TAG WORD).
  • Descriptor adalah 1 WORD, shape adalah 2 × rank WORD, dan sisanya adalah payload.

Contoh

  • Pada profil dengan rank 2, 4 WORD setelah descriptor adalah dua dimension uint32, dan seluruh bagian sesudahnya adalah payload row-major. Untuk memastikan apakah diizinkan dan memverifikasi jumlah elemen, diperlukan profil version dan format yang telah ditetapkan.

Masalah terbuka

  • Nilai registry version dan element-format, serta cakupan profil yang akan didukung dari rank 0..15 yang dapat dinyatakan, belum ditetapkan.