perf: dispatch non-grouped bias-less topk routing methods to fused path (#49618)

Signed-off-by: jdebache <jdebache@nvidia.com>
This commit is contained in:
Julien Debache
2026-07-28 14:57:22 -07:00
committed by GitHub
parent 2899dca843
commit bb3b61f2fd
2 changed files with 160 additions and 24 deletions
+116
View File
@@ -8,9 +8,19 @@ import torch
from vllm._aiter_ops import rocm_aiter_ops
from vllm.distributed.eplb.eplb_state import EplbLayerState
from vllm.model_executor.layers.fused_moe.config import RoutingMethodType
from vllm.model_executor.layers.fused_moe.router.base_router import (
eplb_map_to_physical_and_record,
)
from vllm.model_executor.layers.fused_moe.router.fused_topk_bias_router import (
FusedTopKBiasRouter,
)
from vllm.model_executor.layers.fused_moe.router.fused_topk_router import (
FusedTopKRouter,
)
from vllm.model_executor.layers.fused_moe.router.grouped_topk_router import (
GroupedTopKRouter,
)
from vllm.model_executor.layers.fused_moe.router.router_factory import (
create_fused_moe_router,
)
@@ -36,6 +46,112 @@ TOP_KS = [2, 4, 6]
NUM_EXPERTS = [8, 16, 64]
def test_degenerate_grouped_config_uses_standard_topk() -> None:
router = create_fused_moe_router(
top_k=4,
global_num_experts=128,
use_grouped_topk=True,
num_expert_group=1,
topk_group=1,
scoring_func="softmax",
renormalize=True,
)
assert isinstance(router, FusedTopKRouter)
hidden_states, router_logits = make_test_data(32, 256, 128)
topk_weights, topk_ids = router.select_experts(hidden_states, router_logits)
baseline_weights, baseline_ids = baseline_fused_topk(
router_logits,
top_k=4,
renormalize=True,
)
assert_routing_results_close(
topk_weights,
topk_ids,
baseline_weights,
baseline_ids,
)
def test_multiple_expert_groups_use_grouped_topk() -> None:
router = create_fused_moe_router(
top_k=4,
global_num_experts=128,
use_grouped_topk=True,
num_expert_group=8,
topk_group=4,
scoring_func="softmax",
renormalize=True,
)
assert isinstance(router, GroupedTopKRouter)
def test_degenerate_grouped_config_with_bias_uses_topk_bias() -> None:
router = create_fused_moe_router(
top_k=4,
global_num_experts=128,
use_grouped_topk=True,
num_expert_group=1,
topk_group=1,
scoring_func="softmax",
renormalize=True,
e_score_correction_bias=torch.empty(128),
)
assert isinstance(router, FusedTopKBiasRouter)
def test_degenerate_grouped_config_with_bias_keeps_routed_scale() -> None:
router = create_fused_moe_router(
top_k=4,
global_num_experts=128,
use_grouped_topk=True,
num_expert_group=1,
topk_group=1,
scoring_func="softmax",
renormalize=True,
routed_scaling_factor=1.1,
e_score_correction_bias=torch.empty(128),
)
assert isinstance(router, FusedTopKBiasRouter)
assert router.routed_scaling_factor == 1.1
def test_degenerate_deepseek_v3_routing_stays_grouped() -> None:
router = create_fused_moe_router(
top_k=4,
global_num_experts=128,
use_grouped_topk=True,
num_expert_group=1,
topk_group=1,
scoring_func="sigmoid",
renormalize=True,
e_score_correction_bias=torch.empty(128),
)
assert isinstance(router, GroupedTopKRouter)
assert router.routing_method_type == RoutingMethodType.DeepSeekV3
def test_single_expert_group_with_non_unit_scale_uses_grouped_topk() -> None:
router = create_fused_moe_router(
top_k=4,
global_num_experts=128,
use_grouped_topk=True,
num_expert_group=1,
topk_group=1,
scoring_func="softmax",
renormalize=True,
routed_scaling_factor=1.1,
)
assert isinstance(router, GroupedTopKRouter)
def setup_eplb_state(
enable_eplb: bool, global_num_experts: int
) -> EplbLayerState | None: