cann-robotdocs(bincount): clarify zero-based output index

Files	Last commit	Last update
docs	docs(bincount): clarify zero-based output index Co-authored-by: zhouyuanhang30083383<zhouyuanhang4@h-partners.com> # message auto-generated for no-merge-commit merge: !7267 merge codex/docs-bincount-zero-based-index-3961 into master docs(bincount): clarify zero-based output index Created-by: m0_55003149 Commit-by: zhouyuanhang30083383 Merged-by: cann-robot Description: ## 描述 `aclnnBincount` 的实际行为、计算公式和头文件契约均使用零基下标：值为 `v` 的元素累加到 `out[v]`，不存在 `+1` 偏移。输出长度仍应为 `max(max(self) + 1, minlength)`。上游已移除中文主文档中的 `self[i]+1`，但英文 API 文档和英文 README 仍保留错误表述；中文原句也可按维护者建议进一步明确为“下标为 `self[i]`”。 ## 关联的Issue https://gitcode.com/cann/ops-math/issues/3961 ## 测试不涉及代码逻辑改动 ## 文档更新 - `math/bincount/docs/aclnnBincount.md` - `math/bincount/docs/aclnnBincount_en.md` - `math/bincount/README.md` - `math/bincount/README_en.md` ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!7267	4 days ago
examples	Bincount示例改用C++ RAII资源管理，与IsFinite/IsInf示例风格对齐 Co-authored-by: zhouqilong<zhouqilong2@huawei.com> # message auto-generated for no-merge-commit merge: !4657 merge raii-bincount into master Bincount示例改用C++ RAII资源管理，与IsFinite/IsInf示例风格对齐 Created-by: zhou-qilong Commit-by: zhouqilong Merged-by: cann-robot Description: ## 描述将 `math/bincount/examples` 下的 aclnn 示例由手动资源管理改为 C++ RAII 管理，与同仓 `math/is_finite`、`math/is_inf` 示例风格保持一致。 ## 关联的Issue https://gitcode.com/cann/ops-math/issues/2654 ## 测试未在 Ascend 环境实际编译运行；改动结构与已合并的 `is_inf`（PR #4531）一致。 ## 文档更新无。 ## 类型标签 - [x] 其他，请描述：示例代码改造（C++ RAII资源管理） See merge request: cann/ops-math!4657	2 months ago
framework	迁移开源TF插件--math Co-authored-by: yaochen<yaochen15@huawei.com> # message auto-generated for no-merge-commit merge: !4308 merge transfer-math into master 迁移开源TF插件--math Created-by: nextyale Commit-by: yaochen Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：迁移TF插件 See merge request: cann/ops-math!4308	3 months ago
op_api	some aclnn add format warning Co-authored-by: chenxingyu18<chenxingyu18@huawei.com> # message auto-generated for no-merge-commit merge: !1524 merge master into master some aclnn add format warning Created-by: chenxingyu18 Commit-by: chenxingyu18 Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> acos/add/asin/asinh/atan/atanh/bincount/cos/ger/sin/sinh/tan/tanh等接口增加资料中不支持的数据格式输入时的warning日志 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> https://gitcode.com/cann/ops-math/issues/894 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> 通过功能测试 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!1524	8 months ago
op_graph	docs(bincount): 修正输出下标描述并完善公共契约 Co-authored-by: huang-qiang<huangqiang3@huawei.com> # message auto-generated for no-merge-commit merge: !6609 merge agent/issue-134 into master docs(bincount): 修正输出下标描述并完善公共契约 Created-by: huang-qiang Commit-by: huang-qiang Merged-by: cann-robot Description: ## 描述 ### 整改说明依据 CannBot 算子验证报告整改非 P1 问题。 - 报告编号：upload-20260924025505-bincount-4a5587f8 - 基线 commit：b386997ad - 算子：Bincount / aclnnBincount ### 整改项清单本次为文档类整改（非 P1 问题），仅修正文档与算子 IR 原型注释；未触碰 golden、测试资产、config 配置与支持产品矩阵： - `math/bincount/README.md`：修正功能说明中 out 存储位置的 off-by-one（self[i]+1 → self[i]）；补齐输出长度上限（2147483647）、空 Tensor、动态 shape、确定性计算、错误码与拒绝行为、输出长度语义等公共契约；对齐调用方式术语与参数表列宽。 - `math/bincount/docs/aclnnBincount.md`：同上修正 off-by-one；补齐 minlength/out 取值上限、错误码表、约束说明（输出长度/取值范围/空 Tensor/动态 shape）。 - `math/bincount/op_graph/bincount_proto.h`：补齐 @par Inputs 调用方义务（0<=value<size、size 编译期常量）、@attention dtype 域差异说明、TensorFlow 插件说明。 ### 验证结论 - golden / ST 用例 / tiling UT 相对基线 b386997ad 均为零净差异（字节一致），未新增、删除、禁用、改写任何用例或期望值。 - pre-commit 校验通过（trailing-whitespace / end-of-file / clang-format / ruff / codespell / OAT）。 - 无 binary_config / simplified_key.ini / *_def.cpp / soc / CMakeLists / OAT.xml 等构建与配置改动，无受支持产品型号增删升降。 ## 关联的Issue - #4572 bincount 依据 CannBot 算子验证报告整改非 P1 问题（upload-20260924025505-bincount-4a5587f8） ## 测试 - 文档类整改，无算子逻辑改动，无需上板冒烟。 - 相对基线 diff 仅含 3 个文档文件；golden / 测试资产零差异。 ## 文档更新 - `math/bincount/README.md` - `math/bincount/docs/aclnnBincount.md` - `math/bincount/op_graph/bincount_proto.h` ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!6609	8 days ago
op_host	feat: bincount/adjacent_difference 新增 ascend960dt/ascend960pr 注册级支持 Co-authored-by: caorenlei<caorenlei@huawei.com> # message auto-generated for no-merge-commit merge: !6388 merge 1010 into master feat: bincount/adjacent_difference 新增 ascend960dt/ascend960pr 注册级支持 Created-by: caorenlei Commit-by: caorenlei Merged-by: cann-robot Description: ## 描述 bincount、adjacent_difference 两算子新增 ascend960dt/ascend960pr 平台注册级支持（v121 适配）。 ### 改动原因 Ascend960 系列平台上线，算子需同步支持 ascend960dt/ascend960pr 计算单元；适配增量同步自内部仓 cann_out 分支，在 OSS master 基线上叠加。 ### 改动方法（注册级适配，kernel/tiling/aclnn 零改动） 1. def.cpp 注册（2 文件）：bincount_def.cpp、adjacent_difference_def.cpp 在既有 `AddConfig("ascend950"/"ascend350")` 后追加 `AddConfig("ascend960dt", aicoreConfig)` 与 `AddConfig("ascend960pr", aicoreConfig)`，复用同一 aicoreConfig，保留 ascend350 注册不删 2. config 配置（8 个新增文件）：新增 `op_host/config/ascend960dt/`、`op_host/config/ascend960pr/`（2 算子 × 2 芯片 × binary.json + simplified_key.ini），内容与既有 ascend950 配置逐字节一致 3. CMakeLists（2 文件）：SUPPORT_COMPUTE_UNIT 追加 `"ascend960dt" "ascend960pr"`，SUPPORT_TILING_DIR 等量追加 `"arch35"`（tiling 复用 arch35） 4. ascendc_config.json：Bincount、AdjacentDifference 条目 compute_units 追加 `"ascend960dt"`，compile_options 镜像 ascend950（`-mllvm -cce-aicore-dcci-before-kernel-end=false`） 5. .pre-commit-config.yaml：codespell 忽略列表追加 `build-in`（config 镜像中 ascend950 既有注释拼写，内容须与 950 逐字节一致不可修改） ## 关联的Issue - #3598 ## 测试 1. ascend950 编译出包：`bash build.sh --pkg --soc=ascend950 --ops=bincount,adjacent_difference -j8` 通过；包内 950 内核齐全（23 个 .o），`aic-ascend960dt-ops-info.json` 含 Bincount、AdjacentDifference 注册（960 注册生效核验） 2. 950 kernel 零影响硬证据：适配前后两次编译，23 个 ascend950 kernel .o SHA256 逐字节一致（bit 级不变） 3. ttk 精度回归 386/386 全 PASS（Ascend950PR_9579，release 模式，seed=123）： - bincount（kernel 级）192/192、adjacent_difference（kernel 级）81/81、aclnnBincount（API 级）113/113 - 正控 PASS / 负控 FAIL，判定链路自证有效 ## 文档更新无 ## 类型标签 - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!6388	29 days ago
op_kernel	fix(docs): 修正 bincount/angle_v2/top_k_v2 中 ouput 拼写（应为 output） Co-authored-by: gcw_LxlU8H9L<opengoodai@163.com> # message auto-generated for no-merge-commit merge: !5948 merge fix/3293-output-typos into master fix(docs): 修正 bincount/angle_v2/top_k_v2 中 ouput 拼写（应为 output） Created-by: gcw_LxlU8H9L Commit-by: OpenGood_WeChat;gcw_LxlU8H9L Merged-by: cann-robot Description: ## 描述 bincount 两个 kernel 文件注释（3 处）、angle_v2 tiling 注释（7 处同型）及 top_k_v2 未使用参数名 ouputLastDimValue 中，output 均被拼写为 ouput。统一修正，仅涉及注释与未使用参数名，不影响任何逻辑。 ## 关联的Issue 关联Issue #3293（注：issue 中抽样 2 处，angle_v2 实际含 7 处同型注释，已一并修复，全仓该模式已清零） ## 测试 - 纯注释文本与未使用参数名修正，不涉及任何代码逻辑变化 ## 文档更新无 ## 类型标签 <!-- [x] 表示选中 --> - [x] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： ## AI/Agent生成声明 <!-- [x] 表示选中 --> - [x] AI辅助编写 See merge request: cann/ops-math!5948	1 month ago
tests	add aclnn golden Co-authored-by: gcw_CRjbEjwl<fengdaoyong@h-partners.com> # message auto-generated for no-merge-commit merge: !4593 merge 20260812 into master add aclnn golden Created-by: gcw_CRjbEjwl Commit-by: gcw_CRjbEjwl Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 算子增加aclnn的golden注册函数，由冒烟流水调用，跑新版ttk用例。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #000--> 不涉及 ## 测试 <!--描述进行了哪些测试来验证你的改动。--> 本地完成验证 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> 不涉及 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述： See merge request: cann/ops-math!4593	2 months ago
CMakeLists.txt	feat: bincount/adjacent_difference 新增 ascend960dt/ascend960pr 注册级支持 Co-authored-by: caorenlei<caorenlei@huawei.com> # message auto-generated for no-merge-commit merge: !6388 merge 1010 into master feat: bincount/adjacent_difference 新增 ascend960dt/ascend960pr 注册级支持 Created-by: caorenlei Commit-by: caorenlei Merged-by: cann-robot Description: ## 描述 bincount、adjacent_difference 两算子新增 ascend960dt/ascend960pr 平台注册级支持（v121 适配）。 ### 改动原因 Ascend960 系列平台上线，算子需同步支持 ascend960dt/ascend960pr 计算单元；适配增量同步自内部仓 cann_out 分支，在 OSS master 基线上叠加。 ### 改动方法（注册级适配，kernel/tiling/aclnn 零改动） 1. def.cpp 注册（2 文件）：bincount_def.cpp、adjacent_difference_def.cpp 在既有 `AddConfig("ascend950"/"ascend350")` 后追加 `AddConfig("ascend960dt", aicoreConfig)` 与 `AddConfig("ascend960pr", aicoreConfig)`，复用同一 aicoreConfig，保留 ascend350 注册不删 2. config 配置（8 个新增文件）：新增 `op_host/config/ascend960dt/`、`op_host/config/ascend960pr/`（2 算子 × 2 芯片 × binary.json + simplified_key.ini），内容与既有 ascend950 配置逐字节一致 3. CMakeLists（2 文件）：SUPPORT_COMPUTE_UNIT 追加 `"ascend960dt" "ascend960pr"`，SUPPORT_TILING_DIR 等量追加 `"arch35"`（tiling 复用 arch35） 4. ascendc_config.json：Bincount、AdjacentDifference 条目 compute_units 追加 `"ascend960dt"`，compile_options 镜像 ascend950（`-mllvm -cce-aicore-dcci-before-kernel-end=false`） 5. .pre-commit-config.yaml：codespell 忽略列表追加 `build-in`（config 镜像中 ascend950 既有注释拼写，内容须与 950 逐字节一致不可修改） ## 关联的Issue - #3598 ## 测试 1. ascend950 编译出包：`bash build.sh --pkg --soc=ascend950 --ops=bincount,adjacent_difference -j8` 通过；包内 950 内核齐全（23 个 .o），`aic-ascend960dt-ops-info.json` 含 Bincount、AdjacentDifference 注册（960 注册生效核验） 2. 950 kernel 零影响硬证据：适配前后两次编译，23 个 ascend950 kernel .o SHA256 逐字节一致（bit 级不变） 3. ttk 精度回归 386/386 全 PASS（Ascend950PR_9579，release 模式，seed=123）： - bincount（kernel 级）192/192、adjacent_difference（kernel 级）81/81、aclnnBincount（API 级）113/113 - 正控 PASS / 负控 FAIL，判定链路自证有效 ## 文档更新无 ## 类型标签 - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!6388	29 days ago
README.md	docs(bincount): clarify zero-based output index Co-authored-by: zhouyuanhang30083383<zhouyuanhang4@h-partners.com> # message auto-generated for no-merge-commit merge: !7267 merge codex/docs-bincount-zero-based-index-3961 into master docs(bincount): clarify zero-based output index Created-by: m0_55003149 Commit-by: zhouyuanhang30083383 Merged-by: cann-robot Description: ## 描述 `aclnnBincount` 的实际行为、计算公式和头文件契约均使用零基下标：值为 `v` 的元素累加到 `out[v]`，不存在 `+1` 偏移。输出长度仍应为 `max(max(self) + 1, minlength)`。上游已移除中文主文档中的 `self[i]+1`，但英文 API 文档和英文 README 仍保留错误表述；中文原句也可按维护者建议进一步明确为“下标为 `self[i]`”。 ## 关联的Issue https://gitcode.com/cann/ops-math/issues/3961 ## 测试不涉及代码逻辑改动 ## 文档更新 - `math/bincount/docs/aclnnBincount.md` - `math/bincount/docs/aclnnBincount_en.md` - `math/bincount/README.md` - `math/bincount/README_en.md` ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!7267	4 days ago
README_en.md	docs(bincount): clarify zero-based output index Co-authored-by: zhouyuanhang30083383<zhouyuanhang4@h-partners.com> # message auto-generated for no-merge-commit merge: !7267 merge codex/docs-bincount-zero-based-index-3961 into master docs(bincount): clarify zero-based output index Created-by: m0_55003149 Commit-by: zhouyuanhang30083383 Merged-by: cann-robot Description: ## 描述 `aclnnBincount` 的实际行为、计算公式和头文件契约均使用零基下标：值为 `v` 的元素累加到 `out[v]`，不存在 `+1` 偏移。输出长度仍应为 `max(max(self) + 1, minlength)`。上游已移除中文主文档中的 `self[i]+1`，但英文 API 文档和英文 README 仍保留错误表述；中文原句也可按维护者建议进一步明确为“下标为 `self[i]`”。 ## 关联的Issue https://gitcode.com/cann/ops-math/issues/3961 ## 测试不涉及代码逻辑改动 ## 文档更新 - `math/bincount/docs/aclnnBincount.md` - `math/bincount/docs/aclnnBincount_en.md` - `math/bincount/README.md` - `math/bincount/README_en.md` ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!7267	4 days ago

