/** * Copyright 2021 Huawei Technologies Co., Ltd * * 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. */ #ifndef MINDSPORE_INCLUDE_API_KERNEL_H #define MINDSPORE_INCLUDE_API_KERNEL_H #include #include #include #include #include "schema/model_generated.h" #include "include/api/types.h" #include "include/api/context.h" namespace mindspore::kernel { /// \brief The Kernel class is used to define a MindSpore Kernel. class MS_API Kernel { public: Kernel() = default; /// \brief Constructor. /// /// \param[in] inputs define the input tensors for kernel. /// \param[in] outputs define the output tensors for kernel. /// \param[in] primitive define the primitive of kernel generated by flatbuffers. /// \param[in] ctx define the context for kernel. Kernel(const std::vector &inputs, const std::vector &outputs, const schema::Primitive *primitive, const mindspore::Context *ctx) : context_(ctx), inputs_(std::move(inputs)), outputs_(std::move(outputs)), primitive_(primitive) { Initialize(); } /// \brief Destructor. virtual ~Kernel() = default; /// \brief prepare for executing kernel. /// /// \return result code. virtual int Prepare() = 0; /// \brief execute the kernel. /// /// \return result code. virtual int Execute() = 0; /// \brief resize the kernel input shape, memory need to refresh. /// /// \return result code. virtual int ReSize() = 0; /// \brief set kernel's input tensors. /// /// \param[in] in_tensors define the input tensors. virtual void set_inputs(const std::vector &in_tensors) { this->inputs_ = in_tensors; } /// \brief set kernel's input tensor. /// /// \param[in] in_tensor define the input tensor. /// \param[in] index define the index of the input tensor. virtual void set_input(mindspore::MSTensor in_tensor, int index) { this->inputs_[index] = in_tensor; } /// \brief set kernel's output tensors. /// /// \param[in] out_tensors define the output tensors. virtual void set_outputs(const std::vector &out_tensors) { this->outputs_ = out_tensors; } /// \brief set kernel's output tensor. /// /// \param[in] out_tensor define the output tensor. /// \param[in] index define the index of the output tensor. virtual void set_output(mindspore::MSTensor out_tensor, int index) { this->outputs_[index] = out_tensor; } /// \brief obtain kernel's input tensors. /// /// \return input tensors. virtual const std::vector &inputs() { return this->inputs_; } /// \brief obtain kernel's output tensors. /// /// \return output tensors. virtual const std::vector &outputs() { return this->outputs_; } /// \brief obtain kernel's name. /// /// \return kernel's name. std::string name() const { return this->name_; } /// \brief set kernel's name. /// /// \param[in] name define the kernel's name. void set_name(const std::string &name) { this->name_ = name; } /// \brief obtain kernel's context. /// /// \return kernel's context. const mindspore::Context *context() const { return this->context_; } /// \brief obtain kernel's type. /// /// \return kernel's type. virtual schema::PrimitiveType type() const { return type_; } /// \brief obtain the primitive of kernel generated by flatbuffers. /// /// \return the primitive of kernel generated by flatbuffers. const schema::Primitive *primitive() const { return this->primitive_; } /// \brief get kernel's attribute /// /// \param[in] key define the kernel's attribute key. std::string GetAttr(const std::string &key) const { auto iter = attrs_.find(key); if (iter != attrs_.end()) { return iter->second; } return ""; } protected: /// \brief set kernel's attribute /// /// \param[in] key define the kernel's attribute key. /// \param[in] value define the kernel's attribute value. void SetAttr(const std::string &key, const std::string &value) { attrs_[key] = value; } protected: std::string name_; const mindspore::Context *context_ = nullptr; std::vector inputs_; std::vector outputs_; schema::PrimitiveType type_ = schema::PrimitiveType_NONE; const schema::Primitive *primitive_ = nullptr; std::map attrs_; private: void Initialize(); }; } // namespace mindspore::kernel #endif // MINDSPORE_INCLUDE_API_KERNEL_H