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
[TAG הרחבת Length] כאשר הסך הכול 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 שאינו שלילי.
  • כמו בכללי הטנזור הלוגיים של ONNX, shape ‏[] ב-rank 0 הוא scalar בעל איבר אחד, ואם אחד מה-dimension הוא 0, מספר האיברים הוא 0. בשאר המקרים מספר האיברים הוא מכפלת כל ה-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 0 ושל zero dimension, הם לפי ONNX IR Tensor Definition. הסדר הלוגי C-contiguous row-major מותאם לסדר של Apache Arrow canonical fixed-shape tensor extension.
  • rank של 4bit, dimension מסוג uint32, שדות version/element-format, GEUL TAG/Length ו-payload של WORD big-endian הם descriptor ייחודי של GEUL. הם אינם ה-serialization של wire או של זיכרון ב-Arrow tensor IPC format, ב-ONNX TensorProto או ב-DLPack C API.

אורך

  • הסך הכול הוא מספר ה-WORD של TAG אחד, TAG הרחבת Length (אם יש), Issuer של 2 WORD, מספר Codec של 2 WORD ו-Payload. עד 14 WORD משתמשים באורך ישיר, ומ-15 WORD ומעלה באורך מורחב 1110·1111, וה-TAG המורחב נכלל בסך הכול (רשומה ו-TAG WORD).
  • ה-descriptor הוא WORD אחד, ה-shape הוא 2 × rank WORD, והשאר הוא ה-payload.

דוגמה

  • בפרופיל שבו rank הוא 2, 4 ה-WORD שאחרי ה-descriptor הם שני dimension מסוג uint32, וכל מה שאחריהם הוא ה-payload ב-row-major. כדי לקבוע אם זה מותר בפועל ולאמת את מספר האיברים נדרש פרופיל version ו-format מוסכם.

בעיות פתוחות

  • הערכים ברישום (registry) של version ו-element-format, וטווח הפרופילים שייתמכו מתוך ה-rank הניתן לייצוג 0..15, טרם נקבעו.