DESCRIBED-DENSE-TENSOR هو Value لتنسور يكتب shape وelement format في descriptor الخاص بـ Payload ثم يخزّن payload بترتيب C-contiguous row-major. Value VALUE-ISSUER-2WORD (0x09DL)، Issuer 0x00000002 ADHOC، رقم Codec 0x00000600، العائلة NUMERIC.
التخطيط
TAG WORD 0000 1001 1101 LLLL Codec 0x09DL
[Length TAG ممتد] عندما يكون الإجمالي 15 WORD فأكثر
Issuer 2 WORD 0x00000002 (ADHOC)
رقم 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]
Payload الباقي [dense payload]
التفسير
- rank قيمة من 4bit في descriptor، فلا يمثّل بنيويًا إلا
0..15. كل dimension هو uint32 غير سالب بترتيب big-endian. - كما في قاعدة tensor المنطقي في ONNX، فإن shape ذا rank صفر
[]هو scalar من عنصر واحد، وإذا كان أي dimension صفرًا فعدد العناصر صفر. وفيما عدا ذلك فعدد العناصر هو حاصل ضرب جميع الـ dimension. - يُقرأ payload وفق element format في descriptor وبترتيب C-contiguous row-major. يجب أن يساوي عدد العناصر المنطقي المحسوب عدد عناصر payload الذي يلي descriptor.
الصلاحية
- متى تحدّدت version وelement format المدعومتان، تُستعاد حدود payload بعرض العنصر ذاك، ويُتحقق من مطابقتها لحاصل ضرب shape المحسوب دون overflow.
- يجب أن يقع descriptor وكل dimension وpayload بالكامل داخل Length السجل، ولا يوجد ABI padding اعتباطي.
المرجع القياسي والمرتبة الشكلية
- القاعدة التي تجعل shape قائمة dimension غير سالبة وعدد القيم مساويًا لحاصل ضرب الـ dimension، ومعنى scalar ذي rank صفر وdimension الصفري، تتبع ONNX IR Tensor Definition. أما الترتيب المنطقي C-contiguous row-major فيوافق ترتيب Apache Arrow canonical fixed-shape tensor extension.
- rank بعرض 4bit وdimension من نوع uint32 وحقلا version/element-format وTAG/Length في GEUL وpayload من WORD بترتيب big-endian هي descriptor خاص بـ GEUL. وهي ليست serialization سلكية أو في الذاكرة لـ Arrow tensor IPC format أو ONNX TensorProto أو DLPack C API.
الطول
- الإجمالي هو عدد WORD في TAG بمقدار 1 WORD، وLength TAG ممتد (إن وُجد)، وIssuer 2 WORD، ورقم Codec 2 WORD، وPayload. ما كان 14 WORD فأقل يستخدم الطول المباشر، وما كان 15 WORD فأكثر يستخدم الطول الممتد
1110·1111، ويدخل Length TAG الممتد في العدد الكلي (السجل وTAG WORD). - descriptor هو 1 WORD، وshape هو
2 × rankWORD، والباقي هو payload.
مثال
- في profile ذي rank يساوي 2، تكون 4 WORD بعد descriptor هي dimensionين من نوع uint32، ثم كل ما بعدها payload بترتيب row-major. أما السماح الفعلي والتحقق من عدد العناصر فيتطلبان profile مؤكدًا لـ version وformat.
مسائل مفتوحة
- لم تُحدَّد بعدُ قيم سجل version وelement-format، ولا نطاق profile المدعوم من rank الممكن تمثيله
0..15.