characteristic_line ¤
Uniform transmission lines realized by their characteristic admittance and exact delay.
The line obeys Yc*V1 - I1 = H*(Yc*V2 + I2) and the mirrored relation, with H = exp(-s*delay) * propagation(s) (method of characteristics). Removing the delay keeps Yc and propagation smooth, so a long line needs a few poles rather than enough poles to follow its phase rotation.
Each pole is a separate small component, keeping the Jacobian sparse. Internal wave nodes are in volts (currents times zref):
sum_k = zref * Yc * V_k;r_k = zref * (Yc*V_k - I_k), the wave arriving at portk;u_k = zref * (Yc*V_k + I_k) = 2*sum_k - r_k, the wave launched from portk.
Functions:
| Name | Description |
|---|---|
AdmittancePole | Real pole of |
AdmittancePolePair | Complex-conjugate pole pair of |
CharacteristicLineCore | Constant terms, port currents and wave bookkeeping; the wave nodes are unit-resistance loaded. |
PropagationPole | Real pole of the delay-free propagation, driven by the launched wave at |
PropagationPolePair | Complex-conjugate pole pair of the delay-free propagation. |
characteristic_line_circuit | Realize a :class: |
characteristic_rlgc_transmission_line | Create a fast uniform line from RLGC versus Hz, with its delay de-embedded. |
AdmittancePole ¤
AdmittancePole(
signals: Signals,
pole: float = -1000000000.0,
residue: float = 0.0,
zref: float = 50.0,
) -> PhysicsReturn
Real pole of Yc: shunt current at v and its zref-scaled copy into sum.
Source code in circulax/components/characteristic_line.py
AdmittancePolePair ¤
AdmittancePolePair(
signals: Signals,
*,
pole_re: float = -1000000000.0,
pole_im: float = 1000000000.0,
residue_re: float = 0.0,
residue_im: float = 0.0,
zref: float = 50.0
) -> PhysicsReturn
Complex-conjugate pole pair of Yc.
Source code in circulax/components/characteristic_line.py
CharacteristicLineCore ¤
CharacteristicLineCore(
signals: Signals,
admittance: float = 0.02,
propagation: float = 0.0,
delay: float = 0.0,
zref: float = 50.0,
) -> PhysicsReturn
Constant terms, port currents and wave bookkeeping; the wave nodes are unit-resistance loaded.
Source code in circulax/components/characteristic_line.py
PropagationPole ¤
PropagationPole(
signals: Signals,
pole: float = -1000000000.0,
residue: float = 0.0,
delay: float = 0.0,
) -> PhysicsReturn
Real pole of the delay-free propagation, driven by the launched wave at t - delay.
Source code in circulax/components/characteristic_line.py
PropagationPolePair ¤
PropagationPolePair(
signals: Signals,
*,
pole_re: float = -1000000000.0,
pole_im: float = 1000000000.0,
residue_re: float = 0.0,
residue_im: float = 0.0,
delay: float = 0.0
) -> PhysicsReturn
Complex-conjugate pole pair of the delay-free propagation.
Source code in circulax/components/characteristic_line.py
characteristic_line_circuit ¤
characteristic_line_circuit(model: CharacteristicLineModel) -> Circuit
Realize a :class:~circulax.fitting.rlgc.CharacteristicLineModel as a two-port Circuit.
Ports p1 and p2 are single-ended to ground. Works in real and complex circuits, in DC, AC, harmonic balance and transient analysis.
Source code in circulax/components/characteristic_line.py
characteristic_rlgc_transmission_line ¤
characteristic_rlgc_transmission_line(
frequencies: ArrayLike,
*,
R: ArrayLike | Callable[[ndarray], ArrayLike],
L: ArrayLike | Callable[[ndarray], ArrayLike],
G: ArrayLike | Callable[[ndarray], ArrayLike],
C: ArrayLike | Callable[[ndarray], ArrayLike],
length: float,
tolerance: float = 0.001,
max_order: int = 40,
delay_fraction: float = 0.98,
z0: float = 50.0
) -> Circuit
Create a fast uniform line from RLGC versus Hz, with its delay de-embedded.
Use it instead of :func:~circulax.components.reduced_rlgc_transmission_line when the line is electrically long. That model fits the S-parameters and needs many poles to follow the propagation phase. This one removes the delay exactly and fits only the smooth characteristic admittance and the remaining propagation. frequencies must start at DC, and the lowest nonzero frequency must be low enough for the DC floors described in :func:~circulax.fitting.fit_rlgc_characteristic. That function also documents the admission checks; a fit failing them raises ValueError. z0 is only the reference impedance for the S error check.
Ports p1 and p2 are single-ended to ground, with no internal taps. Fitting depends on length, so refit for a different length. Use fit_rlgc_characteristic to inspect the fit and model.circuit() to realize it.