SortIdx
函数功能
图像处理类算法，张量排序索引算法SortIdx，输入张量支持float16、float32、uint8，输出张量仅支持int32。支持异步调用。支持预加载（预加载时需要添加attr属性，示例请参见“初始化算子预加载文件实例”章节）。不支持inplace操作。
当前支持Atlas 推理系列产品和Atlas 200I/500 A2 推理产品。
使用时需满足以下条件：
- 接口中的输入输出Tensor必须在Device或DVPP侧且各参数（stream及数据内存）需位于同一Device中。
- 同步场景下，数据内存所在Device需与初始化的Device一致。
- 各输入、输出参数对应Tensor的尺寸一致，输入、输出仅支持HW。
- 在Atlas 推理系列产品产品上，当输入Tensor数据类型为float32或float16，尺寸在480P（640*480）以上，或者输入Tensor数据类型为uint8，尺寸在1080P（1920*1080）以上时，SortIdx计算性能优于cv::sortIdx在CPU上的性能。
- 在Atlas 200I/500 A2 推理产品上，当输入尺寸在720P（720*1280）时，计算性能优于cv::sortIdx在CPU上的性能。
函数原型
APP_ERROR SortIdx(const Tensor &src, Tensor &dstIdx, int axis, bool descending, AscendStream& stream = AscendStream::DefaultStream());
参数说明
参数名 |
输入/输出 |
说明 |
|---|---|---|
src |
输入 |
Tensor类，输入张量，支持float16、float32、uint8类型输入，仅支持HW维度输入。 |
dstIdx |
输出 |
Tensor类，输出张量，张量内容指值排序后的索引序列结果，仅支持int32类型输出，支持传入空Tensor，如果dst不为空Tensor，需要调用Tensor.Malloc()接口提前分配内存。 src中有相同值的情况下，dstIdx（排序结果索引值）在Atlas 200I/500 A2 推理产品上的排序结果和Atlas 推理系列产品相反：
|
axis |
输入 |
排序的指定维度，范围为[0, 1]，其中，0表示按高维度排序，1表示按宽维度排序。 |
descending |
输入 |
升/降序选项，默认false为升序。 |
stream |
输入 |
AscendStream类型，默认值为“AscendStream::DefaultStream()”。当参数值为默认值时，接口为同步操作；其他情况下，接口为异步操作。 |
返回参数说明
数据结构 |
说明 |
|---|---|
APP_ERROR |
程序执行返回的错误码，请参考APP_ERROR说明。 |
父主题： TensorOperations