finesse.detectors.cavity_detector.CavityPropertyDetector

Overview

class finesse.detectors.cavity_detector.CavityPropertyDetector(name, cavity, prop, direction='x', q_as_bp=False)

Bases: finesse.detectors.general.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

name : str

Name of newly created cavity property detector.

cavity : str 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.

prop : str or CavityProperty

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

direction : str, optional; default: ‘x’

Plane to detect in.

q_as_bp : bool, 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