cann-robotdocs: add English translations for markdown files

Files	Last commit	Last update
examples	fix(examples): 删除geir样例中与ops_proto_math.h重复的本地Data/Const/Identity注册 Co-authored-by: Dazhou_Cao<caodazhou@huawei.com> # message auto-generated for no-merge-commit merge: !7000 merge fix/geir-example-duplicate-reg into master fix(examples): 删除geir样例中与ops_proto_math.h重复的本地Data/Const/Identity注册 Created-by: Dazhou_Cao Commit-by: Dazhou_Cao Merged-by: cann-robot Description: ## 描述 ge/data、ge/const、conversion/identity 迁入 ops-math 后，`ops_proto_math.h`（由 `merge_proto.py` 合并全仓算子 proto 生成）已包含 `REG_OP(Data)` / `REG_OP(Const)` / `REG_OP(Identity)`（带 `OPS_PROTO_DEF_*` 守卫）。部分迁移早期交付的 GEIR 样例（编写时上述算子尚未入库）在样例内写了无守卫的本地 `REG_OP` 注册，与合并头同处一个编译单元，导致类重定义编译错误： `error: redefinition of 'class ge::op::Data'（如 test_geir_stop_gradient.cpp:25 与 ops_proto_math.h 冲突）` 本 PR 删除 12 个受影响样例的本地注册块，改用合并头定义，与仓库既有正常样例（math/rank、conversion/size、ge/case、ge/for 等）模式一致： \| 目录 \| 样例 \| 删除的本地注册 \| \|---\|---\|---\| \| conversion \| stop_gradient / snapshot / prevent_gradient / identity / identity_n / flatten_v2 / trans_shape / phony_concat / phony_split \| Data \| \| conversion \| expand_dims \| Data + Const \| \| ge \| control_trigger / no_op \| Data + Identity \| 样例中 `op::Data` / `op::Const` / `op::Identity` 的使用处均不变。 ## 关联的Issue 不涉及 ## 测试 - 按构建逻辑用当前 HEAD 的 370 个算子 proto + `op_math_proto_extend.h` 重新生成合并头（与构建产物一致，含 Data/Const/Identity 定义）。 - 12 个受影响样例逐一完整编译+链接（`g++ -D_GLIBCXX_USE_CXX11_ABI=0`，链接 `-lgraph -lge_runner -lgraph_base -lge_compiler`）：12/12 通过，0 error，均生成可执行文件。 - 排查其余样例：16 个仅 include 自身算子 proto 的自包含样例（本地注册 Data，不引用合并头）无编译冲突，保持原样未改动；math/pdist（本地注册 Pdist）同理。 ## 文档更新不涉及 See merge request: cann/ops-math!7000	10 days ago
op_graph	feat: 迁移gelocal控制流与基础算子交付件（含While/If/Case/For/PartitionedCall、TF控制流插件、reshape），实现RT2.0交付 Co-authored-by: Dazhou_Cao<caodazhou@huawei.com> # message auto-generated for no-merge-commit merge: !6621 merge migrate-gelocal-delivery into master feat: 迁移gelocal控制流与基础算子交付件（含While/If/Case/For/PartitionedCall、TF控制流插件、reshape），实现RT2.0交付 Created-by: Dazhou_Cao Commit-by: Dazhou_Cao Merged-by: cann-robot Description: ## 描述汇总迁移 gelocal（RT2.0）算子交付件： - 基础/GE 控制流算子：size、rank、LoopCond、NextIteration、RefIdentity、SwitchByIndex、aipp_data、End、squeezev2、unsqueezev2，以及 enter/exit/merge/switch/switch_n/ref_* 等 - 子图控制流算子：If、Case、For、PartitionedCall、While（原型注册 + RT2.0 推导注册 + UT + README，If/Case/For/PartitionedCall 含 GeIR 示例；均归入 ge 分类） - TF 控制流插件：If/_If/StatelessIf、While/_While/StatelessWhile、Case/StatelessCase、PartitionedCall/StatefulPartitionedCall 变体合并映射 - reshape：infershape 对齐 RT1.0 语义、allowzero/shape 属性注册、信息库 - 文档：README 产品支持表统一（全部√）、gather_shapes 归入 conversion、op_list 同步登记 ## 测试 - `bash build.sh --ophost --opgraph -j8` 构建通过（含各算子 REG_OP 注册校验） - 宿主侧全量 UT：2594/2594 PASSED（384 test suites） ## 说明 - 内容汇总自此前迁移 PR（6474 / 6522 / 6208）的交付件，本 PR 为其合并后的统一交付 See merge request: cann/ops-math!6621	19 days ago
op_host	feat: 迁移gelocal控制流与基础算子交付件（含While/If/Case/For/PartitionedCall、TF控制流插件、reshape），实现RT2.0交付 Co-authored-by: Dazhou_Cao<caodazhou@huawei.com> # message auto-generated for no-merge-commit merge: !6621 merge migrate-gelocal-delivery into master feat: 迁移gelocal控制流与基础算子交付件（含While/If/Case/For/PartitionedCall、TF控制流插件、reshape），实现RT2.0交付 Created-by: Dazhou_Cao Commit-by: Dazhou_Cao Merged-by: cann-robot Description: ## 描述汇总迁移 gelocal（RT2.0）算子交付件： - 基础/GE 控制流算子：size、rank、LoopCond、NextIteration、RefIdentity、SwitchByIndex、aipp_data、End、squeezev2、unsqueezev2，以及 enter/exit/merge/switch/switch_n/ref_* 等 - 子图控制流算子：If、Case、For、PartitionedCall、While（原型注册 + RT2.0 推导注册 + UT + README，If/Case/For/PartitionedCall 含 GeIR 示例；均归入 ge 分类） - TF 控制流插件：If/_If/StatelessIf、While/_While/StatelessWhile、Case/StatelessCase、PartitionedCall/StatefulPartitionedCall 变体合并映射 - reshape：infershape 对齐 RT1.0 语义、allowzero/shape 属性注册、信息库 - 文档：README 产品支持表统一（全部√）、gather_shapes 归入 conversion、op_list 同步登记 ## 测试 - `bash build.sh --ophost --opgraph -j8` 构建通过（含各算子 REG_OP 注册校验） - 宿主侧全量 UT：2594/2594 PASSED（384 test suites） ## 说明 - 内容汇总自此前迁移 PR（6474 / 6522 / 6208）的交付件，本 PR 为其合并后的统一交付 See merge request: cann/ops-math!6621	19 days ago
tests	feat: 迁移gelocal控制流与基础算子交付件（含While/If/Case/For/PartitionedCall、TF控制流插件、reshape），实现RT2.0交付 Co-authored-by: Dazhou_Cao<caodazhou@huawei.com> # message auto-generated for no-merge-commit merge: !6621 merge migrate-gelocal-delivery into master feat: 迁移gelocal控制流与基础算子交付件（含While/If/Case/For/PartitionedCall、TF控制流插件、reshape），实现RT2.0交付 Created-by: Dazhou_Cao Commit-by: Dazhou_Cao Merged-by: cann-robot Description: ## 描述汇总迁移 gelocal（RT2.0）算子交付件： - 基础/GE 控制流算子：size、rank、LoopCond、NextIteration、RefIdentity、SwitchByIndex、aipp_data、End、squeezev2、unsqueezev2，以及 enter/exit/merge/switch/switch_n/ref_* 等 - 子图控制流算子：If、Case、For、PartitionedCall、While（原型注册 + RT2.0 推导注册 + UT + README，If/Case/For/PartitionedCall 含 GeIR 示例；均归入 ge 分类） - TF 控制流插件：If/_If/StatelessIf、While/_While/StatelessWhile、Case/StatelessCase、PartitionedCall/StatefulPartitionedCall 变体合并映射 - reshape：infershape 对齐 RT1.0 语义、allowzero/shape 属性注册、信息库 - 文档：README 产品支持表统一（全部√）、gather_shapes 归入 conversion、op_list 同步登记 ## 测试 - `bash build.sh --ophost --opgraph -j8` 构建通过（含各算子 REG_OP 注册校验） - 宿主侧全量 UT：2594/2594 PASSED（384 test suites） ## 说明 - 内容汇总自此前迁移 PR（6474 / 6522 / 6208）的交付件，本 PR 为其合并后的统一交付 See merge request: cann/ops-math!6621	19 days ago
CMakeLists.txt	feat: 迁移gelocal控制流与基础算子交付件（含While/If/Case/For/PartitionedCall、TF控制流插件、reshape），实现RT2.0交付 Co-authored-by: Dazhou_Cao<caodazhou@huawei.com> # message auto-generated for no-merge-commit merge: !6621 merge migrate-gelocal-delivery into master feat: 迁移gelocal控制流与基础算子交付件（含While/If/Case/For/PartitionedCall、TF控制流插件、reshape），实现RT2.0交付 Created-by: Dazhou_Cao Commit-by: Dazhou_Cao Merged-by: cann-robot Description: ## 描述汇总迁移 gelocal（RT2.0）算子交付件： - 基础/GE 控制流算子：size、rank、LoopCond、NextIteration、RefIdentity、SwitchByIndex、aipp_data、End、squeezev2、unsqueezev2，以及 enter/exit/merge/switch/switch_n/ref_* 等 - 子图控制流算子：If、Case、For、PartitionedCall、While（原型注册 + RT2.0 推导注册 + UT + README，If/Case/For/PartitionedCall 含 GeIR 示例；均归入 ge 分类） - TF 控制流插件：If/_If/StatelessIf、While/_While/StatelessWhile、Case/StatelessCase、PartitionedCall/StatefulPartitionedCall 变体合并映射 - reshape：infershape 对齐 RT1.0 语义、allowzero/shape 属性注册、信息库 - 文档：README 产品支持表统一（全部√）、gather_shapes 归入 conversion、op_list 同步登记 ## 测试 - `bash build.sh --ophost --opgraph -j8` 构建通过（含各算子 REG_OP 注册校验） - 宿主侧全量 UT：2594/2594 PASSED（384 test suites） ## 说明 - 内容汇总自此前迁移 PR（6474 / 6522 / 6208）的交付件，本 PR 为其合并后的统一交付 See merge request: cann/ops-math!6621	19 days ago
README.md	feat: 迁移gelocal控制流与基础算子交付件（含While/If/Case/For/PartitionedCall、TF控制流插件、reshape），实现RT2.0交付 Co-authored-by: Dazhou_Cao<caodazhou@huawei.com> # message auto-generated for no-merge-commit merge: !6621 merge migrate-gelocal-delivery into master feat: 迁移gelocal控制流与基础算子交付件（含While/If/Case/For/PartitionedCall、TF控制流插件、reshape），实现RT2.0交付 Created-by: Dazhou_Cao Commit-by: Dazhou_Cao Merged-by: cann-robot Description: ## 描述汇总迁移 gelocal（RT2.0）算子交付件： - 基础/GE 控制流算子：size、rank、LoopCond、NextIteration、RefIdentity、SwitchByIndex、aipp_data、End、squeezev2、unsqueezev2，以及 enter/exit/merge/switch/switch_n/ref_* 等 - 子图控制流算子：If、Case、For、PartitionedCall、While（原型注册 + RT2.0 推导注册 + UT + README，If/Case/For/PartitionedCall 含 GeIR 示例；均归入 ge 分类） - TF 控制流插件：If/_If/StatelessIf、While/_While/StatelessWhile、Case/StatelessCase、PartitionedCall/StatefulPartitionedCall 变体合并映射 - reshape：infershape 对齐 RT1.0 语义、allowzero/shape 属性注册、信息库 - 文档：README 产品支持表统一（全部√）、gather_shapes 归入 conversion、op_list 同步登记 ## 测试 - `bash build.sh --ophost --opgraph -j8` 构建通过（含各算子 REG_OP 注册校验） - 宿主侧全量 UT：2594/2594 PASSED（384 test suites） ## 说明 - 内容汇总自此前迁移 PR（6474 / 6522 / 6208）的交付件，本 PR 为其合并后的统一交付 See merge request: cann/ops-math!6621	19 days ago
README_en.md	docs: add English translations for markdown files Co-authored-by: jenny_xiang<jenny.xiang@huawei.com> # message auto-generated for no-merge-commit merge: !7113 merge docs/add-english-translations into master docs: add English translations for markdown files Created-by: jenny_xiang Commit-by: jenny_xiang Merged-by: cann-robot Description: ## 描述新增仓库Markdown文档英文译稿（第二批，共409个文件）：第一批（已合入）之外的其余全部译稿，覆盖conversion、examples、ge、math、random各类算子README译稿，以及CHANGELOG_en.md、.gitcode PR模板英文版等。本批内全部仓内链接均指向master已有文件（含第一批已合入的21+2篇译稿），合入后本仓432篇英文文档全部就位，链接完整生效。本批同时包含4篇基于最新源文档的增量更新（math/ada_cast、math/prod_force_se_a、math/sinkhorn、math/xlogy，对应上游近期文档变更）。 ## 关联的Issue 无 ## 测试文档类变更，无需算子测试；已通过链接有效性校验（本批全部相对链接仅指向master已有文件，无指向本PR外未提交文件的链接），并完成逐篇翻译规范自查与语义校对（含支持状态表、限定词、术语、数值符号核对）。 ## 文档更新新增409个英文译稿文件（*_en.md / .en-US.md），不修改任何现有文件。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!7113	9 days ago

