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..15yang 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 × rankWORD, 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..15yang dapat dinyatakan, belum ditetapkan.