Procedure Index

• A. Preliminaries
• B. DM/WLS registration
• C. LBWFS calibration I
• D. Image sharpening


• E. LBWFS calibration II - Spectrograph
• F. WFS calibration - Spectrograph


• G. LBWFS calibration II - Imager
• H. WFS calibration - Imager
• I. KAPA calibration - Imager


• ospec PSF

Procedure

A. Preliminiaries

Bring up the AO tools

1. Open VNC viewers k1aoserver-new:2 and k1aoserver-new:3.
2. Right-click in the background of any of the VNC desktops and select LGS AO Control Menu → Start LGS Calibrations.
3. Wait for a few minutes until all GUIs are up.

Verify the following GUIs are present

• MAORI
• TT graphs
• STRAP intensity display
• The SC GUI (continously check SC GUI for faults indicated in red)
• Calibration tools GUI (Keck I calib)
• ACAM tool (ACAMTOOL) (available on the second workspace)
• LBWFS calibration GUI
• AOAcq (SIM mode)

Firefox → K1 AO WYKO display (link only works in the internal network).

Monitor PCU

• Open xterm as k1obsao@k1aoserver
• Type: xshow -s ao pcsfx pcsfy pcsflz &
• Open xterm as k1obsao@k1aoserver-new
• Launch the PCU sequencer by typing: k1pcu_seq.dsp &

Restart LBWFS camera server (optional)

• Ensure room lights and AO fiber source are off (or at least SND = BLOCK)
• Open xterm as k1obsao@k1aoserver
• Run LBWFSCamServer restart (takes about 1 minute)

Run calibrations setup

• Keck I calib → Calibration setup. When prompted:
  • Select NGS-AO
  • If promped, select ACAM and Beam Splitter
  • Dismiss Calibration setup GUI once the calibration setup is completed
• Turn HEPA off:
  • Keck I calib → Light Source Control
  • If HEPA still on, hit Click for HEPA OFF

Take a test image with ACAM

1. Keck I calib → Light Source Control → 1% = ND2
2. ACAMTOOL check that Tint(s) is 1.0
3. ACAMTOOL → goi
4. Verify that fiber source is within reasonable number of pixels of the OPT_AXIS pixel in qfix/acampo.dat; (1098.4, 856.6 in October 2024)

B. DM/WLS registration

Run DM/WLS registration

1. Keck I calib → DM Control → Clear Voltages
2. Keck I calib → DM/WLS Registration
3. After Null Centroids, if needed, run fsmoffload from the Calibration toolbox IDL terminal until Cx,Cy in the Keck I - WFS Intensity GUI are less than 0.030

Once the registration is completed (with error ≲ 0.3%), Dismiss the DM/WLS Registration window.

Run calibrations setup again in LGS

• Keck I calib → Calibration setup. When prompted:
  • Select LGS-AO
  • When promped, select sodiumDichroic, and later STRAP/LBWFS
  • Dismiss Calibration setup GUI once the calibration setup is completed

Run DM/WLS registration again in LGS

1. Keck I calib → DM/WLS Registration
2. After Null Centroids, if needed, run fsmoffload in the Calibration toolbox IDL terminal until Cx,Cy in the Keck I - WFS Intensity GUI are less than 0.030

Once the registration is completed (with error ≲ 0.3%), Dismiss the DM/WLS Registration window.

C. LBWFS calibration I

• If the LBWFS calibration GUI is not running, right-click in the background and select K1 AO tools → Other AO → LBWFS CALS

1. Click Setup for Cals and Yes to calibrate both 5x5 and 20x20 arrays.
2. When prompted, select sodiumDichroic.
3. Wait until the IDL prompt is back and the STRAP display shows STRAP: OK and TSS: INPOS.
4. Click Align TSS
5. Click DM/LBWFS Reg
• Correlation of reconstructed wavefront with actuator pattern should be between 0.92 to 0.95.

D. Image sharpening

Here are the steps for image sharpening for both the spectrograph and imager.

Set up OSIRIS GUIs

