abstract.ring_resonator

ring_resonator(
    *,
    kappa1: complex = 0.3,
    kappa2: complex | None = None,
    n_eff: complex = 2.4,
    length: Annotated[float, minimum=0, units='μm'] = 60,
    propagation_loss: Annotated[float, minimum=0, units='dB/μm'] = 0.0,
    n_group: float | None = None,
    dispersion: Annotated[float, units='s/μm²'] = 0.0,
    dispersion_slope: Annotated[float, units='s/μm³'] = 0.0,
    reference_frequency: Annotated[
        float, minimum=0, units='Hz'
    ] = 193414489032258.06,
    dn_dT: Annotated[complex, units='1/K'] = 0.0,
    dL_dT: Annotated[float, units='dB/μm/K'] = 0.0,
    temperature: Annotated[float, minimum=0, units='K'] = 293.0,
    reference_temperature: Annotated[float, minimum=0, units='K'] = 293.0,
    dn_dv: Annotated[complex, units='1/V'] = 0.0,
    dn_dv2: Annotated[complex, units='1/V²'] = 0.0,
    dloss_dv: Annotated[float, units='dB/μm/V'] = 0.0,
    dloss_dv2: Annotated[float, units='dB/μm/V²'] = 0.0,
    z0: Annotated[complex, units='Ω'] = 50.0,
    f_3dB: Annotated[float, minimum=0, units='Hz'] = 0,
) -> photonforge.Component

Abstract ring resonator with optional electrical tuning.

Based on RingModel and RingTimeStepper. Set kappa2 for a double-bus (add-drop) configuration; leave it as None for single-bus (all-pass).

Args

• kappa1: Coupling coefficient for the first bus waveguide.
• kappa2: Coupling coefficient for the second bus waveguide. If None, models a single-bus ring.
• n_eff: Effective refractive index (loss can be included here by using complex values).
• length: Round-trip length of the ring.
• propagation_loss: Propagation loss.
• n_group: Group index. If None, the value of n_eff is used.
• dispersion: Chromatic dispersion coefficient.
• dispersion_slope: Chromatic dispersion slope.
• reference_frequency: Reference frequency for dispersion coefficients.
• dn_dT: Temperature sensitivity for n_eff.
• dL_dT: Temperature sensitivity for propagation_loss.
• temperature: Operating temperature.
• reference_temperature: Reference temperature.
• dn_dv: Linear voltage-dependent effective index coefficient.
• dn_dv2: Quadratic voltage-dependent effective index coefficient.
• dloss_dv: Linear voltage-dependent propagation loss coefficient.
• dloss_dv2: Quadratic voltage-dependent propagation loss coefficient.
• z0: Characteristic impedance of the electrical port used to convert the input field amplitude to voltage.
• f_3dB: -3 dB frequency cutoff for bandwidth limiting. Only active for positive values.