// 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. #pragma once #include #include #include #include #include #include "paddle/fluid/framework/ir/node.h" #include "paddle/fluid/platform/place.h" namespace paddle { namespace framework { namespace details { class OpHandleBase; // Wraps ir::Node and provide helper utilities. // It's responsible for populating necessary fields of ir::Node. // // VarHandleBase is the var node in the dependency graph. // A variable can only be generated by a single operator. i.e. // This is a single assignment graph. struct VarHandleBase { explicit VarHandleBase(ir::Node* node) : node_(node) {} virtual ~VarHandleBase(); virtual std::string DebugString() const = 0; void AddInput(OpHandleBase* in, ir::Node* node) { node_->inputs.clear(); node_->inputs.push_back(node); generated_op_ = in; } void AddOutput(OpHandleBase* out, ir::Node* node) { if (pending_ops_.find(out) == pending_ops_.end()) { pending_ops_.insert(out); node_->outputs.push_back(node); } } void RemoveOutput(OpHandleBase* out, ir::Node* node) { pending_ops_.erase(out); std::remove(node_->outputs.begin(), node_->outputs.end(), node); } void ClearGeneratedOp() { generated_op_ = nullptr; node_->inputs.clear(); } OpHandleBase* GeneratedOp() { return generated_op_; } const std::unordered_set& PendingOps() const { return pending_ops_; } ir::Node* Node() { return node_; } protected: // The operator who generate this variable. nullptr if the variable // is a root node. OpHandleBase* generated_op_{nullptr}; // Operators which depend on this variable ready. std::unordered_set pending_ops_; ir::Node* node_; }; // VarHandle is actually a single version of Runtime Variable. // Variable in Runtime mapped to many VarHandles in Graph. // Each assignment will generate a new var handle with newer version. // // NOTE: runtime variables have place. struct VarHandle : public VarHandleBase { explicit VarHandle(ir::Node* node) : VarHandleBase(node) {} std::string DebugString() const override; VarHandle(ir::Node* node, size_t version, size_t scope_index, std::string name, platform::Place place) : VarHandleBase(node), version_(version), scope_idx_(scope_index), name_(std::move(name)), place_(std::move(place)) {} // version field currently is not used, however, just store the version to // debug easily. size_t version_; size_t scope_idx_; std::string name_; platform::Place place_; bool IsTheSameVar(const VarHandle& o) const { return o.generated_op_ == generated_op_ && o.name_ == name_ && o.scope_idx_ == scope_idx_; } }; // Dummy Variable. It is used to represent dependencies between operators struct DummyVarHandle : public VarHandleBase { explicit DummyVarHandle(ir::Node* node) : VarHandleBase(node) {} std::string DebugString() const override; }; } // namespace details } // namespace framework } // namespace paddle