finesse.detectors.cavity_detector module

class finesse.detectors.cavity_detector.CavityPropertyDetector(*args, **kwargs)[source]

Bases: Detector

Probe for detecting the properties of a cavity.

The valid values for prop are:

  • "length" or "l": round-trip cavity length [metres],

  • "loss": round-trip loss as a fraction,

  • "finesse": the cavity finesse,

  • "fsr": free spectral range [Hz],

  • "fwhm": full-width at half-maximum (i.e. linewidth) [Hz],

  • "pole": cavity pole frequency [Hz],

  • "tau": photon storage time [s],

  • "abcd": round-trip ABCD matrix,

  • "g" or "stability": stability as g-factor,

  • "gouy": round-trip Gouy phase [deg],

  • "modesep": mode-separation frequency [Hz],

  • "resolution": cavity resolution [Hz],

  • "q": eigenmode,

  • "w": beam size at the cavity source node [metres],

  • "w0": waist size [metres],

  • "z": distance to the waist from the cavity source node [metres],

  • "zr": the Rayleigh range of the eigenmode [metres],

  • "div": divergence angle of cavity mode [radians],

  • "rc": radius of curvature of wavefront at cavity source node [metres],

  • "s": curvature of wavefront at cavity source node [1 / metres].

Parameters

namestr

Name of newly created cavity property detector.

cavitystr or Cavity

The cavity to probe. If the name is provided then the CavityPropertyDetector.cavity attribute will point to the corresponding Cavity object when adding this detector to a Model instance.

propstr or CavityProperty

Property of the cavity to probe. See above for options.

directionstr, optional; default: ‘x’

Plane to detect in.

q_as_bpbool, optional; default: False

If detecting q, should the detector output return BeamParam object instead of just a complex number.

property cavity[source]

The cavity instance being probed.

property detecting[source]

The property of the cavity which is being detected.

Getter:

Returns the detected property (read-only).

property needs_fields[source]

Flag indicating whether the detector requires light fields (i.e. solving of the interferometer matrix).

property needs_trace[source]

Flag indicating whether the detector requires beam traces.

property prop[source]