DENSE-I32-VECTOR is a homogeneous 1-dimensional Value that stores big-endian int32 elements back to back without a descriptor.
Layout
- Code: Value
VALUE-ISSUER-2WORD(0x09DL), Issuer0x00000002ADHOC, codec number0x00000502. 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 0x00000502
Payload: [int32 1st: 2 WORD] ... [int32 Nth: 2 WORD]
Interpretation rules
- Each run of 2 consecutive WORD is combined from the most significant WORD first and read as a 32-bit two’s complement integer.
- The number of elements is 1/2 of the number of Payload WORD, and there is no ABI padding.
Validity
- The Payload must be at least 2 WORD and an integer multiple of 2 WORD. This format has no descriptor and does not allow an empty vector.
Standards basis and formal status
- The signedness and the 32-bit width of the signed integer dtype follow the industry dtypes of the tensor element type of the ONNX IR and DLPack
DLDataType. - The two’s complement interpretation, 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
FFFF FFFF 0000 0002is the elements[-1, 2], and the record is 9 WORD in total.