Coverage for  / home / jenkins / .local / lib / python3.10 / site-packages / hyper_parallel / components / functional / moe_token_unpermute.py: 100%

1# Copyright 2026 Huawei Technologies Co., Ltd 

2# 

3# Licensed under the Apache License, Version 2.0 (the "License"); 

4# you may not use this file except in compliance with the License. 

5# You may obtain a copy of the License at 

6# 

7# http://www.apache.org/licenses/LICENSE-2.0 

8# 

9# Unless required by applicable law or agreed to in writing, software 

10# distributed under the License is distributed on an "AS IS" BASIS, 

11# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 

12# See the License for the specific language governing permissions and 

13# limitations under the License. 

14# ============================================================================ 

15"""NPU MoE token unpermutation function.""" 

16 

17from typing import Optional 

18 

19import torch # pylint: disable=forbidden-backend-import 

20import torch_npu 

21 

22 

23def moe_token_unpermute( 

24 permuted_tokens: torch.Tensor, 

25 sorted_indices: torch.Tensor, 

26 probs: Optional[torch.Tensor] = None, 

27) -> torch.Tensor: 

28 """Restore expert-major tokens to token-major order. 

29 

30 Args: 

31 permuted_tokens: Expert outputs in expert-major order. 

32 sorted_indices: Sorting indices returned by :func:`moe_token_permute`. 

33 probs: Optional routing probabilities applied while restoring tokens. 

34 

35 Returns: 

36 Restored token-major output with repeated token routes accumulated. 

37 """ 

38 return torch_npu.npu_moe_token_unpermute(permuted_tokens, sorted_indices, probs)