= Most of the info here is obsolete as of June 2021 =
## page was renamed from Locking Scripts
Also please see the [[Computers_and_Scripts/All_Scripts| All script]] page.
{{attachment:lock.png}}
|| ''''' Category ''''' || '''''Name''''' || ''''' location ''''' || ''''' function ''''' || ''''' Notes ''''' ||
|| ''''' XARM ''''' || [[#C1configureXarm|C1configureXarm]]|| {{{ burt/C1ifoconfigure }}} || lock X arm with AS55I || Available on C1IFO_CONFIGURE screen. ||
|| || [[#C1saveAAA|C1saveXARM]] || {{{ burt/C1ifoconfigure }}} || save the configuration for X arm locking || ||
|| || [[#alignX|alignX]] || {{{ scripts/AutoDither/ }}} || align the X arm with dithering technique || [[Dither_ASC]]||
|| ''''' YARM ''''' || [[#C1configureYarm|C1configureYarm]]|| {{{ burt/C1ifoconfigure }}} || locks Y arm with AS55I || Available on C1IFO_CONFIGURE screen. ||
|| || [[#C1saveAAA|C1saveYARM]] || {{{ burt/C1ifoconfigure }}} || save the configuration for Y arm locking || ||
|| || [[#alignY|alignY]] || {{{ scripts/AutoDither }}} || align the X arm with dithering technique || Available on C1IFO_CONFIGURE screen [[Dither_ASC]]||
|| ''''' PRMI ''''' || [[#C1configurePRM|C1configurePRM]] ||{{{ burt/C1ifoconfigure }}} ||locks PRMI ||Available on C1IFO_CONFIGURE screen. ||
|| || [[#C1saveAAA|C1savePRM]] || {{{ burt/C1ifoconfigure }}} || save the configuration for PRMI locking || ||
|| ''''' DRMI ''''' || [[#C1configureDRM|C1configureDRM]] ||{{{ burt/C1ifoconfigure }}} || || Available on C1IFO_CONFIGURE screen.||
|| || [[#C1saveAAA|C1saveDRM]] || {{{ burt/C1ifoconfigure }}} || save the configuration for DRMI locking || ||
|| ''''' FPMI ''''' || [[#C1configureAAA|C1configureFPMI]] ||{{{ burt/C1ifoconfigure }}} || || ||
|| || [[#C1saveAAA|C1saveFPMI]] || {{{ burt/C1ifoconfigure }}} || save the configuration for FPMI locking || need modification||
|| ''''' DRFPMI ''''' || [[#C1configureAAA|C1configureFULL]] ||{{{ burt/C1ifoconfigure }}} || || Available on C1IFO_CONFIGURE screen. ||
|| || [[#C1saveAAA|C1saveFULL]] || {{{ burt/C1ifoconfigure }}} || save the configuration for full locking || ||
|| ''''' ALS '''''|| || || || ||
|| ||[[#single_arm_lock|single_arm_lock]] || {{{scripts/ALS}}}|| brings the single arm to its resonance || under development ||
|| ''''' General '''''|| || || || ||
|| || [[#goinghome|goinghome]]||{{{scripts/LSC/}}} || run it when you go home || ||
<
>
<
>
<
>
-----
<>
= C1configureAAA =
<>
<>
== if AAA = Xarm or Yarm ==
. This script locks the X arm / Y arm using AS55_I signal (as of 2011/May/23). The script will automatically restore the necessary optics and misalign the unwanted optics. Then configures the input and output LSC matrices and gains according to {{{C1configure_Xarm.snap}}} or {{{C1configure_Yarm.snap}}}. Also switches the proper servo filters on.
. {{{
On the C1IFO_CONFIGURE.adl screen,
click the script button for Xarm/Yarm and choose "restore Xarm/Yarm"
}}}
<>
== else if AAA = MI ==
. This script locks the short Michelson (MI), composed of ITMs and BS, using AS55_Q (as of 2011/May/23). The script will automatically restore the necessary optics and misalign the unwanted optics. Then configures the input and output LSC matrices and gains according to {{{C1configure_MI.snap}}}. Also switches the proper servo filters on.
. {{{
On the C1IFO_CONFIGURE.adl screen,
click the script button for PRM and choose "restore PRM"
}}}
<>
== else if AAA = PRM ==
. This script locks the Power-Recycled Michelson (PRMI) using AS55_Q and REFL11_I for MICH and PRC respectively (as of 2011/May/23). The script will automatically restore the necessary optics and misalign the unwanted optics. Then configures the input and output LSC matrices and gains according to {{{C1configure_PRM.snap}}}. Also switches the proper servo filters on.
. {{{
On the C1IFO_CONFIGURE.adl screen,
click the script button for PRM and choose "restore PRM"
}}}
<>
== else if AAA = DRM ==
. This script locks the Dual-Recycled Michelson (DRMI) using AS55_Q, AS55_I and REFL11_I for MICH, SRC and PRC respectively (as of 2011/May/23). The script will automatically restore the necessary optics and misalign the unwanted optics. Then configures the input and output LSC matrices and gains according to {{{C1configure_DRM.snap}}}. Also switches the proper servo filters on.
. {{{
On the C1IFO_CONFIGURE.adl screen,
click the script button for DRM and choose "restore DRM"
}}}
<
>
<>
= C1saveAAA =
. ''' where AAA = (Xarm, Yarm, MI, PRM, DRM, FPMI, LSC, FULL) '''
. This script saves the gains and the LSC input and output matrices for a particular locking condition of AAA. The values that this script will save are specified by request files, {{{ C1configure_AAA.req}}}. The values will be saved in snapshot files, {{{ C1configure_AAA.snap}}}. These snapshot files are called from the locking scripts, {{{ C1configureAAA}}}. For a check one can look at log files {{{ C1configure_AAA.log}}}.
.{{{
usage : C1saveAAA
}}}
<
>
<>
= single_arm_lock =
. With aid from the auxiliary green laser, this script automatically brings the single arm cavity to
its resonance point and then hand over the servo from that of ALS to IR PDH.
. {{{
Example usage:
single_arm_lock -v
Help:
single_arm_lock -h
}}}
<
>
<>
= goinghome =
. This a script for lazy persons. This scripts automatically shut off the LSC and ALS feedback in order to avoid accidental actuation on the suspensions.
. {{{
Example usage:
goinghome
}}}
= Links =
. [[How_To/Lock_the_Interferometer]]
-----
<
>
<
>
Here are the scripts used for locking ''' in the past''', and what they do:
= Full IFO Locking in the old school =
----------------
In the '''/cvs/cds/caltech/scripts/c1''' directory:
These are scripts for locking the full IFO, not subparts.
'''c1_watch''' watches the state of the IFO, by looking at the transmitted arm power. When both arms are seen to
have an arm power of 0.5 or greater, it runs the '''c1_aqstep'''. While waiting for lock, it tickles the ETMs. If
it tickles for a few minutes without seeing a lock, it turns the LSC output off and then on, to break any bad-mode locks.
It keeps track of how long it's been trying to lock the IFO, and prompts the user to check on the MC if it's been waiting
a long time. After running the '''c1_aqstep''' script, it keeps track of how long the IFO has been locked. When it sees
a lock loss event, it runs the '''c1_detdown''' script. Should just be left running in a terminal.
'''c1_detdown''' sets all the filter switches and gains to the lock-acquisition state (low-gain, no common mode, no boosts, etc.)
To be run immediately after a lock-loss, or at the very beginning of locking. Called automatically by '''c1_watch'''
'''c1_aqstep''' to be run immediately after locking. It ramps up gains, turns on boosts, and hands off signals
(PRC -> SPDD)
(MICH -> APDD)
(DARM -> AP166)
Called automatically by '''c1_watch'''
'''c1_detstep''' to be run after '''c1_aqstep''' finishes. It hands off CARM to common-mode, then ramps down the CARM offset, engages
the analog common mode servo, hands off CARM control to REFL_DC, reduces the offset some more, engages the RF path of the common mode servo
(currently from POX33), then reduces the offset the rest of the way. Run by hand. '''offloadMCF''' must be running concurrently for '''c1_detstep'''
to succeed.
----------------------------
In the directory '''/cvs/cds/caltech/scripts/LSC''':
'''offloadMCF''' The ultra-low bandwidth common-mode servo. It takes the DC value of MCF and feeds it back to the ETMs.
'''ETM_tickle''' Tickles the ETMs until both arm powers go above 0.5. Mostly deprecated by '''c1_watch''', but still occasionally usefull. Watch out for multiple instances!
'''LSCoffsets''' Digitally cancels the electronic offsets for all LSC photodiode signals. It makes darkness by mis-aligning the mode-cleaner, so the
MC2 YAW TM offset must be enabled (on the main SUS screen for MC2).