From 81854278a82b75f1ecf10bc60a9547888e74fed3 Mon Sep 17 00:00:00 2001
From: lukelowry <wyattluke.lowery@gmail.com>
Date: Sun, 31 May 2026 22:29:56 -0500
Subject: [PATCH 1/2] Add SCRX exciter documentation stub

---
 .../Model/PhasorDynamics/Exciter/README.md    |   1 +
 .../PhasorDynamics/Exciter/SCRX/README.md     |  72 ++++++++++++++++++
 docs/Figures/PhasorDynamics/SCRX_diagram.png  | Bin 0 -> 15505 bytes
 3 files changed, 73 insertions(+)
 create mode 100644 GridKit/Model/PhasorDynamics/Exciter/SCRX/README.md
 create mode 100644 docs/Figures/PhasorDynamics/SCRX_diagram.png

diff --git a/GridKit/Model/PhasorDynamics/Exciter/README.md b/GridKit/Model/PhasorDynamics/Exciter/README.md
index 16008155d..8d742e801 100644
--- a/GridKit/Model/PhasorDynamics/Exciter/README.md
+++ b/GridKit/Model/PhasorDynamics/Exciter/README.md
@@ -18,4 +18,5 @@ There are a few standard Exciter models
 - ESDC2A Excitation Model (See [ESDC2A](ESDC2A/README.md))
 - EXAC1 Excitation Model (See [EXAC1](EXAC1/README.md))
 - IEEE ST4B Excitation Model (See [ESST4B](ESST4B/README.md))
+- SCRX Excitation Model (See [SCRX](SCRX/README.md))
 - Simplified Excitation System Model (See [SEXS-PTI](SEXS-PTI/README.md))