Bincount

English | 简体中文

Product Support Status

Product	Supported
Ascend 950PR&950DT products	√
Atlas A3 products	√
Atlas A2 products	√
Atlas 200I/500 A2 inference products	×
Atlas inference products	√
Atlas training products	√

Function Description

Operator function: computes the frequency of each number in an array of non-negative integers. minlength is the minimum size of the output tensor. When weights is a null pointer, the frequency increases by 1 each time self[i] in self occurs. When weights is not empty, the frequency increases by weights[i] each time self[i] occurs. The result is finally stored at index self[i] in out. Therefore, the size of out is the maximum of (the maximum value in self + 1) and minlength.
Computation formula:

If n is the value of self at position i and weights is specified:
$out[self_i] = out[self_i] + weights_i$
Otherwise:
$out[self_i] = out[self_i] + 1$

Parameter Description

Parameter Name	Input/Output/Attribute	Description	Data Type	Data Format
array	Input	Input tensor, which is self_i in the formula.	INT32	ND
size	Input	Specifies the minimum length of the output tensor.	INT32	ND
weights	Input	Weight of the input tensor, which is weights_i in the formula.	FLOAT	ND
bins	Output	Output tensor, which is out_i in the formula.	FLOAT	ND

Constraint Description

The value of the input size must be greater than or equal to the maximum value of the input array plus 1
The length of the output bins must be equal to the value of size

Invocation Description

Invocation Method	Invocation Sample	Description
aclnn invocation	test_aclnn_bincount	Invokes the Bincount operator through the aclnnBincount API.