SwitchN

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

SwitchN is a basic control flow operator. It forwards the input tensor data to the corresponding output port based on the integer tensor input pred_value. output is a dynamic output, in which only one output receives data, and its shape and data type are the same as those of the input data. This operator usually works with the Merge operator to implement multi-way branch control.

Parameter Description

Parameter Name	Input/Output/Attribute	Description	Data Type	Data Format
data	Input	The tensor to be forwarded.	float16, float32, float64, int8, int16, int32, int64, uint8, uint16, uint32, uint64, bool	ND
pred_value	Input	An int64 tensor that determines the output port to which the data is forwarded.	DT_INT64	ND
output	Dynamic output	Output tensors, one of which receives data. The data type is the same as that of data.	float16, float32, float64, int8, int16, int32, int64, uint8, uint16, uint32, uint64, bool	ND

Constraint Description

The data type of the input data must be one of float16, float32, float64, int8, int16, int32, int64, uint8, uint16, uint32, uint64, bool.
The data type of the input pred_value must be DT_INT64.

Invocation Description

The SwitchN operator is a basic control flow operator. It is usually used as a multi-way branch selection node in a graph, and is not invoked separately.

Invocation Method	Invocation Sample	Description
Graph-mode invocation	test_geir_switch_n	Invokes the SwitchN operator by building a graph through the operator IR.