DESCRIBED-DENSE-TENSOR는 shape와 element format을 Payload descriptor에 적고 C-contiguous row-major payload를 저장하는 텐서 Value다. Value VALUE-ISSUER-2WORD(0x09DL), Issuer 0x00000002 ADHOC, 코덱 번호 0x00000600, 계열 NUMERIC이다.
레이아웃
TAG WORD 0000 1001 1101 LLLL Codec 0x09DL
[Length 확장 TAG] 전체 15 WORD 이상일 때
Issuer 2 WORD 0x00000002 (ADHOC)
코덱 번호 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는 descriptor의 4bit 값이므로 구조적으로
0..15만 표현한다. 각 dimension은 음이 아닌 big-endian uint32다. - ONNX의 논리 tensor 규칙처럼 rank 0 shape
[]는 원소 1개의 scalar이고, dimension 중 하나라도 0이면 원소 수는 0이다. 그 밖의 원소 수는 모든 dimension의 곱이다. - payload는 descriptor의 element format으로 읽으며 C-contiguous row-major 순서다. 계산한 논리 원소 수는 descriptor 뒤 payload의 원소 수와 같아야 한다.
유효성
- 지원하는 version과 element format이 정해지면 그 원소 폭으로 payload 경계를 복구하고, overflow 없이 계산한 shape 곱과 맞는지 검증한다.
- descriptor, 모든 dimension, payload는 레코드 Length 안에 완전히 들어가야 하며 임의 ABI padding은 없다.
표준 근거와 형식 지위
- shape가 음이 아닌 dimension 목록이고 값 수가 dimension 곱과 같다는 규칙, rank 0 scalar와 zero dimension의 뜻은 ONNX IR Tensor Definition을 따른다. C-contiguous row-major 논리 순서는 Apache Arrow canonical fixed-shape tensor extension의 순서와 맞춘다.
- 4bit rank, uint32 dimension, version/element-format field, GEUL TAG/Length, big-endian WORD payload는 GEUL 고유 descriptor다. Arrow tensor IPC format, ONNX TensorProto, DLPack C API의 wire·memory serialization이 아니다.
길이
- 전체는 TAG 1 WORD, Length 확장 TAG(있으면), Issuer 2 WORD, 코덱 번호 2 WORD, Payload를 합한 WORD 수다. 14 WORD 이하는 직접 길이, 15 WORD 이상은
1110·1111확장 길이를 쓰며 확장 TAG도 전체 수에 들어간다(레코드와 TAG WORD). - descriptor는 1 WORD, shape는
2 × rankWORD이며 나머지가 payload다.
예시
- rank가 2인 profile이라면 descriptor 뒤 4 WORD가 두 uint32 dimension이고, 그 뒤 전체가 row-major payload다. 실제 허용 여부와 원소 수 검증에는 확정된 version·format profile이 필요하다.
열린 문제
- version과 element-format registry의 값, 그리고 표현 가능한 rank
0..15중 지원할 profile 범위는 아직 정하지 않았다.