pypto.loop_unroll#

产品支持情况#

产品	是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas A2 推理系列产品	√

pypto.loop_unroll是一个支持循环展开的循环迭代器函数，功能与pypto.loop类似，增加了unroll_list参数支持多个展开方式。

loop_unroll(*args, **kwargs) -> Iterator[Tuple[SymInt, int]]

参数名	输入/输出	说明
*args	输入	三个可选参数，分别为循环起始值（start），循环结束值（stop），循环步长（step），有以下三种写法： - 单参数形式：stop(SymInt)，起始值默认为0，步长默认为1。等价于：loop_unroll(0, stop, 1) - 双参数形式：start(SymInt)，stop(SymInt)，等价于loop_unroll(start, stop, 1) - 三参数形式：start (SymInt)，stop(SymInt)，step(SymInt)，等价于loop_unroll(start, stop, step)
**kwargs	输入	- name(str)：循环标识名称，默认生成f”loop_{loop_idx}”。 - idx_name(str): 循环索引变量的名称，默认生成f”loop_idx_{loop_idx}”。 - unroll_list(List[int]): 需要展开unroll的循环层数集合，默认为空集合。loop会提供等于该集合长度的几种展开方式，展开次数为n时，循环步长会变成step*n，每次迭代会执行n次循环体。每种展开次数会生成不同的代码路径。 - submit_before_loop(bool): 是否在循环开始前提交计算，默认为False。开启后会在循环开启前强制提交当前累积的计算任务到AICore执行。

返回一个迭代器，每次迭代产生一个元组（idx, unroll_factor)，idx表示当前循环的索引值，unroll_factor标识当前选择的展开方式。

for _ in pypto.loop_unroll(0, 10, 1, name="LOOP_L0_bIdx_mla_prolog", idx_name="b_idx", unroll_list=[1, 2, 4]):
   ...