diff --git a/GridKit/Model/PhasorDynamics/Exciter/SCRX/README.md b/GridKit/Model/PhasorDynamics/Exciter/SCRX/README.md
new file mode 100644
index 000000000..62610de87
--- /dev/null
+++ b/GridKit/Model/PhasorDynamics/Exciter/SCRX/README.md
@@ -0,0 +1,72 @@
+# **Exciter Model (SCRX)**
+
+> [!NOTE]
+> This README is a documentation stub/template for the SCRX exciter. Parameters, variables, equations, initialization details, and outputs are intentionally left unfilled until the model is derived from its source documentation.
+
+## Block Diagram
+
+Standard model of the SCRX Exciter.
+
+<div align="center">
+   <img align="center" src="../../../../../docs/Figures/PhasorDynamics/SCRX_diagram.png">
+
+  Figure 1: Exciter SCRX model.
+</div>
+
+## Model Parameters
+
+Symbol | Units | Description | Typical Value | Note
+-------|-------|-------------|---------------|-----
+
+### Model Derived Parameters
+
+## Model Variables
+
+### Internal Variables
+
+#### Differential
+
+Symbol | Units | Description | Note
+-------|-------|-------------|-----
+
+#### Algebraic
+
+Symbol | Units | Description | Note
+-------|-------|-------------|-----
+
+### External Variables
+
+#### Differential
+
+Symbol | Units | Description | Note
+-------|-------|-------------|-----
+
+#### Algebraic
+
+Symbol | Units | Description | Note
+-------|-------|-------------|-----
+
+## Model Equations
+
+### Differential Equations
+
+```math
+\begin{aligned}
+\end{aligned}
+```
+
+### Algebraic Equations
+
+```math
+\begin{aligned}
+\end{aligned}
+```
+
+## Initialization
+
+```math
+\begin{aligned}
+\end{aligned}
+```
+
+## Model Outputs
diff --git a/docs/Figures/PhasorDynamics/SCRX_diagram.png b/docs/Figures/PhasorDynamics/SCRX_diagram.png
new file mode 100644
index 0000000000000000000000000000000000000000..42bf6d4df4792f19d1dbbfc159478d0fb86e0209
GIT binary patch
literal 15505
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
VY)L8G18u|*MLAViiHy<5{{gz3Bhvr?

literal 0
HcmV?d00001


From 8688ae2ea10cb2c98a9e36eb8ab8bb4f4dbdc286 Mon Sep 17 00:00:00 2001
From: lukelowry <wyattluke.lowery@gmail.com>
Date: Tue, 2 Jun 2026 16:53:18 -0500
Subject: [PATCH 2/2] docs: complete SCRX README [skip ci]

---
 .../PhasorDynamics/Exciter/SCRX/README.md     | 124 +++++++++++++++---
 1 file changed, 109 insertions(+), 15 deletions(-)

diff --git a/GridKit/Model/PhasorDynamics/Exciter/SCRX/README.md b/GridKit/Model/PhasorDynamics/Exciter/SCRX/README.md
index 62610de87..8d53d83b2 100644
--- a/GridKit/Model/PhasorDynamics/Exciter/SCRX/README.md
+++ b/GridKit/Model/PhasorDynamics/Exciter/SCRX/README.md
@@ -1,7 +1,18 @@
-# **Exciter Model (SCRX)**
-
-> [!NOTE]
-> This README is a documentation stub/template for the SCRX exciter. Parameters, variables, equations, initialization details, and outputs are intentionally left unfilled until the model is derived from its source documentation.
+# **Bus Fed or Solid Fed Static Excitation System Model (SCRX)**
+
+SCRX is a static excitation system with a voltage-error lead-lag block, a
+limited exciter lag, and a source selector that scales the exciter output by
+either terminal voltage or a constant source.
+
+Notes:
+- Internal voltage signals are on model base unless otherwise stated.
+- The source diagram shows a shared SCRX/SCRX1-style selector. In the diagram,
+  `C_SWITCH = 0` selects the bus-fed multiplier $E_T$, and `C_SWITCH = 1`
+  selects the solid-fed multiplier 1.
+- Some source material labels the lead-lag numerator input as `TA/TB`; the
+  model equations below use explicit time constants $T_A$ and $T_B$.
+- `Rc_Rfd` is a source-data parameter for input compatibility, but it is not an
+  active block in Fig. 1 and is not used by the equations below.
 
 ## Block Diagram
 
@@ -10,41 +21,84 @@ Standard model of the SCRX Exciter.
 <div align="center">
    <img align="center" src="../../../../../docs/Figures/PhasorDynamics/SCRX_diagram.png">
 
-  Figure 1: Exciter SCRX model.
+  Figure 1: Exciter SCRX model. Figure courtesy of [PowerWorld](https://www.powerworld.com/WebHelp/)
 </div>
 
 ## Model Parameters
 
-Symbol | Units | Description | Typical Value | Note
--------|-------|-------------|---------------|-----
+Symbol                              | Units    | JSON       | Description                                             | Typical Value | Note
+------------------------------------|----------|------------|---------------------------------------------------------|---------------|------
+$T_A$                               | [sec]    | `Ta`       | Lead-lag numerator time constant                        | 0.0           | Source label: `TA/TB` in some SCRX source data
+$T_B$                               | [sec]    | `Tb`       | Lead-lag denominator time constant                      | 0.0           | Block name: `TB`; if zero, the lead-lag block is algebraic
+$K$                                 | [p.u.]   | `K`        | Exciter gain                                            | 1.0           | Block name: `K`
+$T_E$                               | [sec]    | `Te`       | Exciter lag time constant                               | 0.0           | Block name: `TE`; if zero, $E_{\mathrm{fd}}'$ is algebraic
+$E_{\mathrm{fd}}^{\max}$            | [p.u.]   | `Efdmax`   | Maximum limited exciter output before source multiplier | 5.0           | Block name: `EFDMAX`
+$E_{\mathrm{fd}}^{\min}$            | [p.u.]   | `Efdmin`   | Minimum limited exciter output before source multiplier | -5.0          | Block name: `EFDMIN`
+$C_{\mathrm{sw}}$                   | [binary] | `Cswitch`  | Source multiplier selector                              | 0             | Source label: `C_SWITCH`; 0 = bus-fed $E_T$, 1 = solid-fed constant 1
+$R_c/R_{\mathrm{fd}}$               | [p.u.]   | `Rc_Rfd`   | Source-data compatibility parameter                     | 0.0           | Not active in Fig. 1 equations
+
+### Parameter Validation
+
+Invalid SCRX parameter sets are rejected by the following checks.
+
+```math
+\begin{aligned}
+  &T_A \ge 0,\quad T_B \ge 0,\quad T_E \ge 0 \\
+  &T_B > 0\quad\text{or}\quad(T_B = 0\ \text{and}\ T_A = 0) \\
+  &E_{\mathrm{fd}}^{\min} \le E_{\mathrm{fd}}^{\max} \\
+  &C_{\mathrm{sw}} \in \{0,1\}
+\end{aligned}
+```
 
 ### Model Derived Parameters
 
+The source multiplier is:
+
+```math
+\begin{aligned}
+  M_{\mathrm{src}} &= (1 - C_{\mathrm{sw}})E_T + C_{\mathrm{sw}}
+\end{aligned}
+```
+
+When $T_B=0$, the lead-lag block is treated as a bypass with
+$V_{\mathrm{ll}}=e_V$.
+
 ## Model Variables
 
 ### Internal Variables
 
 #### Differential
 
-Symbol | Units | Description | Note
--------|-------|-------------|-----
+Symbol                              | Units  | Description                                             | Note
+------------------------------------|--------|---------------------------------------------------------|------
+$x_{\mathrm{ll}}$                   | [p.u.] | Lead-lag block state                                    | State 1 in Fig. 1
+$E_{\mathrm{fd}}'$                  | [p.u.] | Limited exciter output before source multiplier         | State 2 in Fig. 1; algebraic when $T_E=0$
 
 #### Algebraic
 
-Symbol | Units | Description | Note
--------|-------|-------------|-----
+Symbol                              | Units  | Description                                             | Note
+------------------------------------|--------|---------------------------------------------------------|------
+$e_V$                               | [p.u.] | Voltage-error signal before lead-lag block              | Summing junction in Fig. 1
+$V_{\mathrm{ll}}$                   | [p.u.] | Lead-lag output                                         | Drives the limited exciter lag
+$M_{\mathrm{src}}$                  | [p.u.] | Source multiplier                                       | $E_T$ when $C_{\mathrm{sw}}=0$, 1 when $C_{\mathrm{sw}}=1$
+$E_{\mathrm{fd}}$                   | [p.u.] | Field-voltage output                                    | Output after source multiplier
 
 ### External Variables
 
 #### Differential
 
-Symbol | Units | Description | Note
--------|-------|-------------|-----
+None.
 
 #### Algebraic
 
-Symbol | Units | Description | Note
--------|-------|-------------|-----
+Symbol                              | Units  | Description                                             | Note
+------------------------------------|--------|---------------------------------------------------------|------
+$E_C$                               | [p.u.] | Compensated terminal voltage magnitude                  | Source label: `EC`
+$E_T$                               | [p.u.] | Terminal-voltage source multiplier                      | Source label: `ET`; used only when $C_{\mathrm{sw}}=0$
+$V_{\mathrm{ref}}$                  | [p.u.] | Voltage-control reference                               | Source label: `VREF`
+$V_{\mathrm{uel}}$                  | [p.u.] | Under-excitation limiter input                          | Source label: `VUEL`; optional, defaults to zero
+$V_S$                               | [p.u.] | Stabilizer input signal                                 | Source label: `VS`; optional, defaults to zero
+$V_{\mathrm{oel}}$                  | [p.u.] | Over-excitation limiter input                           | Source label: `VOEL`; optional, defaults to zero
 
 ## Model Equations
 
@@ -52,21 +106,61 @@ Symbol | Units | Description | Note
 
 ```math
 \begin{aligned}
+  0 &= -T_B\dot x_{\mathrm{ll}} - x_{\mathrm{ll}} + e_V \\
+  0 &=
+    -T_E\dot E_{\mathrm{fd}}'
+    + \text{antiwindup}\!\left(
+        E_{\mathrm{fd}}',
+        -E_{\mathrm{fd}}' + K V_{\mathrm{ll}},
+        E_{\mathrm{fd}}^{\min},
+        E_{\mathrm{fd}}^{\max}
+      \right)
 \end{aligned}
 ```
 
+CommonMath defines the [Anti-Windup](../../../../CommonMath.md#anti-windup-indicator)
+target and smooth approximation.
+
 ### Algebraic Equations
 
 ```math
 \begin{aligned}
+  0 &= -e_V + V_{\mathrm{ref}} + V_{\mathrm{uel}} + V_S + V_{\mathrm{oel}} - E_C \\
+  0 &= -T_B(V_{\mathrm{ll}} - x_{\mathrm{ll}}) + T_A(e_V - x_{\mathrm{ll}}) \\
+  0 &= -M_{\mathrm{src}} + (1 - C_{\mathrm{sw}})E_T + C_{\mathrm{sw}} \\
+  0 &= -E_{\mathrm{fd}} + M_{\mathrm{src}}E_{\mathrm{fd}}'
 \end{aligned}
 ```
 
+When $T_B=0$, SCRX bypasses the lead-lag block so $V_{\mathrm{ll}}=e_V$.
+
 ## Initialization
 
+The machine initializes $E_{\mathrm{fd}}$ first. For a standard unsaturated
+start, SCRX reads that value along with $E_C$, $E_T$, and any attached limiter
+or stabilizer inputs, sets all internal derivatives to zero, and evaluates:
+
 ```math
 \begin{aligned}
+  M_{\mathrm{src},0} &= (1 - C_{\mathrm{sw}})E_{T,0} + C_{\mathrm{sw}} \\
+  E_{\mathrm{fd},0}' &= \dfrac{E_{\mathrm{fd},0}}{M_{\mathrm{src},0}} \\
+  V_{\mathrm{ll},0} &= \dfrac{E_{\mathrm{fd},0}'}{K} \\
+  x_{\mathrm{ll},0} &= e_{V,0} = V_{\mathrm{ll},0} \\
+  V_{\mathrm{ref},0}
+    &= e_{V,0} + E_{C,0}
+       - V_{\mathrm{uel},0} - V_{S,0} - V_{\mathrm{oel},0}
 \end{aligned}
 ```
 
+This closed-form start requires $M_{\mathrm{src},0}\ne 0$, $K\ne 0$, and
+$E_{\mathrm{fd}}^{\min}\le E_{\mathrm{fd},0}'\le E_{\mathrm{fd}}^{\max}$.
+Starts that bind the exciter limit are outside these closed-form equations.
+
 ## Model Outputs
+
+Output          | Units  | Description                         | Note
+----------------|--------|-------------------------------------|------
+`efd`           | [p.u.] | Field-voltage output                | $E_{\mathrm{fd}}$
+`efd_pre`       | [p.u.] | Limited exciter output before source multiplier | $E_{\mathrm{fd}}'$
+`vll`           | [p.u.] | Lead-lag output                     | $V_{\mathrm{ll}}$
+`msrc`          | [p.u.] | Source multiplier                   | $M_{\mathrm{src}}$