PlaceHolder

功能说明

在Compute表达中，用户定义参数对象的函数方法。

所属头文件链接

/include/expression/expr_template.h

函数原型

template <std::size_t N, typename T, ParamUsage U = ParamUsage::in>
__host_aicore__ constexpr auto PlaceHolder()

参数说明

参数名称	参数类型	输入/输出	数据类型	参数说明	默认值
N	模板参数	输入	NA	参数位序，需要和用户构造ArgumentsBuilder::inputOutput()时，传入的实参顺序一一对应，从1开始顺序编号	NA
T	模板参数	输入	NA	参数类型，可以是基础类型和Tensor	NA
U	模板参数	输入	NA	参数数据流向，in：输入，out：输出，in_out：输入&输出	ParamUsage::in

返回值说明

返回值数据类型	返回值说明
Expression>	返回一个Param类型表达式对象

约束说明

NA

使用示例

template <typename InputDtype, typename OutputDtype>
struct AddSubConfig {
    struct AddSubCompute {
        template <template <typename> class Tensor>
        __host_aicore__ constexpr auto Compute() const
        {
            // 🔥🔥🔥 使用示例 🔥🔥🔥
            auto in1 = Atvoss::PlaceHolder<1, Tensor<InputDtype>, Atvoss::ParamUsage::IN>();
            auto in2 = Atvoss::PlaceHolder<2, Tensor<InputDtype>, Atvoss::ParamUsage::IN>();
            auto in3 = Atvoss::PlaceHolder<3, InputDtype, Atvoss::ParamUsage::IN>();
            auto out = Atvoss::PlaceHolder<4, Tensor<OutputDtype>, Atvoss::ParamUsage::OUT>();
            // 🔥🔥🔥 使用示例 🔥🔥🔥

            return (out = in1 + in2 - in3);
        };
    };

    using ArchTag = Atvoss::Arch::DAV_3510;
    using BlockOp = Atvoss::Ele::BlockBuilder<AddSubCompute, ArchTag>;
    using KernelOp = Atvoss::Ele::KernelBuilder<BlockOp>;
    using DeviceOp = Atvoss::DeviceAdapter<KernelOp>;
};

template <typename InputDtype, typename OutputDtype>
static void Run() {
    /* ACL init and stream create */
    ...

    Atvoss::Tensor<InputDtype> in1(deviceIn1, {{3, 4, 0, 0, 0, 0, 0, 0}}, 2);
    Atvoss::Tensor<InputDtype> in2(deviceIn2, {{3, 4, 0, 0, 0, 0, 0, 0}}, 2);
    InputDtype in3 = 5.0;
    Atvoss::Tensor<OutputDtype> out(deviceOut, {{3, 4, 0, 0, 0, 0, 0, 0}}, 2);

    auto arguments = Atvoss::ArgumentsBuilder{}.inputOutput(in1, in2, in3, out).attr("dim", 5).build();

    using DeviceOp = typename AddSubConfig<InputDtype, OutputDtype>::DeviceOp;
    DeviceOp deviceOp;
    deviceOp.Run(arguments, stream);
}

int main(int argc, char const* argv[]) {
    Run<float, float>();
    return 0;
}