COMPLEX128 is a Value that represents a complex number by two IEEE 754 binary64 components in the order (real, imag). It is Value VALUE-ISSUER-2WORD (0x09DL), Issuer 0x00000002 ADHOC, codec number 0x00000701, family NUMERIC.
Layout
TAG WORD 0x09DC (0000 1001 1101 1100) 13 WORD in total
Issuer 2 WORD 0x00000002 (ADHOC)
Codec number 2 WORD 0x00000701
Payload [real binary64: 4 WORD][imag binary64: 4 WORD]
Interpretation and validity
- Each component is binary64 interchange bits in big-endian WORD order.
- The bit pattern, including NaN payload and signed zero, is preserved as is, and there is no ABI padding.
- The Payload is exactly 8 WORD. All interchange bit patterns of the two binary64 components are preserved.
Standards basis and formal status
- That
complex128consists of a 64-bit real component and a 64-bit imaginary component follows the ONNX IR, and the real-first order is the same as the complex raw-data mapping of the official ONNX TensorProto schema. The bit pattern of each component follows IEEE 754 binary64. - ONNX raw data is fixed-width little-endian, but this format uses GEUL big-endian WORD framing, so it is not the ONNX TensorProto wire serialization itself.
Length
- The total is exactly 13 WORD: TAG 1 WORD, Issuer 2 WORD, codec number 2 WORD, and Payload 8 WORD, and it uses the direct length
LLLL=1100. There is no Length extension TAG, no descriptor, and no padding. - If the Payload is not exactly 8 WORD, it is rejected.
Example
- If the two binary64 values in the Payload are
1.0, -0.0, the value has real part 1.0 and imaginary part -0.0.