small_signal ¤
Reusable source-driven linear models and physical small-signal observables.
Classes:
| Name | Description |
|---|---|
QuadratureDrive | Independent complex RF peak phasors driving the two field coordinates. |
SmallSignalModel | Fixed-bias linearization callable as model(freqs=..., sources=...). |
SmallSignalResponse | Physical peak response phasors, retaining both optical field coordinates. |
Functions:
| Name | Description |
|---|---|
build_small_signal_model | Build an immutable numerical snapshot with static source and node names. |
validate_small_signal_groups | Reject real-only native Jacobians in a doubled complex system. |
QuadratureDrive ¤
Bases: Module
Independent complex RF peak phasors driving the two field coordinates.
With the exp(+j omega t) convention, the source perturbation is Re(x exp(j omega t)) + j Re(y exp(j omega t)). A scalar source drive is shorthand for QuadratureDrive(x=amplitude, y=0), including optical sources.
SmallSignalModel ¤
Bases: Module
Fixed-bias linearization callable as model(freqs=..., sources=...).
response() is equivalent to calling the model. Parameters and DC bias are fixed at construction; source phasors and frequencies are runtime inputs. No matching loads or scattering normalization are introduced.
Methods:
| Name | Description |
|---|---|
response | Call the model; identical to model(freqs=freqs, sources=sources). |
response ¤
response(
*, freqs: Array, sources: Mapping[str, complex | Array | QuadratureDrive]
) -> SmallSignalResponse
Call the model; identical to model(freqs=freqs, sources=sources).
Source code in circulax/small_signal.py
SmallSignalResponse ¤
Bases: Module
Physical peak response phasors, retaining both optical field coordinates.
The final axes of solution are (frequency, unknown). Complex-mode unknowns are stored as [x coordinates, y coordinates], each containing complex RF phasors. Additional leading axes may be introduced by external jax.vmap. y_dc uses the same block layout, but contains real DC coordinates.
Methods:
| Name | Description |
|---|---|
power | Return complex optical power-modulation peak phasors in watts. |
quadratures | Extract complex RF phasors of both physical field coordinates. |
sidebands | Return actual envelope coefficients at +omega and -omega. |
voltage | Extract a physical electrical voltage peak phasor in volts. |
Attributes:
| Name | Type | Description |
|---|---|---|
port_map | dict[str, int] | Return stable node and internal-state aliases. |
power ¤
Return complex optical power-modulation peak phasors in watts.
field_unit must be 'sqrt(W)', explicitly declaring the selected field power normalized, with P = |E|**2. This computes 2 * (x_dc * dx + y_dc * dy), preserving RF phase. It is not DC power, modulation magnitude, or electrical absorbed power. The selected node must itself represent the intended optical field, e.g. a traveling wave; a total field at a mismatched boundary is not an incident power wave.
Source code in circulax/small_signal.py
quadratures ¤
Extract complex RF phasors of both physical field coordinates.
Optionally take the field difference between two nodes. Real circuits have only the x coordinate and return zeros for the y coordinate.
Source code in circulax/small_signal.py
sidebands ¤
Return actual envelope coefficients at +omega and -omega.
For E(t) = E_dc + upperexp(j omega t) + lowerexp(-j omega t), upper=(dx+jdy)/2 and lower=(conj(dx)+jconj(dy))/2. The labels refer to envelope frequency; optical upper/lower labeling additionally depends on the chosen optical carrier time convention.
Source code in circulax/small_signal.py
voltage ¤
Extract a physical electrical voltage peak phasor in volts.
The caller declares these nodes electrical; no discipline is inferred. In a mixed complex circuit the electrical voltage is the x coordinate.
Source code in circulax/small_signal.py
build_small_signal_model ¤
build_small_signal_model(
circuit: Circuit,
groups: dict[str, Any],
y_dc: Array,
*,
dc_groups: dict[str, Any] | None = None
) -> SmallSignalModel
Build an immutable numerical snapshot with static source and node names.
Source code in circulax/small_signal.py
validate_small_signal_groups ¤
Reject real-only native Jacobians in a doubled complex system.