Files
axolotl/tests/test_context_parallel_batch_size.py
Gilles Turpin 4b8bc52424 fix: correct total_num_steps and batch_size calculation with context parallelism (#3444)
* fix: correct total_num_steps and batch_size calculation with context parallelism

* feat: add test for CP batch size

---------

Co-authored-by: NanoCode012 <nano@axolotl.ai>
2026-03-05 12:33:28 -05:00

57 lines
1.7 KiB
Python

"""Tests for batch_size calculation with context parallelism."""
import sys
import types
import pytest
from axolotl.utils.config import normalize_config, validate_config
from axolotl.utils.dict import DictDefault
@pytest.fixture(name="cp_base_cfg")
def fixture_cp_base_cfg(min_base_cfg):
return (
DictDefault(
micro_batch_size=2,
gradient_accumulation_steps=4,
sequence_len=2048,
num_epochs=1,
flash_attention=True,
)
| min_base_cfg
)
class TestContextParallelBatchSize:
"""Verify batch_size scales by effective dp world_size when using context parallelism."""
@pytest.mark.parametrize(
"world_size, context_parallel_size, expected_batch_size",
[
(4, 1, 32), # no CP: 2*4*4 = 32
(4, 2, 16), # CP=2: 2*4*(4//2) = 16
(4, 4, 8), # CP=4: 2*4*(4//4) = 8
(2, 2, 8), # CP=ws: 2*4*(2//2) = 8 (no scaling)
],
)
def test_batch_size_with_context_parallelism(
self,
cp_base_cfg,
monkeypatch,
world_size,
context_parallel_size,
expected_batch_size,
):
monkeypatch.setenv("WORLD_SIZE", str(world_size))
# Mock ring_flash_attn since it's not installable on CPU,
# but required by schema validation when context_parallel_size > 1.
if "ring_flash_attn" not in sys.modules:
monkeypatch.setitem(
sys.modules, "ring_flash_attn", types.ModuleType("ring_flash_attn")
)
cp_base_cfg["context_parallel_size"] = context_parallel_size
cfg = validate_config(cp_base_cfg)
normalize_config(cfg)
assert cfg.batch_size == expected_batch_size