TransdataOperation

功能

数据格式转换处理。将ACL_FORMAT_ND格式转换为ACL_FORMAT_FRACTAL_NZ格式,或将ACL_FORMAT_FRACTAL_NZ格式转换为ACL_FORMAT_ND格式。

  • 等效描述:ND、ACL_FORMAT_ND
  • 等效描述:NZ、ACL_FORMAT_FRACTAL_NZ、FRACTAL_NZ

硬件支持情况

硬件型号

支持情况

特殊说明

Atlas 200I/500 A2 推理产品

支持

仅支持float16数据类型。

Atlas 推理系列产品

支持

-

Atlas 800I A2 推理产品 / Atlas A2 训练系列产品

支持

-

Atlas A3 推理系列产品 / Atlas A3 训练系列产品

支持

-

定义

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
struct TransdataParam {
     enum TransdataType : int { 
         UNDEFINED = 0, 
         FRACTAL_NZ_TO_ND, 
         ND_TO_FRACTAL_NZ 
     };
     TransdataType transdataType = UNDEFINED;
     SVector<int64_t> outCrops = {0, 0};
     uint8_t rsv[8] = {0};
};

参数列表

成员名称

类型

默认值

描述

transdataType

TransdataType

UNDEFINED

数据格式转换类型,支持FRACTAL_NZ和ND互相转换。

  • UNDEFINED:默认。
  • FRACTAL_NZ_TO_ND:FRACTAL_NZ转ND。
  • ND_TO_FRACTAL_NZ:ND转FRACTAL_NZ。

此默认类型不可用,用户需配置此项参数。

outCrops

SVector<int64_t>

{0,0}

仅当FRACTAL_NZ转ND时使用,表示原ND数据格式Shape的最后两维。

rsv[8]

uint8_t

{0}

预留参数。

ND转NZ输入输出描述

参数

维度

数据类型

格式

描述

x

  1. [batch, m, n]
  2. [m, n]

float16/int8/bf16

ND

输入tensor。

y

[batch, n1, m1m0, n0]

float16/int8/bf16

NZ

输出tensor,数据类型与输入tensor一致

  • 当输入tensor数据类型为float16/bf16时,n0, m0为16。
  • 当输入tensor数据类型为int8时,n0为32,m0为16
  • 当输入tensor为2维时,输出tensor的batch为1

NZ转ND输入输出描述

参数

维度

数据类型

格式

描述

x

[batch, n1, m1m0, n0]

float16/bf16

NZ

输入tensor。

y

[batch, m, n]

float16/bf16

ND

输出tensor,数据类型与输入tensor一致

功能列表

规格约束

算子调用示例(C++)

前置条件和编译命令请参见算子调用示例

场景:基础场景。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
#include <iostream>
#include <vector>
#include <numeric>
#include <random>
#include "acl/acl.h"
#include "atb/operation.h"
#include "atb/types.h"
#include "atb/atb_infer.h"

#include "demo_util.h"

const uint32_t BATCH_SIZE = 8;    // 批处理大小
const uint32_t SEQ_LEN = 100;     // 序列长度
const uint32_t HIDDEN_SIZE = 30;  // 隐藏层维度

/**
 * @brief 准备atb::VariantPack中的所有输入tensor
 * @param contextPtr context指针
 * @param stream stream
 * @return atb::SVector<atb::Tensor> 返回一个{[BATCH_SIZE, SEQ_LEN, HIDDEN_SIZE]}的输入Tensors
 */
atb::SVector<atb::Tensor> PrepareInTensors(atb::Context *contextPtr, aclrtStream stream)
{
    // 创建一个[BATCH_SIZE*SEQ_LEN*HIDDEN_SIZE]的vector,其中各个值为取值范围为[-100,100)的随机数
    std::vector<float> inTensorData(BATCH_SIZE * SEQ_LEN * HIDDEN_SIZE, 1.0);
    // 创建输入Tensor
    atb::Tensor inTensor = CreateTensorFromVector(
        contextPtr, stream, inTensorData, ACL_FLOAT16, aclFormat::ACL_FORMAT_ND, {BATCH_SIZE, SEQ_LEN, HIDDEN_SIZE});
    atb::SVector<atb::Tensor> inTensors = {inTensor};
    return inTensors;
}

/**
 * @brief 创建一个 ND转NZ的TransdataOperation,并设置参数
 * @return atb::Operation * 返回一个Operation指针
 */
atb::Operation *PrepareOperation()
{
    atb::infer::TransdataParam opParam;
    opParam.transdataType = atb::infer::TransdataParam::TransdataType::ND_TO_FRACTAL_NZ;
    atb::Operation *transdataOp = nullptr;
    CHECK_STATUS(atb::CreateOperation(opParam, &transdataOp));
    return transdataOp;
}

int main(int argc, char **argv)
{
    // 设置卡号、创建context、设置stream
    CHECK_STATUS(aclInit(nullptr));
    int32_t deviceId = 0;
    CHECK_STATUS(aclrtSetDevice(deviceId));
    atb::Context *context = nullptr;
    CHECK_STATUS(atb::CreateContext(&context));
    void *stream = nullptr;
    CHECK_STATUS(aclrtCreateStream(&stream));
    context->SetExecuteStream(stream);

    // TransdataOp ND to NZ示例
    atb::Operation *transdataOp = PrepareOperation();
    // 准备VariantPack
    uint32_t ALIGN_16 = 16;
    atb::VariantPack variantPack;
    variantPack.inTensors = PrepareInTensors(context, stream);  // 放入输入tensor
    atb::Tensor outTensor = CreateTensor(ACL_FLOAT16,
        aclFormat::ACL_FORMAT_FRACTAL_NZ,
        {BATCH_SIZE,
            (HIDDEN_SIZE + ALIGN_16 - 1) / ALIGN_16,
            (SEQ_LEN + ALIGN_16 - 1) / ALIGN_16 * ALIGN_16,
            ALIGN_16});
    variantPack.outTensors.push_back(outTensor);  // 放入输出tensor
    uint64_t workspaceSize = 0;
    // Transdata ND to NZ准备工作
    CHECK_STATUS(transdataOp->Setup(variantPack, workspaceSize, context));
    uint8_t *workspacePtr = nullptr;
    if (workspaceSize > 0) {
        CHECK_STATUS(aclrtMalloc((void **)(&workspacePtr), workspaceSize, ACL_MEM_MALLOC_HUGE_FIRST));
    }
    // Transdata ND to NZ执行
    transdataOp->Execute(variantPack, workspacePtr, workspaceSize, context);
    CHECK_STATUS(aclrtSynchronizeStream(stream));  // 流同步,等待device侧任务计算完成

    for (atb::Tensor &inTensor : variantPack.inTensors) {
        CHECK_STATUS(aclrtFree(inTensor.deviceData));
    }
    for (atb::Tensor &outTensor : variantPack.outTensors) {
        CHECK_STATUS(aclrtFree(outTensor.deviceData));
    }
    if (workspaceSize > 0) {
        CHECK_STATUS(aclrtFree(workspacePtr));
    }
    CHECK_STATUS(atb::DestroyOperation(transdataOp));  // operation,对象概念,先释放
    std::cout << "Transdata ND to NZ demo success!" << std::endl;

    // 资源释放
    CHECK_STATUS(aclrtDestroyStream(stream));
    CHECK_STATUS(atb::DestroyContext(context));  // context,全局资源,后释放
    CHECK_STATUS(aclFinalize());
    return 0;
}