main EMT root and Bus

Author: lukelowry

GridKit/Model/EMT/Component/Bus/README.md GridKit/Model/EMT/Bus/README.mdGridKit/Model/EMT/Component/Bus/README.md renamed to GridKit/Model/EMT/Bus/README.md

@@ -4,6 +4,10 @@
 bus voltages are differential variables, and the model equations enforce
 current balance at the bus.
 
+## Block Diagram
+
+None.
+
 ## Model Parameters
 
 Symbol | Units | JSON | Description | Note
@@ -26,6 +30,10 @@ N &> 0 \\
 
 None.
 
+### Submodels
+
+None.
+
 ## Model Variables
 
 ### Internal Variables
@@ -72,6 +80,10 @@ Each $\mathbf{i}^{\mathrm{inj}}_m$ may depend on the bus voltage and bus voltage
 
 None.
 
+### Wiring
+
+None.
+
 ## Initialization
 
 The initial bus voltage is given by the parameter vector $\mathbf{v}_0$:
@@ -80,8 +92,8 @@ The initial bus voltage is given by the parameter vector $\mathbf{v}_0$:
 \mathbf{v}(0)=\mathbf{v}_0
 ```
 
-Only $\mathbf{v}(0)$ is initialized. The solver computes
-$\dot{\mathbf{v}}(0)$ from the differential residual.
+Only $\mathbf{v}(0)$ is initialized. The solver computes the initial
+bus-voltage derivative from the differential residual.
 
 ## Monitors
 

GridKit/Model/EMT/README.md

@@ -1,20 +1,22 @@
 # Electromagnetic Transients (EMT)
 
 This directory contains design documentation for electromagnetic transient
-(EMT) models and reusable operators in instantaneous abc coordinates.
+(EMT) models and reusable operators in instantaneous phase coordinates.
 
 ## Conventions
 
 These conventions reflect the current EMT model draft and may change as the
 EMT design and implementation develop.
 
-- Phase order is $a$, $b$, $c$.
+- EMT model equations are written for $N$ phases unless a model states a
+  narrower implementation scope.
 - Equations use SI units unless a model states otherwise.
 - Current injection terms are written as positive into buses.
 
 ## Directories
 
 The current EMT documentation is organized into:
 
+- `Bus` (See [Bus](Bus/README.md))
 - `Component` (See [Component](Component/README.md))
 - `Operators` (See [Operators](Operators/README.md))

docs/GridKit/Model/EMT/Bus/README.md

@@ -0,0 +1,6 @@
+# Bus
+
+```{include} ../../../../../GridKit/Model/EMT/Bus/README.md
+:start-line: 1
+:relative-images:
+```

docs/GridKit/Model/EMT/Component/Bus/README.md

@@ -5,6 +5,7 @@
 :titlesonly:
 :hidden:
 
+Bus <Bus/README>
 Component <Component/README>
 Operators <Operators/README>
 ```