gtrace.optics.cavity

cavity.py - A Cavity class and related functions for representing a Fabry-Perot cavity

Module Contents

Classes

Cavity

A class to represent a Fabry-Perot cavity.

Functions

finesse(r1, r2, power=False)

Returns the finesse of a cavity

Attributes

pi

c

sqrt

gtrace.optics.cavity.pi
gtrace.optics.cavity.c = 299792458.0
gtrace.optics.cavity.sqrt
class gtrace.optics.cavity.Cavity(r1=0.9, r2=0.99, L=1.0, R1=- 1.5, R2=1.5, wl=1.064e-06, power=False)

Bases: traits.api.HasTraits

A class to represent a Fabry-Perot cavity.

r1

Input mirror reflectivity (amplitude)

Type

float

r2

End mirror reflectivity (amplitude)

Type

float

rp1

Input mirror reflectivity (power)

Type

float

rp2

End mirror reflectivity (power)

Type

float

L

Length

Type

float

R1

ROC of the input mirror (positive when concave to incident light, i.e. convex seen from inside the cavity)

Type

float

R2

ROC of the end mirror (positive when concave to incident light, i.e. concave seen from inside the cavity)

Type

float

wl

Wavelength

Type

float

r1
r2
rp1
rp2
tp1
tp2
t1
t2
L
R1
R2
g1
g2
wl
_R1_changed(self, old, new)
_R2_changed(self, old, new)
_L_changed(self, old, new)
_r1_changed(self, old, r1)
_r2_changed(self, old, r2)
finesse(self)

Returns the finesse of the cavity.

storageTime(self)

Storage time

pole(self)

Cavity pole frequency [Hz]

Nbounce(self)

Bounce number

powerGain(self)

Ratio of the intra-cavity power to the input power.

FSR(self)

Returns the free spectral range of the cavity.

modeSpacing(self)

Return the transverse mode spacing of the cavity (commonly called gamma). It is a fractional number defined by gamma = (mode spacing frequency)/FSR.

waist(self, size=False)

Return the q-parameter or the radius of the beam at the cavity waist.

Parameters

size (boolean, optional) – if set to true, the first element of the returned tuple will be the waist size, rather than the q-parameter.

Returns

(q0, d) – This function returns a tuple with two elements. The first element is the q-parameter of the cavity mode at the cavity waist. If size=True is given, it becomes the waist size (1/e^2 radius). The second element is the distance of the cavity waist from the input mirror.

Return type

(complex, float)

spotSize(self)

Returns the beam spot sizes on the input and end mirrors as a tuple (w1,w2).

trans(self, f=0, d=0)

Returns the amplitude transmissivity of the cavity. It assumes the cavity was locked to the incident light first. Then computes the amplitude transmissivity for the light with a frequency shift f from the original light with the cavity length changed by d from the initial state.

Parameters
  • f (float, optional) – Frequency shift of the light in Hz. Defaults 0.

  • d (float, optional.) – Cavity length detuning in m. Defaults 0.

Returns

The amplitude transmissivity of the cavity (a complex number).

Return type

complex

refl(self, f=0, d=0)

Returns the amplitude reflectivity of the cavity. It assumes the cavity was locked to the incident light first. Then computes the amplitude reflectivity for the light with a frequency shift f from the original light with the cavity length changed by d from the initial state.

Parameters
  • f (float, optional) – Frequency shift of the light in Hz. Defaults 0.

  • d (float, optional.) – Cavity length detuning in m. Defaults 0.

Returns

The amplitude reflectivity of the cavity (a complex number).

Return type

complex

intra(self, f=0, d=0)

Returns the intra cavity field amplitude. It assumes the cavity was locked to the incident light first. Then computes the intra-cavity field amplitude for the light with a frequency shift f from the original light with the cavity length changed by d from the initial state.

Parameters
  • f (float, optional) – Frequency shift of the light in Hz. Defaults 0.

  • d (float, optional.) – Cavity length detuning in m. Defaults 0.

Returns

The intra-cavity field amplitude at the input mirror surface (a complex number).

Return type

complex

gtrace.optics.cavity.finesse(r1, r2, power=False)

Returns the finesse of a cavity

Parameters
  • r1 (float) – Reflectivity of the first mirror.

  • r2 (float) – Reflectivity of the second mirror.

  • power (boolean, optional) – If True, r1 and r2 are treated as power reflectivities. Otherwise, r1 and r2 are regarded as amplitude reflectivities. Defaults False.