laser_sections ¤
Composable bidirectional sections for reconfigurable semiconductor laser circuits.
Unit reference impedance: V=a+b, I=a-b, with I entering the component and waves in sqrt(W). Reference-envelope convention: exp(+iomegat). Positive phase_rad multiplies the envelope by exp(+i*phase_rad). All lengths use SI.
Functions:
| Name | Description |
|---|---|
BidirectionalWaveguide | Reflection-free reciprocal propagation with real flight time and loss. |
MatchedOpticalLoad | Absorb a wave at unit reference impedance; no incident optical field. |
MatchedOpticalPulse | Matched coherent pulse source: prescribed incoming wave, absorbs return. |
OpticalDirectionalCoupler | Reciprocal unitary four-port coupler, suitable for connecting ring loops. |
OpticalInterface | Reciprocal optical interface; r=i*rho, t=sqrt(1-rho²), common excess loss. |
ThermoOpticPhaseShifter | Reciprocal delayed phase section, uniform arrival-time temperature. |
TravelingWaveGainCell | One retarded-gain cell; both delayed incident powers share one reservoir. |
sampled_bragg_grating | Lossless thin-patch sampled-grating approximation with causal gap delays. |
sampled_grating_response | Exact frequency-domain r,t of the same native delayed-patch network. |
BidirectionalWaveguide ¤
BidirectionalWaveguide(
signals: Signals,
length_m: float = 5e-05,
group_index: float = 4.0,
loss_m1: float = 0.0,
phase_rad: float = 0.0,
frame_offset_rad_s: float = 0.0,
) -> PhysicsReturn
Reflection-free reciprocal propagation with real flight time and loss.
phase_rad is the phase at the fixed optical reference, not a recomputed carrier phase when changing envelope coordinates. loss_m1 is power loss.
Source code in circulax/components/laser_sections.py
MatchedOpticalLoad ¤
MatchedOpticalLoad(signals: Signals) -> PhysicsReturn
Absorb a wave at unit reference impedance; no incident optical field.
MatchedOpticalPulse ¤
MatchedOpticalPulse(
signals: Signals,
t: float,
power_w: float = 1e-12,
start_s: float = 1e-11,
duration_s: float = 3e-11,
) -> PhysicsReturn
Matched coherent pulse source: prescribed incoming wave, absorbs return.
Compact sin² FIELD, sin⁴ power; exactly zero outside its support. This is deterministic startup, not spontaneous emission. p2 is optical reference.
Source code in circulax/components/laser_sections.py
OpticalDirectionalCoupler ¤
Reciprocal unitary four-port coupler, suitable for connecting ring loops.
Forward inputs p1,p2 exit at p3,p4; reverse paths follow reciprocity. Cross coupling has +i phase. The physical ring delay belongs in waveguides.
Source code in circulax/components/laser_sections.py
OpticalInterface ¤
OpticalInterface(
signals: Signals, amplitude_reflection: float = 0.0, power_loss_db: float = 0.0
) -> PhysicsReturn
Reciprocal optical interface; r=i*rho, t=sqrt(1-rho²), common excess loss.
rho is a real amplitude magnitude in [-1,1], not power reflectance. This also supplies a frequency-flat mirror when excess loss is zero.
Source code in circulax/components/laser_sections.py
ThermoOpticPhaseShifter ¤
ThermoOpticPhaseShifter(
signals: Signals,
length_m: float = 0.0001,
group_index: float = 4.0,
loss_m1: float = 0.0,
phase_rad: float = 0.0,
phase_per_k: float = 0.15,
frame_offset_rad_s: float = 0.0,
heater_resistance_ohm: float = 100.0,
thermal_resistance_k_per_w: float = 200.0,
thermal_tau_s: float = 1e-06,
) -> PhysicsReturn
Reciprocal delayed phase section, uniform arrival-time temperature.
temperature is the rise above ambient (K); phase_per_k is one-pass rad/K. Thermal variation during a flight is neglected (flight << thermal time).
Source code in circulax/components/laser_sections.py
TravelingWaveGainCell ¤
TravelingWaveGainCell(
signals: Signals,
length_m: float = 7.5e-05,
width_m: float = 2e-06,
thickness_m: float = 1e-07,
group_index: float = 3.6,
lifetime_s: float = 2.8e-10,
confinement: float = 0.3,
differential_gain_m2: float = 6e-20,
transparency_m3: float = 5.5e23,
injection_efficiency: float = 0.8,
wavelength_m: float = 1.54e-06,
alpha_h: float = 3.5,
loss_m1: float = 1000.0,
detuning_rad_s: float = 0.0,
frame_offset_rad_s: float = 0.0,
saturation: float = 1.0,
saturation_current_a: float = 1e-12,
ideality: float = 1.8,
thermal_voltage_v: float = 0.02585,
resistance_ohm: float = 5.0,
capacitance_f: float = 1.5e-13,
) -> PhysicsReturn
One retarded-gain cell; both delayed incident powers share one reservoir.
Connect cells in optical series and their diode terminals in electrical parallel for a uniformly contacted gain region. Diode area scales with cell length. Frozen arrival-time gain is first order in cell length. Interference is averaged; carrier gratings, gain dispersion and spontaneous noise omitted.
Source code in circulax/components/laser_sections.py
sampled_bragg_grating cached ¤
sampled_bragg_grating(samples: int = 5) -> type[CircuitComponent]
Lossless thin-patch sampled-grating approximation with causal gap delays.
Identical zero-length Bragg patches have r=itanh(strength/samples), t=sech(strength/samples). Delayed gaps retain all multiple reflections. Peak power reflectance=tanh(strength)^2; comb FSR=c/(2n_g*spacing). Finite patch bandwidth/dispersion is omitted: qualify a finite wavelength window near the reference. Increasing samples changes the physical device; it is not numerical mesh refinement of the same grating.
Source code in circulax/components/laser_sections.py
sampled_grating_response ¤
sampled_grating_response(
omega: object,
temperature: object = 0.0,
*,
samples: int = 5,
spacing_m: float = 0.00018737028625,
group_index: float = 4.0,
strength: float = 0.9,
center_m: float = 1.54e-06,
shift_m_per_k: float = 8e-11,
reference_m: float = 1.54e-06
) -> tuple
Exact frequency-domain r,t of the same native delayed-patch network.