docc 0.8.3 (0d44999b)
C++ API Reference
Loading...
Searching...
No Matches
gemm_node.h
Go to the documentation of this file.
1#pragma once
2
4
7
9
10namespace sdfg {
11namespace math {
12namespace blas {
13
15
16class GEMMNode : public BLASNode {
17private:
18 BLAS_Layout layout_;
19 BLAS_Transpose trans_a_;
20 BLAS_Transpose trans_b_;
21
28
29public:
31 size_t element_id,
32 const DebugInfo& debug_info,
37 const BLAS_Layout& layout,
46 );
47
48 static constexpr int A_INPUT_IDX = 0;
49 static constexpr int B_INPUT_IDX = 1;
50 static constexpr int C_INPUT_IDX = 2;
51 static constexpr int ALPHA_INPUT_IDX = 3;
52 static constexpr int BETA_INPUT_IDX = 4;
53
55
57
59
61
63
65
67
69
71
72 void validate(const Function& function) const override;
73
76
77 symbolic::SymbolSet symbols() const override;
78
79 void replace(const symbolic::Expression old_expression, const symbolic::Expression new_expression) override;
80
81 void replace(const symbolic::ExpressionMapping& replacements) override;
82
83 std::unique_ptr<data_flow::DataFlowNode>
84 clone(size_t element_id, const graph::Vertex vertex, data_flow::DataFlowGraph& parent) const override;
85
86 std::string toStr() const override;
87
88 symbolic::Expression flop() const override;
89
91 symbolic::Condition alpha_non_zero,
92 symbolic::Condition alpha_non_ident,
93 symbolic::Condition beta_non_zero,
94 symbolic::Condition beta_non_ident
95 ) const;
96
98 const symbolic::Expression& outer_dim,
99 const symbolic::Expression& inner_dim,
100 const symbolic::Expression& line_size,
101 BLAS_Transpose trans,
103 );
104
106
107 bool relocalize_operand(int input_idx, const math::tensor::TensorLayout& packed) override;
108 bool can_relocalize_operand(int input_idx, const math::tensor::TensorLayout& packed) const override;
109};
110
112public:
113 nlohmann::json serialize(const data_flow::LibraryNode& library_node) override;
114
117 ) override;
118};
119
121public:
123 codegen::LanguageExtension& language_extension,
124 const Function& function,
125 const data_flow::DataFlowGraph& data_flow_graph,
126 const GEMMNode& node
127 );
128
131 std::vector<codegen::DispatchInput>& inputs,
132 std::vector<codegen::DispatchOutput>& outputs
133 ) override;
134
136};
137
140 Block& block,
141 const std::string& ptr_a,
142 const std::string& ptr_b,
143 const std::string& ptr_c,
144 data_flow::AccessNode& alpha_node,
145 data_flow::AccessNode& beta_node,
146 const BLAS_Precision& precision,
147 const BLAS_Layout& layout,
148 const BLAS_Transpose& trans_a,
149 const BLAS_Transpose& trans_b,
156 const types::IType& a_type,
157 const types::IType& b_type,
158 const types::IType& c_type,
159 const types::IType& factor_type,
160 DebugInfo debug_info,
161 DebugInfo a_access_deb_info,
162 DebugInfo b_access_deb_info,
163 DebugInfo c_access_deb_info,
164 DebugInfo a_edge_deb_info,
165 DebugInfo b_edge_deb_info,
166 DebugInfo c_edge_deb_info,
168);
169
172 Block& block,
173 const std::string& ptr_a,
174 const std::string& ptr_b,
175 const std::string& ptr_c,
176 data_flow::AccessNode& alpha_node,
177 data_flow::AccessNode& beta_node,
178 const BLAS_Precision& precision,
179 const BLAS_Layout& layout,
180 const BLAS_Transpose& trans_a,
181 const BLAS_Transpose& trans_b,
188 const types::IType& ptr_type,
189 const types::IType& factor_type,
190 DebugInfo debug_info = DebugInfo(),
192);
193
194} // namespace blas
195} // namespace math
196} // namespace sdfg
Dispatchers for dataflow blocks and library nodes.
Definition element.h:30
size_t element_id() const
const DebugInfo & debug_info() const
Definition function.h:43
Note: Even though the class references unique_ptr, it will never delete an SDFG it has a reference to...
Definition structured_sdfg_builder.h:44
Definition instrumentation_info.h:37
Definition language_extension.h:39
Base class for library node code generation dispatchers.
Definition block_dispatcher.h:163
Node representing access to a data container in the dataflow graph.
Definition access_node.h:84
Definition data_flow_graph.h:29
graph::Vertex vertex() const
Get the graph vertex for this node.
Base class for all library nodes in the dataflow graph.
Definition library_node.h:106
const ImplementationType & implementation_type() const
Get the implementation type (const).
BLAS_Precision precision() const
Get the precision/data type.
BLASNode(size_t element_id, const DebugInfo &debug_info, const graph::Vertex vertex, data_flow::DataFlowGraph &parent, const data_flow::LibraryNodeCode &code, const std::vector< std::string > &outputs, const std::vector< std::string > &inputs, const data_flow::ImplementationType &implementation_type, const BLAS_Precision &precision)
Construct a BLAS node.
codegen::InstrumentationInfo instrumentation_info() const override
Get instrumentation information for this node.
GEMMNodeDispatcher_BLAS(codegen::LanguageExtension &language_extension, const Function &function, const data_flow::DataFlowGraph &data_flow_graph, const GEMMNode &node)
void dispatch_code_with_edges(codegen::CodegenOutput &out, std::vector< codegen::DispatchInput > &inputs, std::vector< codegen::DispatchOutput > &outputs) override
Definition gemm_node.h:111
nlohmann::json serialize(const data_flow::LibraryNode &library_node) override
Serialize a library node to JSON.
data_flow::LibraryNode & deserialize(const nlohmann::json &j, builder::StructuredSDFGBuilder &builder, structured_control_flow::Block &parent) override
Deserialize a library node from JSON.
Definition gemm_node.h:16
symbolic::Expression n() const
symbolic::Expression lda() const
symbolic::Expression flops(symbolic::Condition alpha_non_zero, symbolic::Condition alpha_non_ident, symbolic::Condition beta_non_zero, symbolic::Condition beta_non_ident) const
static constexpr int C_INPUT_IDX
Definition gemm_node.h:50
void replace(const symbolic::Expression old_expression, const symbolic::Expression new_expression) override
symbolic::Expression ldc() const
symbolic::SymbolSet symbols() const override
Get all symbols used in this node.
passes::LibNodeExpander::ExpandOutcome expand(passes::LibNodeExpander::ExpandContext &context, structured_control_flow::Block &block) override
Expand this node into its internal operations.
static constexpr int ALPHA_INPUT_IDX
Definition gemm_node.h:51
static constexpr int B_INPUT_IDX
Definition gemm_node.h:49
GEMMNode(size_t element_id, const DebugInfo &debug_info, const graph::Vertex vertex, data_flow::DataFlowGraph &parent, const data_flow::ImplementationType &implementation_type, const BLAS_Precision &precision, const BLAS_Layout &layout, const BLAS_Transpose &trans_a, const BLAS_Transpose &trans_b, symbolic::Expression m, symbolic::Expression n, symbolic::Expression k, symbolic::Expression lda, symbolic::Expression ldb, symbolic::Expression ldc)
symbolic::Expression k() const
bool can_relocalize_operand(int input_idx, const math::tensor::TensorLayout &packed) const override
Side-effect-free predicate mirroring relocalize_operand: whether the operand at input_idx can be repo...
symbolic::Expression ldb() const
BLAS_Transpose trans_b() const
static symbolic::Expression calc_matrix_access_range(const symbolic::Expression &outer_dim, const symbolic::Expression &inner_dim, const symbolic::Expression &line_size, BLAS_Transpose trans, BLAS_Layout layout)
symbolic::Expression m() const
static constexpr int A_INPUT_IDX
Definition gemm_node.h:48
std::unique_ptr< data_flow::DataFlowNode > clone(size_t element_id, const graph::Vertex vertex, data_flow::DataFlowGraph &parent) const override
Clone this node for graph transformations.
std::string toStr() const override
Convert node to string representation.
symbolic::Expression flop() const override
Calculate floating point operations for this node.
void replace(const symbolic::ExpressionMapping &replacements) override
data_flow::PointerAccessType pointer_access_type(int input_idx) const override
Describes what a pointer is used for.
BLAS_Transpose trans_a() const
bool relocalize_operand(int input_idx, const math::tensor::TensorLayout &packed) override
Repoint the operand at input_idx to a locally staged buffer.
void validate(const Function &function) const override
Validate the code node's configuration.
static constexpr int BETA_INPUT_IDX
Definition gemm_node.h:52
BLAS_Layout layout() const
The metadata associated with a addressing a tensor in elements Meant to be used with TensorNodes to d...
Definition tensor_layout.h:20
Definition lib_node_expander.h:122
Base class for library node serialization.
Definition json_serializer.h:195
A control flow node representing a basic block with dataflow computations.
Definition block.h:42
Abstract base interface for all types in the sdfglib type system.
Definition type.h:625
SymEngine::RCP< const SymEngine::Basic > Expression
Reference-counted pointer to a symbolic expression (SymEngine Basic).
Definition symbolic.h:83
std::set< Symbol, SymEngine::RCPBasicKeyLess > SymbolSet
Ordered set of symbols.
Definition symbolic.h:95
SymEngine::RCP< const SymEngine::Boolean > Condition
Reference-counted pointer to a boolean condition expression.
Definition symbolic.h:86
SymEngine::map_basic_basic ExpressionMapping
Definition symbolic.h:109
Mathematical library node base class with expansion support.
Definition function_builder.h:10
StringEnum ImplementationType
Implementation type identifier for library nodes.
Definition library_node.h:75
StringEnum LibraryNodeCode
Definition library_node.h:65
std::unique_ptr< PointerAccessMeta, PtrAccessDeleter > PointerAccessType
Definition pointer_metadata.h:32
boost::graph_traits< Graph >::vertex_descriptor Vertex
Definition graph.h:25
Definition batched_gemm_node.h:13
GEMMNode & add_gemm_node(builder::StructuredSDFGBuilder &builder, Block &block, const std::string &ptr_a, const std::string &ptr_b, const std::string &ptr_c, data_flow::AccessNode &alpha_node, data_flow::AccessNode &beta_node, const BLAS_Precision &precision, const BLAS_Layout &layout, const BLAS_Transpose &trans_a, const BLAS_Transpose &trans_b, symbolic::Expression &m, symbolic::Expression &n, symbolic::Expression &k, symbolic::Expression &lda, symbolic::Expression &ldb, symbolic::Expression &ldc, const types::IType &a_type, const types::IType &b_type, const types::IType &c_type, const types::IType &factor_type, DebugInfo debug_info, DebugInfo a_access_deb_info, DebugInfo b_access_deb_info, DebugInfo c_access_deb_info, DebugInfo a_edge_deb_info, DebugInfo b_edge_deb_info, DebugInfo c_edge_deb_info, data_flow::ImplementationType impl_type)
BLAS_Precision
Precision/data type for BLAS operations.
Definition blas_node.h:52
data_flow::ImplementationType ImplementationType_BLAS
BLAS implementation type Uses standard CPU BLAS libraries (OpenBLAS, Intel MKL, etc....
Definition blas_node.h:156
BLAS_Transpose
Transpose operation for BLAS matrices.
Definition blas_node.h:87
BLAS_Layout
Memory layout for BLAS matrices.
Definition blas_node.h:127
data_flow::LibraryNodeCode LibraryNodeType_GEMM("GEMM")
Definition batched_gemm_node.h:12
Definition analysis.h:7
Definition block_dispatcher.h:108
Definition lib_node_expander.h:12