• Right click in the OSIRIS VNC background, OSIRIS Control Menu → Start OSIRIS Software.
• Yes to start the SetupNight script, and Yes to home the mechanisms.
• If OSIRIS DRP is not already running, right click in the OSIRIS VNC background, Data Reduction → OSIRIS DRP.
• If OSIRIS IDL Program is not running, right-click in the background, OSIRIS Control Menu → OSIRIS Tools → OSIRIS IDL
• If OSIRIS Quicklook tools are not running, in OSIRIS IDL Program, click Quicklook2 Spec, Quicklook2 Imager, and Quicklook2 Online.
• If OSIRIS Online Reduction GUI is not running, right-click in the background, OSIRIS Control Menu → OSIRIS Tools → Online DRP GUI

Launch image sharpening tool

• Keck I calib → Image Sharpening to start the Image Sharpening Tool
• Camera → OSIRIS
• Auto Image Sharpen
Image sharpening takes about 15 minutes to complete. A good image sharpening should yield wavefront errors less than 50 nm and XFWHM,YFWHM on the imager detector with the Kp filter of less than 4.5 pix.

The image sharpening script updates the following values for the PCU-Z postion (Lower Z value in the PCU sequencer GUI):

• optosiris, ospec, osimg: All 3 values should be identical to the best focus value reported by the image sharpening script.
• optlgs3, ospeclgs3, osimglgs3: All 3 values should be identical to each other, but there is a constant offset with respect to the optosiris, ospec, and osimg values.

The current Position in the PCU sequencer GUI will be user_def but this is normal.

E. LBWFS calibration II - Spectrograph

Check image quality on OSIRIS SPEC detector

Set up OSIRIS and fiber source to take "sky" and "target" images with the latest image-sharpened DM shape, measure FWHM of the PSF in the reduced image.

• In the OSIRIS Observation Planning GUI, set:
  • Dataset = background
  • Object = background
  • AO Type = LGS
  • LGS Mode = No Laser
  • Filter = Kn3
  • Scale = 0.02" / lenslet
  • Coadds = 1
  • Integration time = 2s
  • Imager Settings = Disabled (Spec only)
  • Send to Queue
• In the OSIRIS Telescope GUI, set:
  • Adaptive Optics → wait4ao Off
• In the OSIRIS Data Execution Client, Start Next Dataset
• In the OSIRIS Online Reduction GUI, specify the "sky" frame we just took, Calibration file → Specify a file
• In the Position dropdown list of the PCU sequencer GUI, select ospec and click GO
• Set the fiber intensity: Light Source → 1% = ND2
• In a napili terminal, type:

  osirisGoi spec

  This will use the same DDF to take a dataset.
• Or in the OOPGUI, configure the same DDF:
  • Dataset = open_loop_check
  • Object = open_loop_check
  • AO type = LGS
  • LGS mode = No Laser
  • Filter = Kn3
  • Scale = 0.020"
  • Integraiton time = 2s
  • Imager Settings = Disabled (Spec only)
  • Send to Queue
  • In the OSIRIS Data Execution Client, click Start Next Dataset to expose
• Check the open-loop image quality
  • OSIRIS Quicklook Online → Tools → Peak fit → draw a box at least 5x5 spax around the point source.
  • XFWHM,YFWHM values of ∼2 spaxels on the OSPEC detector are considered acceptable. When happy with the image quality, proceed to save LBWFS cogs.
• You can fine tune the position and the focus of the fiber source on the OSPEC field of view in a k1obsao@k1aoserver terminal using the following commands (move only by ∼0.1 - 0.2 mm at a time in the X and Y axes, and wait for the moves to be completed before exposing):
  • modify -s ao pcsfx=xxx.xx. Increasing value moves the source diagonally upwards and to the right on the OSPEC FOV.
  • modify -s ao pcsfy=xxx.xx. Increasing value moves the source diagonally downwards and to the right on the OSPEC FOV.
  • modify -s ao pcsflz=xxx.xx. Controls focus.
