DESCRIBED-DENSE-TENSOR é um Value de tensor que registra o shape e o element format no descriptor do Payload e armazena um payload C-contiguous row-major. Value VALUE-ISSUER-2WORD (0x09DL), Issuer 0x00000002 ADHOC, número do Codec 0x00000600, família NUMERIC.
Layout
TAG WORD 0000 1001 1101 LLLL Codec 0x09DL
[TAG estendida de Length] quando o total for de 15 WORD ou mais
Issuer 2 WORD 0x00000002 (ADHOC)
Número do 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]
Resto do Payload [dense payload]
Interpretação
- O rank é um valor de 4 bits do descriptor; portanto, estruturalmente só se expressa
0..15. Cada dimension é um uint32 big-endian não negativo. - Como na regra de tensor lógico do ONNX, o shape
[]de rank 0 é um scalar de 1 elemento, e se qualquer dimension for 0, o número de elementos é 0. Nos demais casos, o número de elementos é o produto de todas as dimensions. - O payload é lido com o element format do descriptor, na ordem C-contiguous row-major. O número lógico de elementos calculado deve ser igual ao número de elementos do payload após o descriptor.
Validade
- Uma vez fixados a version e o element format suportados, recupera-se o limite do payload com a largura desse elemento e verifica-se se coincide com o produto do shape, calculado sem overflow.
- O descriptor, todas as dimensions e o payload devem caber por inteiro no Length do registro, e não há ABI padding arbitrário.
Base normativa e estatuto formal
- A regra de que o shape é uma lista de dimensions não negativas e de que o número de valores é igual ao produto das dimensions, bem como o sentido do scalar de rank 0 e da dimension zero, seguem a ONNX IR Tensor Definition. A ordem lógica C-contiguous row-major coincide com a da Apache Arrow canonical fixed-shape tensor extension.
- O rank de 4 bits, a dimension uint32, os campos version/element-format, a TAG/Length do GEUL e o payload em WORD big-endian são um descriptor próprio do GEUL. Não são a serialização de wire ou de memória do Arrow tensor IPC format, do ONNX TensorProto nem da DLPack C API.
Comprimento
- O total é o número de WORD somando TAG 1 WORD, a TAG estendida de Length (se houver), Issuer 2 WORD, número do Codec 2 WORD e o Payload. Até 14 WORD usa-se o comprimento direto; a partir de 15 WORD usa-se o comprimento estendido
1110·1111, e a TAG estendida também entra no total (Registro e TAG WORD). - O descriptor ocupa 1 WORD, o shape ocupa
2 × rankWORD e o restante é o payload.
Exemplo
- Num profile de rank 2, os 4 WORD após o descriptor são as duas dimensions uint32, e tudo o que vem depois é o payload row-major. Para saber se é permitido de fato e para verificar o número de elementos, é necessário um profile de version e format já estabelecido.
Problemas em aberto
- Os valores do registry de version e element-format, e a faixa de profiles a suportar dentro do rank representável
0..15, ainda não foram definidos.