Acquiring a zonal response matrix

set response matrix parameters in Loop Configure screen: amplitude, time delay, frame averaging, excluded frames
set normalization and Hadmard modes in Loop Configure screen. Normalization should probably be set to 1.
start zonal response matrix acquisition (zrespon in Loop Configure screen). The process runs in tmux session aol::zrepM.
stop zonal response matrix acquistion (zrespoff in Loop Configure screen).

The following files are then created:

File Archived location Description

zrespmat.fits zrespM/zrespM_${datestr}.fits zonal response matrix

wfsref0.fits wfsref0/wfsref0_${datestr}.fits WFS reference (time-averaged image)

wfsmap.fits wfsmap/wfsmap_${datestr}.fits Map of WFS elements sensitivity

dmmap.fits dmmap/dmmap_${datestr}.fits Map of DM elements sensitivity

wfsmask.fits wfsmask/wfsmask_${datestr}.fits WFS pixel mask, derived from wfsmap

dmmaskRM.fits dmmaskRM/dmmaskRM_${datestr}.fits DM actuator mask, derived from dmmap by selecting actuators with strong response

dmslaved.fits dmslaved/dmslaved_${datestr}.fits slaved DM actuators: actuators near active actuators in dmmaskRM

dmmask.fits dmmask/dmmask_${datestr}.fits DM mask: all actuators controlled (union of dmmaskRM and dmslaved)

Note that at this point, the files are NOT loaded in shared memory, but the archieved file names are stored in the staging area "conf_zrm_staged/conf_streamname.txt" for future loading.

Adopt staged configuration (upzrm in Loop Configure screen)
Load zrespm files into shared memory (SMloadzrm in Loop Configure screen)

Acquiring a modal response matrix (optional, for ZONAL DM only)

In addition to the zonal response matrix, a modal response matrix can be acquired to improve sensitivity to low-oder modes.

To do so:

activate RMMon to toggle the modal RM on.
select RM amplitude and maximum cycles per aperture (CPA)
start the acquisiton (LOresp_on)
stop the acquisiton (LOresp_off)

The following files are then created:

File Archived location Description

LOrespmat.fits LOrespM/LOrespM_${datestr}.fits Modal response matrix

respM_LOmodes.fits LODMmodes/LODMmodes_${datestr}.fits Low-order modes

LOwfsref0.fits LOwfsref0/LOwfsref0_${datestr}.fits WFS reference measured during LO RM acquisition

LOwfsmap.fits LOwfsmap/LOwfsmap_${datestr}.fits Map of WFS elements sensitivity

LOdmmap.fits LOdmmap/LOdmmap_${datestr}.fits Map of DM elements sensitivity

LOwfsmask.fits LOwfsmask/LOwfsmask_${datestr}.fits WFS pixel mask, derived from wfsmap

LOdmmask.fits LOdmmask/LOdmmask_${datestr}.fits DM actuator mask, derived from dmmap by selecting actuators with strong response

Note that at this point, the files are NOT loaded in shared memory, but the archieved file names are stored in the staging area "conf_mrm_staged//conf_streamname.txt" for future loading.

Adopt staged configuration (upmrm in Loop Configure screen)
Load LOrespm files into shared memory (SMloadmrm in Loop Configure screen)

Automatic system calibration (recommended)

The automatic system calibration performs all steps listed above under zonal and modal response matrix acquisition.

The old calibrations are archived as follows:

"conf_zrm_staged" and "conf_mrm_staged" hold the new configuration (zonal and modal respectively)
"conf_zrm_staged.000" and "conf_mrm_staged.000" hold the previous configuration (previously "conf_zrm_staged" and "conf_mrm_staged")
"conf_zrm_staged.001" and "conf_mrm_staged.001" hold the configuration previously named "conf_zrm_staged.000" and "conf_mrm_staged.000"
etc for a total of 20 configuration

Managing configurations

At any given time, the current configuration (including control matrices if they have been computed) can be saved using the SAVE CURRENT SYSTEM CALIBRATION command. Saving a configuration will save all files in the conf directory into a user-specified directory.

Previously saved configurations can be loaded with the LOAD SAVED SYSTEM CALIBRATION command. This will load saved files into the conf directory and load all files into shared memory.