• Once you are happy with the location and FWHM of the fiber source on the OSPEC FOV, record the new values for the ospec named position in the k1aoObPcuNps.par parameter file. The same offset in pcsfx/pcsfy should be applied to the ospeclgs3 named position. In a k1obsao@k1aoserver terminal:
  • cd /net/k1aoserver-new/usr/local/kroot.new/rel/ao/qfix/data
  • cp cp -p k1aoObPcuNps.par k1aoObPcuNps.par_YYYYMMDD (suggestion to make a backup copy of the current parameter file)
  • vi k1aoObPcuNps.par
  • Edit the following lines as needed and save file:

    group {
        string k1:ao:pcu:name:NAME = "ospec";
        double k1:ao:pcu:name:X = 151.300500;
        double k1:ao:pcu:name:Y = 100.800000;
        double k1:ao:pcu:name:LZ = 96.5602541;
        double k1:ao:pcu:name:UZ = 0.0;
        long   k1:ao:pcu:name:define = 1;
    }

    group {
        string k1:ao:pcu:name:NAME = "ospeclgs3";
        double k1:ao:pcu:name:X = 154.850000;
        double k1:ao:pcu:name:Y = 105.000000;
        double k1:ao:pcu:name:LZ = 94.0602600;
        double k1:ao:pcu:name:UZ = 0.0;
        long   k1:ao:pcu:name:define = 1;
    }

In LBWFS Calibration GUI:

1. If you are saving spec cogs after imager calibrations, first click Setup for cals in LBWFS Cal GUI
2. Select sodiumDichroic when prompted
3. Click Save as cog
4. Examine the DM shape, it should reflect the 0-deg astig applied to the DM (DM should not be flat)
5. If the DM shape looks right, Yes to the prompt
6. Select OSPEC as the PO

Check the health of the LBWFS cog files, which are stored in /net/k1aoserver-new/usr/local/kroot.new/rel/ao/qfix/data/Lbwfs/CentOrigins. Launch IDL in a k1obsao@k1aoserver terminal:

IDL> lb = readlbcog("OSPEC-L.cog")
IDL> print, min(lb), max(lb)
    -0.778075     0.642462  
IDL> lb5 = readlbcog("OSPEC-L5x5.cog")
IDL> print, min(lb5), max(lb5)
    -0.909949     0.295984

If any of the values are outside the [-1, 1] interval, then you need to rerun Setup for Cals and Save as cog.

F. WFS calibration - Spectrograph

IMPORTANT NOTE: There is no need to save the 2x2 COGs since they are never used on sky.

First run WFS calibraiton in LGS mode:

1. Keck I calib → WFS Calibration
2. Choose instrument → OSPEC-L
3. Select → 2.4
4. After Clear Centroids, if needed, run fsmoffload from the Calibration toolbox IDL terminal until
   Cx,Cy in the Keck I - WFS Intensity GUI are less than 0.030

Run WFS calibraiton again in NGS mode:

1. Keck I calib → WFS Calibration
2. Choose instrument → OSPEC-N
3. Select → 2.4
4. After Clear Centroids, if needed, run fsmoffload from the Calibration toolbox IDL terminal until
   Cx,Cy in the Keck I - WFS Intensity GUI are less than 0.030

Once all the steps in the WFS calibration procedure have been completed, hit Dismiss in the WFS Calibration window.

G. LBWFS calibration II - Imager

Take images on OSIRIS IMAGER detector

Set up OSIRIS and the fiber source to take an image with the latest image-sharpened DM shape and measure the FWHM of the PSF.

• In the Position dropdown list of the PCU sequencer GUI, select osimg and click GO
• Keck I calib, Light source control → 1% = ND2
• In the OSIRIS Observation Planning GUI, set:
  • Dataset = open_loop_check
  • Object = open_loop_check
  • AO type = LGS
  • LGS mode = No Laser
  • Imager Settings = Independent (Imager only)
  • Filter = BrG
  • Mask = Open Circ
  • Repeats = 1
  • Coadds = 1
  • Integration time = 2s
  • Send to Queue
