Sources

Sources are components which generate some kind of input, such as a laser which generates some optical field, or a signal generator which produces some electronic signal.

Laser

laser
l
Laser

Represents a laser producing a beam with associated properties such as power and frequency.

Syntax:

l name P=1 f=0 phase=0 signals_only=false

Required:

name: Name of the newly created laser.

Optional:

P: Power of the laser (in Watts), defaults to 1 W.

f: Frequency-offset of the laser from the default (in Hz) or Frequency object. Defaults to 0 Hz offset.

phase: Phase-offset of the laser from the default, defaults to zero.

signals_only: When True, this laser component will only inject signal sidebands. They will use the current carrier value as a scaling terms but the carrier will not be injected into the simulation. This allows a user to just inject signal sidebands into a model.

Example:

Create a 10 W laser at the carrier frequency with zero phase:

laser l1 P=10 f=0 phase=0

Ports and nodes overview

Ports

Name	Type	Nodes
p1	OPTICAL	i, o
amp	ELECTRICAL	i
dx	ELECTRICAL	i
dy	ELECTRICAL	i
frq	ELECTRICAL	i
phs	ELECTRICAL	i
pitch	ELECTRICAL	i
pwr	ELECTRICAL	i
yaw	ELECTRICAL	i
mech	MECHANICAL	x, y, z, yaw, pitch

Nodes

Name	Type	Unit
p1.i	optical	√(W)
p1.o	optical	√(W)
pwr.i	electrical	W
amp.i	electrical	√(W)
phs.i	electrical	deg
frq.i	electrical	hz
dx.i	electrical	m
dy.i	electrical	m
yaw.i	electrical	deg
pitch.i	electrical	deg
mech.x	mechanical	m
mech.y	mechanical	m
mech.z	mechanical	m
mech.yaw	mechanical	deg
mech.pitch	mechanical	deg

Couplings

From	To	Units	Coupling Type
amp.i	p1.o	√(W) / √(W)	electrical➡optical
frq.i	p1.o	√(W) / hz	electrical➡optical
phs.i	p1.o	√(W) / deg	electrical➡optical
pwr.i	p1.o	√(W) / W	electrical➡optical
mech.x	p1.o	√(W) / m	mechanical➡optical
mech.y	p1.o	√(W) / m	mechanical➡optical
mech.z	p1.o	√(W) / m	mechanical➡optical
mech.yaw	p1.o	√(W) / deg	mechanical➡optical
mech.pitch	p1.o	√(W) / deg	mechanical➡optical

Squeezer

squeezer
sq
Squeezer

Represents a squeezer producing a squeezed-light beam with a given squeezing in decibels and angle. The upper and conjugate of the lower sidebands can be excited in a signal analysis by injecting into the .upper and .lower_conj signal nodes.

Syntax:

sq name db f=0 angle=0

Required:

name: Name of the newly created squeezer.

db: Squeezing factor (in amplitude decibels). 6dB gives a factor of 2 reduction in noise.

Optional:

f: Frequency-offset of the squeezer from the default (in Hz) or Frequency object. Defaults to 0 Hz offset.

angle: Squeezing angle (in degrees). Defaults to zero.

Ports and nodes overview

Ports

Name	Type	Nodes
p1	OPTICAL	i, o
lower_conj	ELECTRICAL	i
upper	ELECTRICAL	i

Nodes

Name	Type	Unit
p1.i	optical	√(W)
p1.o	optical	√(W)
upper.i	electrical	W
lower_conj.i	electrical	W

Couplings

From	To	Units	Coupling Type
lower_conj.i	p1.o	√(W) / W	electrical➡optical
upper.i	p1.o	√(W) / W	electrical➡optical

Signal generator

signal_generator
sgen
SignalGenerator

Represents a signal generator which produces a signal with a given amplitude and phase.

Syntax:

sgen name node amplitude=1 phase=0

Required:

name: Name of newly created signal generator.

node: A node to inject a signal into.

Optional:

amplitude: Amplitude of the signal in volts.

phase: Phase-offset of the signal from the default in degrees, defaults to zero.

Ports and nodes overview

Ports

Name	Type	Nodes
port	ELECTRICAL	i

Nodes

Name	Type	Unit
amp.i	electrical	√(W)

Couplings

From	To	Units	Coupling Type

Noise source

noise
ClassicalNoise

Syntax:

noise name node ASD