Ground
Physical NetworksThe Ground block establishes the absolute zero-volt reference potential () for an electrical physical network. In any acausal network solved via Modified Nodal Analysis (MNA), at least one reference node is mathematically required to fix the absolute voltage values across all connected nodes and prevent a singular nodal conductance matrix.
Every conserving electrical node connected directly or indirectly to the Ground block port p is anchored to . Multiple Ground blocks can be placed in different parts of a schematic; all ground ports share the same global zero-potential reference plane.
Real-World Analog: Represents the earth ground stake, vehicle metal chassis, or system negative ground plane defining zero reference potential (0 V).
Mathematical Model
The Ground block pins the nodal electrical potential to zero:
Where:
V(p)is the electrical potential at the conserving terminalp.- The current through the ground reference adjusts dynamically according to Kirchhoff's Current Law (KCL).
Inputs & Outputs
| Direction | ID | Label | Type | Status |
|---|---|---|---|---|
| → In | p |
GND | number | Required |
Usage Examples
Voltage Divider Reference Node
In examples/basic-ground.json, the Ground block establishes the essential 0 V reference potential for a 10 V voltage divider, allowing the midpoint node to resolve to exactly 5.0 V.
Multibranch Star Grounding
Tie multiple sub-circuits to a common reference point:
`Branch1(n) → Ground
Branch2(n) → Ground`
Remarks & Best Practices
- Reference Requirement: Every solvable electrical network must contain at least one Ground block to avoid singular matrices.
- Acausal Port: The terminal is a conserving physical port of domain
electricalcarrying across variable (Voltage) and through variable (Current). - Multiple Instances: Placing multiple Ground blocks is equivalent to connecting them with ideal zero-resistance wires.
- WASM Engine: Implemented directly in the high-performance Rust MNA solver.
Related Components
- VoltageSource: Establish potential differences across electrical branches
- Resistor: Dissipate electrical energy with Ohm's law
- VoltageSensor: Measure nodal potential relative to reference