Overview

SCExAO system pyramid WFS. Low-resolution WFS mode (120x120)

This is a (nearly) full-featured example for a single input / single output control loop.

Running the example

⚠️ Check the instructions before running these steps

Setting up processes

# Deploy configuration :
# download from source to current directory
cacao-loop-deploy -c ao3k-ttoff188

# OPTIONAL: Change loop number, name, DM index, simulation DM index:
# CACAO_LOOPNUMBER=7 cacao-loop-deploy -c scexao-vispyr-bin2
# CACAO_LOOPNUMBER=7 CACAO_DMINDEX="03" cacao-loop-deploy -c scexao-vispyr-bin2

# OPTIONAL: Edit file scexao-vispyr-bin2-conf/cacaovars.bash as needed
# For example, change loop index, DM index, etc ...

# Run deployment (starts conf processes)
cacao-loop-deploy -r ao3k-ttoff188

# Note: the copy and run steps can be done at once with:
# cacao-loop-deploy scexao-vispyr-bin2


# Go to rootdir, from which user controls the loop
cd nirpyr188-rootdir

# select simulation mode
./scripts/aorun-setmode-sim
# (alternatively, run ./scripts/aorun-setmode-hardw to connect to hardware)

Run DM and WFS simulators

# Run hardware DM (optional if running in simulation mode)
# cacao-aorun-000-dm start

# Run simulation DM
cacao-aorun-001-dmsim start

Measure WFS dark

cacao-aorun-005-takedark -n 2000

Start WFS acquisition

# Acquire WFS frames
cacao-aorun-025-acqWFS -w start

# Acquire WFS reference
cacao-aorun-026-takeref -n 2000

Measure DM to WFS latency

# Measure latency
cacao-aorun-020-mlat -w

Acquire response matrix

Prepare DM poke modes

# Create DM poke mode cubes
cacao-mkDMpokemodes -z 5 -c 25

The following files are written to ./conf/RMmodesDM/

File	Contents
DMmask.fits	DM mask
FpokesC.<CPA>.fits	Fourier modes (where <CPA> is an integer)
ZpokesC.<NUM>.fits	Zernike modes (where <NUM> is the number of modes)
HpokeC.fits	Hadamard modes
Hmat.fits	Hadamard matrix (to convert Hadamard-zonal)
Hpixindex.fits	Hadamard pixel index
SmodesC.fits	Simple (single actuator) pokes

Run acquisition

# Acquire response matrix - Hadamard modes
cacao-aorun-030-acqlinResp -n 200 -w HpokeC.fits
# 6 cycles - default is 10.

Decode Hadamard matrix

cacao-aorun-031-RMHdecode

Compute control matrix (straight)

Compute control modes, in both WFS and DM spaces.

cacao-fpsctrl setval compstrCM svdlim 0.000001

Then run the compstrCM process to compute CM and load it to shared memory :

cacao-aorun-039-compstrCM

Running the loop

Select GPUs for the modal decomposition (WFS->modes) and expansion (modes->DM) MVMs

cacao-fpsctrl setval wfs2cmodeval GPUindex 99
cacao-fpsctrl setval mvalC2dm GPUindex 99

Start the 3 control loop processes :

# start WFS -> mode coefficient values
cacao-aorun-050-wfs2cmval start

# start modal filtering
cacao-aorun-060-mfilt start

# start mode coeff values -> DM
cacao-aorun-070-cmval2dm start

Closing the loop and setting loop parameters with mfilt:

# Set loop gain
cacao-fpsctrl setval mfilt loopgain 0.01

# Set loop mult
cacao-fpsctrl setval mfilt loopmult 0.999

# close loop
cacao-fpsctrl setval mfilt loopON ON

Cleanup

cacao-task-manager -C 0 ao3k-ttoff188
rm -rf .ttoff188.cacaotaskmanager-log

THE END