// Copyright (c) 2018 PaddlePaddle Authors. All Rights Reserved. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. /* * This file implements some helper classes and methods for DOT programming * support. It will give a visualization of the graph and that helps to debug * the logics of each Pass. */ #pragma once #include #include #include #include #include namespace paddle { namespace inference { namespace analysis { static size_t dot_node_counter{0}; /* * A Dot template that helps to build a DOT graph definition. */ class Dot { public: struct Attr { std::string key; std::string value; Attr(const std::string& key, const std::string& value) : key(key), value(value) {} std::string repr() const { std::stringstream ss; ss << key << "=" << '"' << value << '"'; return ss.str(); } }; struct Node { std::string name; std::vector attrs; Node(const std::string& name, const std::vector& attrs) : name(name), attrs(attrs), id_("node_" + std::to_string(dot_node_counter++)) {} Node(const std::string& name, const std::vector& attrs, size_t id) : name(name), attrs(attrs), id_("node_" + std::to_string(id)) {} std::string id() const { return id_; } std::string repr() const { std::stringstream ss; CHECK(!name.empty()); ss << id_; if (attrs.empty()) { ss << "[label=" << '"' << name << '"' << "]"; return ss.str(); } for (size_t i = 0; i < attrs.size(); i++) { if (i == 0) { ss << "[label=" << '"' << name << '"' << " "; } ss << attrs[i].repr(); ss << ((i < attrs.size() - 1) ? " " : "]"); } return ss.str(); } private: std::string id_; }; struct Edge { std::string source; std::string target; std::vector attrs; Edge(const std::string& source, const std::string& target, const std::vector& attrs) : source(source), target(target), attrs(attrs) {} std::string repr() const { std::stringstream ss; CHECK(!source.empty()); CHECK(!target.empty()); ss << source << "->" << target; for (size_t i = 0; i < attrs.size(); i++) { if (i == 0) { ss << "["; } ss << attrs[i].repr(); ss << ((i < attrs.size() - 1) ? " " : "]"); } return ss.str(); } }; Dot() = default; explicit Dot(const std::vector& attrs) : attrs_(attrs) {} void AddNode(const std::string& id, const std::vector& attrs, std::string label = "", bool use_local_id = false) { CHECK(!nodes_.count(id)) << "duplicate Node '" << id << "'"; if (label.empty()) label = id; if (use_local_id) { nodes_.emplace(id, Node{label, attrs, local_node_counter_++}); } else { nodes_.emplace(id, Node{label, attrs}); } } void AddEdge(const std::string& source, const std::string& target, const std::vector& attrs) { CHECK(!source.empty()); CHECK(!target.empty()); auto sid = nodes_.at(source).id(); auto tid = nodes_.at(target).id(); edges_.emplace_back(sid, tid, attrs); } // Compile to DOT language codes. std::string Build() const { std::stringstream ss; const std::string indent = " "; ss << "digraph G {" << '\n'; // Add graph attrs for (const auto& attr : attrs_) { ss << indent << attr.repr() << '\n'; } // add nodes for (auto& item : nodes_) { ss << indent << item.second.repr() << '\n'; } // add edges for (auto& edge : edges_) { ss << indent << edge.repr() << '\n'; } ss << "} // end G"; return ss.str(); } private: std::unordered_map nodes_; std::vector edges_; std::vector attrs_; size_t local_node_counter_{0}; }; } // namespace analysis } // namespace inference } // namespace paddle