• In the OSIRIS Telescope GUI, set:
  • Adaptive Optics → wait4ao Off
• In the OSIRIS Data Execution Client, Start Next Dataset
• Check the open-loop image quality
  • OSIRIS Quicklook Online → Tools → Peak fit → draw a box at least 5x5 pix around the point source.
  • XFWHM,YFWHM values of ∼4.5 pix are considered acceptable. When happy with the image quality, proceed to save LBWFS cogs.

In LBWFS Calibration GUI

1. If you are saving imager cogs after spec calibrations, first Setup for cals in LBWFS Cal GUI
2. Select sodiumDichroic when prompted
3. Click Save as cog
4. Examine the DM shape, it should reflect the DM shape determined by image sharpening
   (DM should not be flat)
5. If the DM shape looks right, Yes to the prompt
6. Select OSIMG as the PO

Check the health of the LBWFS cog files, which are stored in /net/k1aoserver-new/usr/local/kroot.new/rel/ao/qfix/data/Lbwfs/CentOrigins. Launch IDL in a k1obsao@k1aoserver terminal:

IDL> lb = readlbcog("OSIMG-L.cog")
IDL> print, min(lb), max(lb)
    -0.713226     0.642023
IDL> lb5 = readlbcog("OSIMG-L5x5.cog")
IDL> print, min(lb5), max(lb5)
    -0.927180     0.394489

If any of the values are outside the [-1, 1] interval, then you need to rerun Setup for Cals and Save as cog.

H. WFS calibration - Imager

IMPORTANT NOTE: There is no need to save the 2x2 COGs since they are never used on sky.

First run WFS calibraiton in LGS mode

1. Keck I calib → WFS Calibration
2. Choose instrument → OSIMG-L
3. Select → 2.4
4. After Clear Centroids, if needed, run fsmoffload from the Calibration toolbox IDL terminal until Cx,Cy in the Keck I - WFS Intensity GUI are less than 0.030

Run WFS calibraiton again in NGS mode

1. Keck I calib → WFS Calibration
2. Choose instrument → OSIMG-N
3. Select → 2.4
4. After Clear Centroids, if needed, run fsmoffload from the Calibration toolbox IDL terminal until Cx,Cy in the Keck I - WFS Intensity GUI are less than 0.030

Once all the steps in the WFS calibration procedure have been completed, hit Dismiss in the WFS Calibration window.

IMPORTANT: Proceed to the daily image quality check procedure.

I. KAPA calibration - Images

IMPORTANT NOTE:.

First run the calibraiton setup in KAPA mode

• Keck I calib → Calibration setup. When prompted:
  • Select KAPA

• Run DM/WLS registration again in LGS
  1. Keck I calib → DM/WLS Registration
  2. After Null Centroids, if needed, run fsmoffload in the Calibration toolbox IDL terminal until Cx,Cy in the Keck I - WFS Intensity GUI are less than 0.030

  Once the registration is completed (with error ≲ 0.3%), Dismiss the DM/WLS Registration window.

• Run the image sharpening unless there is already a good DM from a previous step.

• Save the cogs for each mode
1. Keck I calib → WFS Calibration
2. Choose instrument → OSIMG-LT or OSPEC-LT
3. Select → 2.4
4. After Clear Centroids, if needed, run fsmoffload from the Calibration toolbox IDL terminal until Cx,Cy in the Keck I - WFS Intensity GUI are less than 0.030
5. The save origin button will cycle through all 4 pupils so it will take 1 minute.

• Here you should run the LBWFS calibration. However, this is exactly teh same as running the LBWFS calibration for SLGS. So you only need to do this once.

• Check the IQ
1. Select AOAcq → LTAO
2. Select the PO → OSIMG-N
3. Setup Bench
4. Acquire Even though there will be no light on the WFS
5. Manually offload the LBWFS focus to the FCS
6. Turn on the COG control
7. Check IQ

IMPORTANT: Proceed to the daily image quality check procedure.