Star0

Star0

cann-robotdocs: 订正 bitwise_not、cholesky、cummin、topk 等 8 个算子资料及头文件注释

b7fe8ad8Add on 12 days agoHistory

Files	Last commit	Last update
docs	docs: 订正 bitwise_not、cholesky、cummin、topk 等 8 个算子资料及头文件注释 Co-authored-by: Nice_try<zhangzhiwei108@huawei.com> # message auto-generated for no-merge-commit merge: !6781 merge sync-1028 into master docs: 订正 bitwise_not、cholesky、cummin、topk 等 8 个算子资料及头文件注释 Created-by: Nice_try Commit-by: Nice_try Merged-by: cann-robot Description: ## 描述本 PR 订正 8 个算子资料与头文件注释中与实现、产品支持情况不一致的描述。改动全部为文档（zh/en）与头文件注释，不涉及代码逻辑。 ### 改动原因资料与头文件注释存在与实现、错误码表或产品支持情况互相矛盾的描述：dtype 列表漏项、产品支持范围与参数表结论不一致、参数语义描述错误、公式求和区间端点错误、退化点取值未声明等，逐条见「关联的Issue」。 ### 改动方法 1. bitwise_not（`docs/aclnnBitwiseNot.md`、`aclnnBitwiseNot_en.md`）：self、out 补充数据类型支持描述，与资料及实现对齐（#3950）。 2. bitwise_or（`docs/aclnnBitwiseOrScalar&aclnnInplaceBitwiseOrScalar.md`、`_en.md`）：self、other、selfRef补充数据类型支持描述，消除与产品支持情况分组的矛盾（#3995）。 3. cdist_grad（`docs/aclnnCdistBackward.md`、`_en.md`）：新增说明——上述闭式仅在 `cdist > 0` 时适用；当 `cdist = 0`（x1 与 x2 在该点对上完全重合）时，该点对对 x1 的梯度贡献按 0 处理（#3956）。 4. cholesky（`docs/aclnnLinalgCholesky.md`、`_en.md`）：产品支持情况中 Ascend 950PR&950DT 系列产品由「不支持」改为「支持」；self、out 的数据类型由「FLOAT、BFLOAT16」补充为「FLOAT、FLOAT16、BFLOAT16」（#3957）。 5. cummin（`docs/aclnnCummin.md`、`_en.md`）：self、valuesOut 的 dtype 约束由统一规则改为「具体数据类型关系见下方产品支持情况」，并在产品支持情况新增两条分组说明——Ascend 950PR&950DT 系列产品下 self 为 INT8/UINT8/BOOL 时 valuesOut 可为不同的可转换数据类型，其余数据类型需与 self 一致；Atlas A3/A2、Atlas 200I/500 A2、Atlas 推理、Atlas 训练系列产品下 self 的数据类型需能转换为 valuesOut 的数据类型（#3969）。 6. grouped_bias_add_grad（`docs/aclnnGroupedBiasAddGrad.md`、`_en.md`）：groupIdx 求和区间上端点由 `groupIdxOptional(j)` 改为不含端点的 `groupIdxOptional(j)-1`，j=0 分支同步改为 `groupIdxOptional(0)-1`；无可选输入时求和区间由 `0` 至 `C` 改为 `0` 至 `C-1`；文字说明中明确 `groupIdxOptional(j)` 表示第 j 组的结束位置（不包含）（#3948）。 7. pow（`op_api/aclnn_pow.h` 头文件注释）：out 的数据类型要求由「数据类型、数据格式和shape与self一致」改为「数据格式和shape需与self一致，数据类型需为self与exponent推导后可转换的数据类型」（#3959）。 8. topk、topkV2（`docs/aclnnTopk.md`、`aclnnTopk_en.md`、`aclnnTopkV2.md`、`aclnnTopkV2_en.md` 共 4 个文件）：`largest` 由「计算维度上的结果排序方式」改为「选取最大还是最小的 k 个值」；`sorted` 删除「当前该参数仅支持取 True」，改为 False 表示不要求输出有序，并明确不保证输出顺序及等值元素的索引稳定性（#3971）。 ## 关联的Issue https://gitcode.com/cann/ops-math/issues/3995 https://gitcode.com/cann/ops-math/issues/3971 https://gitcode.com/cann/ops-math/issues/3969 https://gitcode.com/cann/ops-math/issues/3959 https://gitcode.com/cann/ops-math/issues/3957 https://gitcode.com/cann/ops-math/issues/3956 https://gitcode.com/cann/ops-math/issues/3950 https://gitcode.com/cann/ops-math/issues/3948 ## 测试 - 本 PR 仅修改资料与头文件注释，不涉及代码逻辑，未做代码测试； - 资料改动需通过仓库资料门禁/评审校验。 ## 文档更新 - `math/bitwise_not/docs/aclnnBitwiseNot.md`、`aclnnBitwiseNot_en.md` - `math/bitwise_or/docs/aclnnBitwiseOrScalar&aclnnInplaceBitwiseOrScalar.md`、`aclnnBitwiseOrScalar&aclnnInplaceBitwiseOrScalar_en.md` - `math/cdist_grad/docs/aclnnCdistBackward.md`、`aclnnCdistBackward_en.md` - `math/cholesky/docs/aclnnLinalgCholesky.md`、`aclnnLinalgCholesky_en.md` - `math/cummin/docs/aclnnCummin.md`、`aclnnCummin_en.md` - `math/grouped_bias_add_grad/docs/aclnnGroupedBiasAddGrad.md`、`aclnnGroupedBiasAddGrad_en.md` - `math/topk/docs/aclnnTopk.md`、`aclnnTopk_en.md`、`aclnnTopkV2.md`、`aclnnTopkV2_en.md` - 头文件注释：`math/bitwise_not/op_api/aclnn_bitwise_not.h`、`math/pow/op_api/aclnn_pow.h` ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!6781	12 days ago
examples	Cholesky示例改用C++ RAII资源管理，与IsFinite/IsInf示例风格对齐 Co-authored-by: zhouqilong<zhouqilong2@huawei.com> # message auto-generated for no-merge-commit merge: !4666 merge raii-cholesky into master Cholesky示例改用C++ RAII资源管理，与IsFinite/IsInf示例风格对齐 Created-by: zhou-qilong Commit-by: zhouqilong Merged-by: cann-robot Description: ## 描述将 `math/cholesky/examples` 下的 aclnn 示例由手动资源管理改为 C++ RAII 管理，与同仓 `math/is_finite`、`math/is_inf` 示例风格保持一致。 ## 测试 -Start to run examples, name:cholesky mode:eager Start compile and run examples file: ../math/cholesky/examples/test_aclnn_linalg_cholesky.cpp pkg_mode:cust vendor_name:cholesky result[0] is: 2.449490 result[1] is: 0.000000 result[2] is: 0.000000 result[3] is: -1.224745 result[4] is: 0.707107 result[5] is: 0.000000 result[6] is: 0.408248 result[7] is: 0.707107 result[8] is: 1.825742 run test_aclnn_cholesky, execute samples success ## 文档更新无。 ## 类型标签 - [x] 其他，请描述：示例代码改造（C++ RAII资源管理） See merge request: cann/ops-math!4666	2 months ago
op_api	fix: E9**内部错误码整改为正式语义码并保留内部异常EZ9999上报 Co-authored-by: chenyifeng<chenyifeng27@h-partners.com> # message auto-generated for no-merge-commit merge: !6606 merge fix_errorNum_1021 into master fix: E9***内部错误码整改为正式语义码并保留内部异常EZ9999上报 Created-by: chen_0715 Commit-by: chenyifeng Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 本次 PR 整改以下 43 个算子中非法使用的内部错误码（E9***），使其符合错误码使用规范： - cholesky / complex / cross / cummax / cummin / cumprod / get_shape / histogram_v2 / is_finite / is_inf - kl_div_v2 / lin_space / log_add_exp / non_finite_check / pdist / polar / pows / radix_top_k - reduce_log_sum / reduce_log_sum_exp / reduce_max / reduce_mean / reduce_mean_with_count / reduce_min - reduce_nansum / reduce_std_with_mean / rfft1_d / search_sorted / signbit / sin / sinc / sinkhorn / topk - affine_grid / amp_update_scale / angle_v2 / arg_max_v2 / arg_min / arg_min_with_value / atan2 / bessel_i1e / cdist_grad - conversion/tril 改动原因：上述算子 op_host / op_api / op_graph 源码中存在裸 OP_LOGE （EZ9999 兜底上报）、 OP_CHECK_NULL_WITH_CONTEXT / OP_CHECK_NOTNULL （EZ9999 上报）等不符合错误码使用规范的上报路径，需按失败原因分类整改为正式语义码或内部透传。采取的方法： - op_host 参数/输入校验类（shape / dtype / format / attr 值域等）裸 OP_LOGE → 正式语义宏（EZ0004 / EZ0008–EZ0038） - op_host 内部 API 失败类（平台能力查询、tiling API 失败等）→ OP_LOGE_WITHOUT_REPORT 透传，去掉 EZ9999 上报、保留日志 - OP_CHECK_NULL_WITH_CONTEXT （EZ9999）→ 显式空指针检查 + 正式码宏 - op_api OP_CHECK_NOTNULL （EZ9999）→ 显式检查 + OP_LOGE_WITHOUT_REPORT(ACLNN_ERR_INNER_NULLPTR) + 返回公共错误码 - op_api OP_LOGE(ACLNN_ERR_INNER_ / RUNTIME_ERROR) （561xxx / 361xxx）→ OP_LOGE_WITHOUT_REPORT ；正式参数码 ACLNN_ERR_PARAM_* （161xxx）保留 - 删除 CREATE_EXECUTOR 之后不可达的空指针死检查（ CHECK_RET(executor.get()!=nullptr, ACLNN_ERR_INNER_CREATE_EXECUTOR) ，40 处） - op_graph（histogram_v2 / reduce_mean 融合 pass）E9 上报 → 正式码或透传 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> https://gitcode.com/cann/ops-math/issues/3977 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> - 43 算子 op_host / op_api / op_graph 全量编译通过，exit 0（910b + 950/arch35） - 本地增加ut测试130 用例全量通过（910b 83 + 950 47），日志级验证触发 78 次正式 EZ 错误码上报，覆盖 14 个正式错误码 - 原版 math_op_host_ut 300 用例全量通过，无回归 - 静态复扫：范围内 E9*** 正式上报清零（残留均为 CHECK_RET 返回公共码 / 动态 return 等允许项） - 附：适配 CANN 9.3.0 atvoss 库 tiling key 编码变化，更新 reduce_max / reduce_mean_with_count 测试的 9 处 expectedTilingKey （官方 master 在 9.3.0 下同样失败，非本 PR 引入） ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [x] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!6606	14 days ago
op_graph	fix: 迁移Adds/Cholesky算子原型至对应目录 Co-authored-by: sunchun<sunchun4@h-partners.com> # message auto-generated for no-merge-commit merge: !5129 merge auto-fix/issue-2304-proto into master fix: 迁移Adds/Cholesky算子原型至对应目录 Created-by: sunchun Commit-by: sunchun Merged-by: cann-robot Description: ## 背景 issue #2304 指出公共头文件 op_math_proto_extend.h 中定义了一批算子原型，但其中部分算子已有独立目录，其原型应迁移至对应算子目录下的 op_graph 文件夹中。 ## 修改内容 1. 新建 math/adds/op_graph/adds_proto.h，将 Adds 算子原型从公共头迁移至此。 2. 新建 math/cholesky/op_graph/cholesky_proto.h，将 Cholesky 算子原型从公共头迁移至此。 3. 从 common/inc/op_graph/op_math_proto_extend.h 中移除 Adds、Cholesky、Pdist 的原型定义（Pdist 原型已在 experimental/math/pdist/op_graph/pdist_proto.h 中定义，无需修改）。 4. 更新依赖 Adds 原型的插件文件 include 引用路径。 5. 更新 math/adds/README.md 中的算子 IR 路径引用。 ## 验证方式 - 构建可正常通过，op_graph 下新 proto 文件由 cmake/func.cmake 自动收集。 - 通过 clang-format 与 OAT License Header 格式检查。 Closes #2304 See merge request: cann/ops-math!5129	2 months ago
op_host	fix: E9**内部错误码整改为正式语义码并保留内部异常EZ9999上报 Co-authored-by: chenyifeng<chenyifeng27@h-partners.com> # message auto-generated for no-merge-commit merge: !6606 merge fix_errorNum_1021 into master fix: E9***内部错误码整改为正式语义码并保留内部异常EZ9999上报 Created-by: chen_0715 Commit-by: chenyifeng Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 本次 PR 整改以下 43 个算子中非法使用的内部错误码（E9***），使其符合错误码使用规范： - cholesky / complex / cross / cummax / cummin / cumprod / get_shape / histogram_v2 / is_finite / is_inf - kl_div_v2 / lin_space / log_add_exp / non_finite_check / pdist / polar / pows / radix_top_k - reduce_log_sum / reduce_log_sum_exp / reduce_max / reduce_mean / reduce_mean_with_count / reduce_min - reduce_nansum / reduce_std_with_mean / rfft1_d / search_sorted / signbit / sin / sinc / sinkhorn / topk - affine_grid / amp_update_scale / angle_v2 / arg_max_v2 / arg_min / arg_min_with_value / atan2 / bessel_i1e / cdist_grad - conversion/tril 改动原因：上述算子 op_host / op_api / op_graph 源码中存在裸 OP_LOGE （EZ9999 兜底上报）、 OP_CHECK_NULL_WITH_CONTEXT / OP_CHECK_NOTNULL （EZ9999 上报）等不符合错误码使用规范的上报路径，需按失败原因分类整改为正式语义码或内部透传。采取的方法： - op_host 参数/输入校验类（shape / dtype / format / attr 值域等）裸 OP_LOGE → 正式语义宏（EZ0004 / EZ0008–EZ0038） - op_host 内部 API 失败类（平台能力查询、tiling API 失败等）→ OP_LOGE_WITHOUT_REPORT 透传，去掉 EZ9999 上报、保留日志 - OP_CHECK_NULL_WITH_CONTEXT （EZ9999）→ 显式空指针检查 + 正式码宏 - op_api OP_CHECK_NOTNULL （EZ9999）→ 显式检查 + OP_LOGE_WITHOUT_REPORT(ACLNN_ERR_INNER_NULLPTR) + 返回公共错误码 - op_api OP_LOGE(ACLNN_ERR_INNER_ / RUNTIME_ERROR) （561xxx / 361xxx）→ OP_LOGE_WITHOUT_REPORT ；正式参数码 ACLNN_ERR_PARAM_* （161xxx）保留 - 删除 CREATE_EXECUTOR 之后不可达的空指针死检查（ CHECK_RET(executor.get()!=nullptr, ACLNN_ERR_INNER_CREATE_EXECUTOR) ，40 处） - op_graph（histogram_v2 / reduce_mean 融合 pass）E9 上报 → 正式码或透传 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> https://gitcode.com/cann/ops-math/issues/3977 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> - 43 算子 op_host / op_api / op_graph 全量编译通过，exit 0（910b + 950/arch35） - 本地增加ut测试130 用例全量通过（910b 83 + 950 47），日志级验证触发 78 次正式 EZ 错误码上报，覆盖 14 个正式错误码 - 原版 math_op_host_ut 300 用例全量通过，无回归 - 静态复扫：范围内 E9*** 正式上报清零（残留均为 CHECK_RET 返回公共码 / 动态 return 等允许项） - 附：适配 CANN 9.3.0 atvoss 库 tiling key 编码变化，更新 reduce_max / reduce_mean_with_count 测试的 9 处 expectedTilingKey （官方 master 在 9.3.0 下同样失败，非本 PR 引入） ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [x] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!6606	14 days ago
op_kernel	perf(cholesky):cholesky算子新精度对齐GPU性能 Co-authored-by: Davon14272<liuwenda4@huawei.com> # message auto-generated for no-merge-commit merge: !5640 merge perf/cholesky-panel into master perf(cholesky):cholesky算子新精度对齐GPU性能 Created-by: Davon14272 Commit-by: Davon14272 Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 本 PR 是对 cholesky 算子（math/cholesky 模块）的性能优化，核心是重构 host 侧 cholesky_tiling.cpp 的核数分配与调度策略：将原先"单矩阵按面板块分核、批量按矩阵分核"的固定方式，统一为基于协同（cooperative）模式的调度——单矩阵或大维度批量时请求全核，按"面板分解由面板属主核串行、trailing Schur 更新按行条带铺满所有 AIV 核"的 right-looking 面板算法运行，并在 RunBigKernelTiling 中为协同模式配置 SetScheduleMode(1)（BATCH_MODE_SCHEDULE）以配合 SyncAll 全核同步。同时新增 SINGLE_MATRIX_SINGLE_CORE_MAX 与 BATCH_COOP_MIN_M 两个阈值：极小单矩阵保持单核以避免全核同步开销主导，小批量仍保持每矩阵一核。kernel 侧 cholesky.h 改动量最大，对应 PR 标题所述"通过上三角面板与转置统一 tril、批量协同"的算子实现。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!5640	1 month ago
tests	fix(cholesky): 修复 tiling UT compileInfo 栈缓冲区越界 Co-authored-by: Davon14272<liuwenda4@huawei.com> # message auto-generated for no-merge-commit merge: !6626 merge fix/cholesky-compile-info-overflow into master fix(cholesky): 修复 tiling UT compileInfo 栈缓冲区越界 Created-by: Davon14272 Commit-by: Davon14272 Merged-by: cann-robot Description: ## 问题 Cholesky host tiling UT 自定义了仅包含 `int32_t coreNum` 的局部 `CholeskyCompileInfo`。生产实现按包含 `coreNum` 和 `socSupportsPanel` 的 `optiling::CholeskyCompileInfo` 读取，导致 ASAN 在 `cholesky_tiling.cpp:143` 报告 `READ of size 1` 和 `stack-buffer-overflow`。 ## 修复 - 删除测试侧重复且布局不一致的 compile info 结构体 - 所有 Cholesky tiling 用例直接使用生产头文件中的 `optiling::CholeskyCompileInfo` - 显式初始化 `socSupportsPanel`，并在大单矩阵用例覆盖 panel 支持路径 ## 验证 - 未修复基线：ASAN 稳定复现 `stack-buffer-overflow`，定位 `cholesky_tiling.cpp:143` - 修复后相同用例：1/1 PASSED - 修复后 Cholesky host ASAN UT：7/7 PASSED - `git diff --check` 通过 See merge request: cann/ops-math!6626	18 days ago
CMakeLists.txt	剥离math下op_host/op_api到op_api Co-authored-by: yue-ma<mayue54@huawei.com> # message auto-generated for no-merge-commit merge: !4246 merge master into master 剥离math下op_host/op_api到op_api Created-by: yue-ma Commit-by: yue-ma Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 本次变更主要对 math 目录下多个算子的目录结构进行扁平化整理：将原先嵌套在 op_host/op_api/ 中的 API 实现文件直接提升到 op_api/ 层级 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> https://gitcode.com/cann/ops-math/issues/2392 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> UT/ST通过 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [x] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!4246	3 months ago
README.md	docs: 修正 math 算子 README 文档中的描述与数据类型说明 Co-authored-by: Nice_try<zhangzhiwei108@huawei.com> # message auto-generated for no-merge-commit merge: !6158 merge 3246 into master docs: 修正 math 算子 README 文档中的描述与数据类型说明 Created-by: Nice_try Commit-by: Nice_try Merged-by: cann-robot Description: ## 描述修正 math 目录下 13 个算子 README.md 文档中的描述问题，提升文档准确性与术语一致性，具体包括： - 数据类型说明修正：`abs` 输出类型列表去掉重复的 FLOAT16、FLOAT，改为 COMPLEX32、COMPLEX64；`assign_sub` 修正拼写 `BFOAT16` → `BFLOAT16`。 - 属性名拼写修正：`hans_encode` 的 `reshuff` → `reshuffle`。 - 术语大小写统一：`arg_min` 的 `infershape` → `InferShape`；`reduce_all` 的 `tenor` → `Tensor`。 - 表述/用词修正：`add_n` 的"主元素相加"→"逐元素相加"；`add_lora` 的"Lora"→"LoRa"；`cholesky` 的"需为"→"须为"；`cosine_similarity` 的"显示指定"→"显式指定"；`cumsum` 的"累计求和"→"累积求和"；`lgamma` 的"输入张量x1"→"输入张量x"；`mul_addn` 表述精简；`asinh_grad` 的"通过图模式方式调用"→"通过图模式调用"。 ### 改动原因文档中存在错别字、术语拼写与大小写不统一、数据类型说明错误等问题，影响可读性与准确性。 ### 改动方法逐文件校对并修正上述 README.md 中的文本与类型说明，仅涉及文档，不改变任何代码逻辑。 ## 关联的Issue #3426 ## 测试文档变更，无需代码测试。 ## 文档更新更新 math 目录下以下 13 个 README.md： math/abs、math/add_lora、math/add_n、math/arg_min、math/asinh_grad、math/assign_sub、math/cholesky、math/cosine_similarity、math/cumsum、math/hans_encode、math/lgamma、math/mul_addn、math/reduce_all ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!6158	1 month ago

Cholesky

产品支持情况

产品	是否支持
Ascend 950PR&950DT系列产品	√
Atlas A3系列产品	√
Atlas A2系列产品	√
Atlas 200I/500 A2推理产品	×
Atlas推理系列产品	×
Atlas训练系列产品	×

功能说明

算子功能：计算实数对称正定矩阵的Cholesky分解。
计算公式：
$\times out^{H}$

参数说明

参数名	输入/输出/属性	描述	数据类型	数据格式
self	输入	表示传入的tensor，公式中的self。	FLOAT	ND
upper	属性	表示选择上三角矩阵分解还是下三角矩阵分解。	BOOL	-
out	输出	表示传出的tensor，公式中的out。	FLOAT	ND

约束说明

self的维度必须大于等于2，并且须为正定矩阵。

调用说明

调用方式	调用样例	说明
aclnn调用	test_aclnn_linalg_cholesky	通过aclnnLinalgCholesky接口方式调用Cholesky算子。