Divide
函数功能
图像处理类算法,张量除法Divide,支持float16、float32、uint8。支持异步调用,部分函数原型支持预加载。不支持inplace操作。
当前支持Atlas 推理系列产品和Atlas 200I/500 A2 推理产品。
在Atlas 200I/500 A2 推理产品上,支持预加载(示例请参见“初始化算子预加载文件实例”章节)。
使用时需满足以下条件:
- 接口中的输入输出Tensor必须在Device或DVPP侧且各参数(stream及数据内存)需位于同一Device中。
- 同步场景下,数据内存所在Device需与初始化的Device一致。
- 请注意处理数据类型越界问题。
- 在Atlas 推理系列产品上,该接口为饱和计算,当数据值超过数据类型范围时,不发生回绕;在Atlas 200I/500 A2 推理产品上,该接口为非饱和接口。
- 各输入、输出参数对应Tensor的形状(Shape)相等、不超过4维。允许src1和src2为不同数据类型,dst的数据类型以src1和src2中精度高的数据类型为准。
- 在Atlas 推理系列产品产品上,当输入尺寸在240P(320*240)以上,计算性能优于cv::divide在CPU上的性能。
- 在Atlas 200I/500 A2 推理产品上,当输入尺寸在720P(720*1280)时,计算性能优于cv::divide在CPU上的性能。
函数原型
原型1
APP_ERROR Divide(const Tensor &src1, const Tensor &src2, Tensor &dst, AscendStream &stream = AscendStream::DefaultStream());
原型2(Atlas 200I/500 A2 推理产品不适用该原型):
APP_ERROR Divide(const Tensor &src1, const Tensor &src2, Tensor &dst, float scale, AscendStream& stream = AscendStream::DefaultStream());
参数说明
参数名 |
输入/输出 |
说明 |
---|---|---|
src1 |
输入 |
Tensor类,被除数,输入张量,支持float16、float32、uint8类型输入。 |
src2 |
输入 |
Tensor类,除数,输入张量,支持float16、float32、uint8类型输入。“src2”内的元素不能为0。 |
dst |
输出 |
Tensor类,输出张量,支持float16、float32、uint8类型输出,支持传入空Tensor,如果dst不为空Tensor,需要调用Tensor.Malloc()接口提前分配内存。 |
stream |
输入 |
AscendStream类型,默认值为“AscendStream::DefaultStream()”。当参数值为默认值时,接口为同步操作,其他情况下,接口为异步操作。 |
scale |
输入 |
float类型,输入标量,输入Tensor src1和标量相乘后结果再与src2相除。 |
返回参数说明
数据结构 |
说明 |
---|---|
APP_ERROR |
程序执行返回的错误码,请参考APP_ERROR说明。 |
父主题: TensorOperations