Class Ground

java.lang.Object

org.episteme.natural.physics.classical.waves.electromagnetism.circuit.CircuitElement

org.episteme.natural.physics.classical.waves.electromagnetism.components.Ground

All Implemented Interfaces:

CircuitComponent

public class Ground
extends CircuitElement
implements CircuitComponent

Represents a ground reference (0V potential).

Since:

1.0

Author:

Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

Field Summary

Fields inherited from class CircuitElement

circuit, current, nodes, volts, voltSource, x, x2, y, y2

Constructor Summary

Constructors

Constructor	Description
Ground()

Method Summary

Modifier and Type	Method	Description
Real	getCurrent(Real voltage, Real dt)	Calculates the current flowing through the component given the voltage across it.
int	getPostCount()	Returns the number of external terminals (posts) on this element.
int	getVoltageSourceCount()	Returns the number of independent voltage sources in this element.
boolean	hasGroundConnection(int n)	Returns whether terminal n has a ground connection.
void	stamp()	Stamps the element's contribution into the circuit matrix.

Methods inherited from class CircuitElement

allocNodes, calculateCurrent, doStep, getCircuit, getConnection, getCurrent, getInternalNodeCount, getNode, getPostPosition, getPower, getVoltageDiff, getVoltageSource, nonLinear, reset, setCircuit, setCoordinates, setCurrent, setNode, setNodeVoltage, setVoltageSource, startIteration

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

Ground

public Ground()

Method Details

getPostCount

public int getPostCount()

Description copied from class: CircuitElement

Returns the number of external terminals (posts) on this element. Most elements have 2 posts. Override for elements with more.

Overrides:

getPostCount in class CircuitElement

Returns:

Number of external terminals

getCurrent

public Real getCurrent(Real voltage,
 Real dt)

Description copied from interface: CircuitComponent

Calculates the current flowing through the component given the voltage across it.

Specified by:

getCurrent in interface CircuitComponent

Parameters:

voltage - Voltage across the component (Volts)

dt - Time step (Seconds) - used for dynamic components

Returns:

Current (Amperes)

stamp

public void stamp()

Description copied from class: CircuitElement

Stamps the element's contribution into the circuit matrix. This is called once during circuit analysis to build the MNA matrix. Linear elements stamp constant coefficients; nonlinear elements stamp initial guesses that will be updated in CircuitElement.doStep().

Specified by:

stamp in class CircuitElement

getVoltageSourceCount

public int getVoltageSourceCount()

Description copied from class: CircuitElement

Returns the number of independent voltage sources in this element. Used for voltage sources and elements that model voltage sources.

Overrides:

getVoltageSourceCount in class CircuitElement

Returns:

Number of voltage sources (default 0)

hasGroundConnection

public boolean hasGroundConnection(int n)

Description copied from class: CircuitElement

Returns whether terminal n has a ground connection.

Overrides:

hasGroundConnection in class CircuitElement

Parameters:

n - Terminal number

Returns:

true if grounded