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 — 4-битное значение descriptor, поэтому структурно выразимы только
0..15. Каждый dimension — неотрицательное big-endian uint32. - Как и в логических правилах tensor в 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-заполнения нет.
Стандартные основания и формальный статус
- Правило, по которому shape — список неотрицательных dimension, а число значений равно произведению dimension, а также смысл scalar с rank 0 и нулевого dimension следуют ONNX IR Tensor Definition. Логический порядок C-contiguous row-major согласован с порядком Apache Arrow canonical fixed-shape tensor extension.
- 4-битный rank, uint32 dimension, поля version/element-format, TAG/Length GEUL и payload в big-endian WORD — собственный descriptor GEUL. Это не wire- и не memory-сериализация Arrow tensor IPC format, ONNX TensorProto или DLPack C API.
Длина
- Общая длина — число WORD: TAG 1 WORD, расширяющий TAG Length (если есть), Issuer 2 WORD, номер Codec 2 WORD и Payload. До 14 WORD включительно используется прямая длина, от 15 WORD — расширенная длина
1110·1111; расширяющий TAG тоже входит в общее число (Запись и TAG WORD). - Descriptor занимает 1 WORD, shape —
2 × rankWORD, остальное — payload.
Пример
- В profile с rank 2 четыре WORD после descriptor — два uint32 dimension, а всё дальше — row-major payload. Для проверки допустимости и числа элементов нужен утверждённый profile version и format.
Открытые проблемы
- Значения registry для version и element-format, а также диапазон поддерживаемых profile среди выразимых rank
0..15пока не определены.