atomiq.components.lock

Classes

Lock	This is a very generic class to describe a laser lock. It is characterized by some means
DetunableLock	This is a very generic class to describe a laser lock where the lock offset can be
SpectroscopyLock	This is a very generic class to describe a laser lock. It is characterized by some means
SidebandLock	Lock on a sideband modulated onto the laser
OFCLock	Lock on an optical frequency comb
OffsetLock	Lock on a reference laser via beating signal

Module Contents

class atomiq.components.lock.Lock(reference_frequency, lock_offset=0.0, harmonic=1, *args, **kwargs)

Bases: atomiq.components.primitives.Component

This is a very generic class to describe a laser lock. It is characterized by some means of a reference frequency and an offset to that frequency at which the lock tries to stabilize.

Most likely you want to use a more specific class inherited from this one.

Parameters:

• reference_frequency (artiq.language.types.TFloat) -- The frequency in Hz that the lock references to

• lock_offset (artiq.language.types.TFloat) -- The frequency offset in Hz at which the lock stabilizes

• harmonic (artiq.language.types.TInt32) -- Use this option if the laser is frequency converted but locked to the fundamental. Use 1 for no conversion, 2 for SHG, 4 for FHG ,... (default 1)

kernel_invariants

_lock_offset = 0.0

reference_frequency

harmonic = 1

get_frequency()

Return type:

artiq.language.types.TFloat

class atomiq.components.lock.DetunableLock(settle_time=0, blind=False, *args, **kwargs)

Bases: Lock, atomiq.components.primitives.Parametrizable

This is a very generic class to describe a laser lock where the lock offset can be changed. It is characterized by some means of a reference frequency and a detunable offset to that frequency at which the lock tries to stabilize.

Most likely you want to use a more specific class inherited from this one.

Parameters:

• settle_time (artiq.language.types.TFloat) -- Time in s the lock needs to settle after a detuning of the lock point

• blind (artiq.language.types.TBool) -- Wether the lock is set to its default values during each prerun phase. If True, the lock is unchanged in the prerun phase. Defaults to False.

kernel_invariants

settle_time = 0

_prerun()

Specify here what should be done for this component before the run starts. In contrast to the _build() method, the _prerun() routine is executed on the core device before the actual experiment starts.

abstractmethod _set_lock_frequency(detuning)

Parameters:

detuning (artiq.language.types.TFloat)

set_frequency(frequency)

Set the absolute frequency of the locked line

Parameters:

frequency (artiq.language.types.TFloat) -- The absoulte frequency at which the system should lock

set_detuning(offset_frequency)

Set the frequency relative to the reference frequency, i.e. set the lock offset.

Parameters:

offset_frequency (artiq.language.types.TFloat) -- new lock offset in Hz

class atomiq.components.lock.SpectroscopyLock(reference_frequency, lock_offset=0.0, harmonic=1, *args, **kwargs)

Bases: Lock

This is a very generic class to describe a laser lock. It is characterized by some means of a reference frequency and an offset to that frequency at which the lock tries to stabilize.

Most likely you want to use a more specific class inherited from this one.

Parameters:

• reference_frequency (artiq.language.types.TFloat) -- The frequency in Hz that the lock references to

• lock_offset (artiq.language.types.TFloat) -- The frequency offset in Hz at which the lock stabilizes

• harmonic (artiq.language.types.TInt32) -- Use this option if the laser is frequency converted but locked to the fundamental. Use 1 for no conversion, 2 for SHG, 4 for FHG ,... (default 1)

class atomiq.components.lock.SidebandLock(rf_source, sideband_order=1, *args, **kwargs)

Bases: DetunableLock

Lock on a sideband modulated onto the laser

This kind of lock is frequently used when locking on tunable sideband to the transmission signal of a stable cavity. The offset frequency for the sideband is generated by an RF source and can be changed at runtime. Thus the lock point can be detuned.

Parameters:

• rf_source (RFSource) -- RF source that determines the sideband frequency.

• sideband_order (artiq.language.types.TInt32) -- Order of the sideband the laser is locked to [.., -2, -1, 1, 2, ...] (default 1)

kernel_invariants

rf_source

sideband_order = 1

_set_lock_frequency(frequency)

Parameters:

frequency (artiq.language.types.TFloat)

class atomiq.components.lock.OFCLock(rf_source, lock_direction=1, tooth_number=-1, rep_rate=float('nan'), ceo=float('nan'), *args, **kwargs)

Bases: DetunableLock

Lock on an optical frequency comb

This is used to lock the laser on a beat note with an optical frequency comb. It is characterized by the frequency of the closest comb tooth and the offset frequency. The offset frequency is generated by an RF source and can be changed at runtime. Thus the lock point can be detuned.

Parameters:

• rfsource -- RF source that generates the reference beat frequency (i.e. the offset frequency) to which the laser beat note is stabilized.

• reference_frequency -- The frequency in Hz of the comb tooth. Instead ceo, rep_rate and tooth_number) can be passed to automatically calculate the reference frequency. reference_frequency is ignored in this case.

• lock_offset -- The default frequency offset to the comb tooth in Hz at which the lock stabilizes

• settle_time -- Time in s the lock needs to settle after a detuning of the lock point

• lock_direction (artiq.language.types.TInt32) -- Whether the laser is locked to the positive (+1) or negative (-1) beat note (default 1)

• tooth_number (artiq.language.types.TInt32) -- Number of the comb tooth, the laser is beaten with (default -1)

• rep_rate (artiq.language.types.TFloat) -- Repetition frequency of the comb in Hz (default nan)

• ceo (artiq.language.types.TFloat) -- Ceo frequency of the comb in Hz (default nan)

• rf_source (RFSource)

kernel_invariants

rf_source

lock_direction = 1

_set_lock_frequency(frequency)

Parameters:

frequency (artiq.language.types.TFloat)

class atomiq.components.lock.OffsetLock(reference_laser, *args, **kwargs)

Bases: SidebandLock

Lock on a reference laser via beating signal

Parameters:

reference_laser -- laser that is used to generate the beat note. It's frequency serves as the reference frequency for this lock

kernel_invariants

reference_laser

get_frequency()

Return type:

artiq.language.types.TFloat

set_frequency(frequency)

Set the absolute frequency of the locked line

Parameters:

frequency (artiq.language.types.TFloat) -- The absoulte frequency at which the system should lock