DENSE-U16-VECTOR is a homogeneous 1-dimensional Value that stores big-endian uint16 elements back to back without a descriptor.
Layout
- Code: Value
VALUE-ISSUER-2WORD(0x09DL), Issuer0x00000002ADHOC, codec number0x00000501. Family NUMERIC.
TAG WORD 0000 1001 1101 LLLL Codec 0x09DL
[Length ext. TAG] when the total is 15 WORD or more
Issuer 2 WORD 0x00000002 (ADHOC)
Codec number 2 WORD 0x00000501
Payload: [uint16 1st: 1 WORD] ... [uint16 Nth: 1 WORD]
Interpretation rules
- Each WORD is read as an independent unsigned 16-bit integer. The number of elements is the number of Payload WORD.
- There is no ABI padding between elements or at the end.
Validity
- The Payload must be at least 1 WORD. This format has no descriptor and does not allow an empty vector.
- The Payload size must be an integer multiple of the element width of 1 WORD.
Standards basis and formal status
- The unsigned interpretation and the 16-bit width of the unsigned integer dtype follow the industry dtypes of the tensor element type of the ONNX IR and DLPack
DLDataType. - The descriptor-less 1-dimensional contiguous run and the placement in GEUL TAG/Length and big-endian WORD are specific to GEUL. DLPack assumes the dtype is native-endian, so this Payload is not the wire serialization of DLPack or ONNX.
Length
- The total is the number of WORD obtained by adding TAG 1 WORD, the Length extension TAG (if present), Issuer 2 WORD, codec number 2 WORD, and the Payload. 14 WORD or fewer use the direct length, and 15 WORD or more use the
1110or1111extended length, and the extension TAG is included in the total (Length).
Example
- The Payload
0000 FFFFis the elements[0, 65535], and the record is 7 WORD in total with the direct lengthLLLL=0110.