From 20df9393f15d5edf71b08d6233ff0eb6f3fb1f7d Mon Sep 17 00:00:00 2001
From: wvpm <24685035+wvpm@users.noreply.github.com>
Date: Sat, 31 Aug 2024 15:33:11 +0200
Subject: Document industrial power score

---
 docs/simulation/calculations.yaml | 21 ++++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/docs/simulation/calculations.yaml b/docs/simulation/calculations.yaml
index b87e5f2..d8bd6a5 100644
--- a/docs/simulation/calculations.yaml
+++ b/docs/simulation/calculations.yaml
@@ -60,7 +60,7 @@ Economy:
         relative maximum:
             if employees count = 0 & max employees >= 6667: 0.2775 * Vacancies
             else: ceil(0.15 * Vacancies) - 1
-          0.15: Hardcoded value
+          0.15: Hardcoded value.
           0.2775: 1 - (1 - 0.15)^2
           note: Rounding is unknown for the 0.2775 case. See https://discord.com/channels/1063392556160909312/1063416834650554398/1204520366643347476
       Minimum employees hired per day:
@@ -153,7 +153,7 @@ POPs:
             n_owners: total size of owner POPs in state
             n_workers: number of employed workers in RGO
             min(0.5: Hardcoded maximum of half the RGO income.
-            2*: Hardcoded value.
+            2 *: Hardcoded value.
         Workers:
           if is_slave: 0
           else:
@@ -164,4 +164,19 @@ POPs:
               n_owners: total size of owner POPs in state
               n_workers: number of employed workers in RGO
               max(0.5: Hardcoded minimum of half the RGO income.
-              2*: Hardcoded value.
\ No newline at end of file
+              2 *: Hardcoded value.
+Scores:
+  Industrial power:
+    formula: sum of investment scores + sum of state factory scores
+    investment score: money_invested * defines.country.INVESTMENT_SCORE_FACTOR / 100
+    state factory score:
+      if n_workers > 0:
+        formula: sum_factory_levels_in_state * max(0.2, min(4, floor(n_workers_in_state / 100) * 400 / sum_workforce_in_state))
+        sum_factory_levels_in_state: sum of factory levels in the state
+        max(0.2: Hardcoded minimum score per factory level.
+        min(4: Hardcoded maximum score per factory level.
+        floor(n_workers_in_state / 100): Hardcoded number step.
+        400: Hardcoded value.
+        n_workers_in_state: Total size of worker POPs in state (employed or not).
+        sum_workforce_in_state: Sum of factory level * workforce, defined in /common/production_types.txt.
+      else: 0
\ No newline at end of file
-- 
cgit v1.2.3-56-ga3b1