hybrid_laser ¤
Netlist assemblies for reconfigurable gain and passive-feedback laser cavities.
Assemblies use only public components and compile_circuit. No separate time solver is used. Threshold helpers describe the matched-interface SG assembly; they do not apply unchanged after replacing a reflector or adding reflections.
Classes:
| Name | Description |
|---|---|
HybridSettings | Passive-feedback settings: comb spacings Hz, lengths m, phase rad/K, loss dB. |
HybridThreshold | Required modal gain (1/m), injection (A), unit-magnitude round-trip field. |
Functions:
| Name | Description |
|---|---|
add_drop_ring | Bidirectional add/drop ring assembled from two couplers and two arms. |
grating_settings | Settings shared by the native grating and its exact scattering helper. |
hybrid_frame_parameters | Shift every delayed leaf of the default SG assembly into one envelope frame. |
hybrid_laser | Compile a reusable laser subcircuit; parent supplies pump/heaters/loads. |
hybrid_laser_netlist | Editable cavity netlist and model map, without drives or terminations. |
hybrid_modes | Enumerate phase crossings in a stated validity window; refine to qualify. |
hybrid_threshold | Threshold of the SG assembly with matched, lossy optical interfaces. |
ring_reflector | Ring drop port followed by a mirror: a replaceable spectral reflector. |
HybridSettings ¤
Bases: NamedTuple
Passive-feedback settings: comb spacings Hz, lengths m, phase rad/K, loss dB.
samples is a physical number of identical thin grating patches. Each grating's length is (samples-1)c/(2n_g*FSR). Loss is per optical interface.
HybridThreshold ¤
add_drop_ring cached ¤
add_drop_ring(
*,
length_m: float = 0.0004,
group_index: float = 4.0,
power_coupling: float = 0.2,
loss_m1: float = 100.0
) -> Circuit
Bidirectional add/drop ring assembled from two couplers and two arms.
Ports input/through/add/drop plus heater/heater_return. One arm supplies thermal phase tuning. All unexcited optical ports must be terminated.
Source code in circulax/components/hybrid_laser.py
grating_settings ¤
grating_settings(p: LaserParameters, s: HybridSettings, side: str) -> dict
Settings shared by the native grating and its exact scattering helper.
Source code in circulax/components/hybrid_laser.py
hybrid_frame_parameters ¤
Shift every delayed leaf of the default SG assembly into one envelope frame.
Prefix is the flattened hierarchy path, e.g. "LASER~". Replacement feedback networks must shift all their own delayed leaves consistently as well.
Source code in circulax/components/hybrid_laser.py
hybrid_laser ¤
hybrid_laser(
p: LaserParameters,
s: HybridSettings = DEFAULT_HYBRID_SETTINGS,
*,
segments: int = 4,
left_reflector: object = None,
right_reflector: object = None
) -> Circuit
Compile a reusable laser subcircuit; parent supplies pump/heaters/loads.
Source code in circulax/components/hybrid_laser.py
hybrid_laser_netlist ¤
hybrid_laser_netlist(
p: LaserParameters,
s: HybridSettings = DEFAULT_HYBRID_SETTINGS,
*,
segments: int = 4,
left_reflector: object = None,
right_reflector: object = None
) -> tuple[dict, dict]
Editable cavity netlist and model map, without drives or terminations.
Left output--SG_L--interface--gain cells--interface--phase--SG_R--right output. All gain diodes share anode/cathode. Reflector and phase heaters are separate electrical ports. Either reflector can be a compatible component or compiled Circuit with ports p1,p2,heater,heater_return, e.g. ring_reflector(). Its settings are then caller-owned; SG threshold helpers no longer apply. A replacement uses p1 facing the cavity and p2 facing the exterior. p.r_left/r_right belong to the older integrated model and are ignored; the separate reflector components own all reflection/transmission physics.
Source code in circulax/components/hybrid_laser.py
hybrid_modes ¤
hybrid_modes(
p: LaserParameters,
s: HybridSettings,
temperatures: object,
*,
bounds_hz: tuple[float, float] = (-1100000000000.0, 1100000000000.0),
points: int = 22001,
max_current_a: float | None = None
) -> tuple[ndarray, ndarray]
Enumerate phase crossings in a stated validity window; refine to qualify.
max_current_a optionally restricts the returned threshold-current range. Near exact grating zeros the flat unbounded gain law produces arbitrarily large thresholds and rapid Henry-phase windings; qualify a finite current range as well as the frequency grid. Sign crossing can miss tangent roots. Comb mirrors repeat indefinitely in this thin-patch approximation. No global mode-selection or SMSR claim.
Source code in circulax/components/hybrid_laser.py
hybrid_threshold ¤
hybrid_threshold(
p: LaserParameters, s: HybridSettings, omega: object, temperatures: object
) -> HybridThreshold
Threshold of the SG assembly with matched, lossy optical interfaces.
temperatures = left grating, right grating, phase rises (K). This helper follows the assembled cell equations; no separate optical dynamics solver. Its roots must also satisfy phase, not just high reflection overlap.
Source code in circulax/components/hybrid_laser.py
ring_reflector cached ¤
Ring drop port followed by a mirror: a replaceable spectral reflector.
Through/add ports are matched; drop sees a frequency-flat lossless mirror. p1 faces the cavity, p2 is the transmitted mirror output. This deliberately has a different spectrum and loss budget from a sampled Bragg reflector.