finesse.detectors.cavity_detector.CavityPropertyDetector

Overview

class finesse.detectors.cavity_detector.CavityPropertyDetector(name, cavity, prop, direction='x', q_as_bp=False)[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.

Properties

CavityPropertyDetector.cavity

The cavity instance being probed.

CavityPropertyDetector.detecting

The property of the cavity which is being detected.

CavityPropertyDetector.needs_fields

Flag indicating whether the detector requires light fields (i.e.

CavityPropertyDetector.needs_trace

Flag indicating whether the detector requires beam traces.

CavityPropertyDetector.prop