onnx-ir 0.20.0

ONNX-IR is a pure Rust library for parsing ONNX models into an intermediate representation that can be used to generate code for various ML/DL frameworks
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

//! # Identity
//!
//! Passes input through unchanged - typically eliminated during post-processing.
//!
//! **ONNX Spec**: <https://onnx.ai/onnx/operators/onnx__Identity.html>
//!
//! ## Opset Versions
//! - **Opset 1-13**: Basic identity operation
//! - **Opset 14**: Added bfloat16 support
//! - **Opset 16**: Added optional sequence support
//! - **Opset 19**: Added int4/uint4 support
//!
//! ## Note
//! Identity nodes are typically eliminated during the post-processing phase to simplify
//! the graph. They exist primarily for graph construction and optimization purposes.

use onnx_ir_derive::NodeBuilder;

use crate::ir::{Argument, Node, RawNode};
use crate::processor::{
    InputSpec, NodeProcessor, NodeSpec, OutputPreferences, OutputSpec, ProcessError,
};

/// Node representation for Identity operation
#[derive(Debug, Clone, NodeBuilder)]
pub struct IdentityNode {
    pub name: String,
    pub inputs: Vec<Argument>,
    pub outputs: Vec<Argument>,
}

pub(crate) struct IdentityProcessor;

impl NodeProcessor for IdentityProcessor {
    type Config = ();

    fn spec(&self) -> NodeSpec {
        NodeSpec {
            min_opset: 1,
            max_opset: None,
            inputs: InputSpec::Exact(1),
            outputs: OutputSpec::Exact(1),
        }
    }

    fn infer_types(
        &self,
        node: &mut RawNode,
        _opset: usize,
        _output_preferences: &OutputPreferences,
    ) -> Result<(), ProcessError> {
        // Identity passes input type through unchanged
        node.outputs[0].ty = node.inputs[0].ty.clone();

        Ok(())
    }

    fn extract_config(&self, _node: &RawNode, _opset: usize) -> Result<Self::Config, ProcessError> {
        Ok(())
    }

    fn build_node(&self, builder: RawNode, _opset: usize) -> Node {
        Node::Identity(IdentityNode {
            name: builder.name,
            inputs: builder.inputs,
            outputs: builder.outputs,
        })
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::ir::{ArgType, DType, NodeType};
    use crate::node::test_utils::TestNodeBuilder;

    #[test]
    fn test_identity_type_inference() {
        let mut node = TestNodeBuilder::new(NodeType::Identity, "test")
            .input_tensor_f32("input", 3, None)
            .output_tensor_f32("output", 3, None)
            .build();

        let processor = IdentityProcessor;
        let prefs = OutputPreferences::new();

        processor.infer_types(&mut node, 16, &prefs).unwrap();

        // Output should have same type as input
        assert_eq!(node.outputs[0].ty, node.inputs[0].ty);

        if let ArgType::Tensor(output_tensor) = &node.outputs[0].ty {
            assert_eq!(output_tensor.dtype, DType::F32);
            assert_eq!(output_tensor.rank, 3);
        } else {
            panic!("Expected Tensor output");
        }
    }

    #[test]
    fn test_identity_scalar() {
        let mut node = TestNodeBuilder::new(NodeType::Identity, "test")
            .input_scalar_f32("input")
            .output_scalar_f32("output")
            .build();

        let processor = IdentityProcessor;
        let prefs = OutputPreferences::new();

        processor.infer_types(&mut node, 16, &prefs).unwrap();

        // Output should have same type as input
        assert!(matches!(node.outputs[0].ty, ArgType::Scalar(_)));
    }
}