GND

Ground

Physical Networks
Run the live example Free · no sign-up · runs in your browser

The Ground block establishes the absolute zero-volt reference potential (0 V0\text{ V}) 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 0 V0\text{ V}. 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:

V(p)=0 VV(p) = 0 \text{ V}

Where:

  • V(p) is the electrical potential at the conserving terminal p.
  • 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 electrical carrying 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