From b4a6abf0d7d4166e244e4c8f0faef4f1c4bb2589 Mon Sep 17 00:00:00 2001 From: xueyuan Date: Mon, 1 Jun 2026 10:27:08 +0800 Subject: [PATCH] docs: add scalability guidance Signed-off-by: xueyuan --- docs/user_manual/performance-guide.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/user_manual/performance-guide.md b/docs/user_manual/performance-guide.md index a25f18ef5..97b83702d 100644 --- a/docs/user_manual/performance-guide.md +++ b/docs/user_manual/performance-guide.md @@ -17,6 +17,14 @@ It remains performant, even when doing calculations with one or a combination of To achieve that high performance, several optimizations are made. To use those optimizations to the fullest, we recommend our users to follow the following guidelines. +## Scalability + +The calculation workload generally depends on the number of connected grid elements and on the network topology. +For radial distribution grids, most calculation steps scale close to linearly with grid size. +Meshed grids require more coupling between buses and branches, so some steps can scale less favorably. +In both cases, runtime and memory usage are also affected by the number of batch scenarios, the amount of update data per +scenario, and whether the topology can be reused between scenarios. + ```{note} This guide focuses on system-level performance optimization (batching, caching, parallelization). For algorithm-level details such as calculation method selection, see the [Calculations](calculations.md) documentation.