Real-time Code
The real-time adaptive optics code runs on real and is started at the command line by typing shaneao. Most interaction with the real-time code for controlling the adaptive optics (AO) system will be done through the ShaneAO GUI, however the numerous commands that are available at the command line are documented here.
Commonly used commands used in shaneao are:
- crib()
- Show list of commands with short descriptions.
crib(cmd) to get more information on a particular command.
Example: crib(rate) - bias()
- Set the woofer and tweeter actuator voltages to their midrange values.
Nominally this bias is 21500 for the tweeter and 0 for the woofer.
This command will open the loop.
Other commands available in shaneao are:
- help()
- Lists all commands with brief description.
help(cmd) to get help on a particular command.
Example: help(rate)
Telemetry ShaneAO Python Module
To take telemetry data automatically when loops are closed, use the telemetry commands included in /u/gavel/cvs/lroot/ShaneAO/unreal/py/modules/telemetry.py.
To start the telemetry recorder script in the background, use the command telemetry.start(). To stop it (e.g. at the end of the night), type telemetry.stop(). If you need to stop the script immediately, use the command telemetry.stop(block=False). To see the status use telemetry.status().
In case you want to take open loop data (e.g. at the beginning of the night for calibration purposes), use the command telemetry.openloop()
There are a few configurable keywords, which can be adjusted through
telemetry.configure. Arguments are:
- ndumps: The number of consecutive telemetry datasets to record at a time. (Default: 5)
- interval: The interavel, in minutes, between telemetry data recording. (Default: 15)
- settled: Either True or False. When True, it requires that the AO system think that the loop is "settled" when starting to record telemetry. (Default: True)
- max_datasets: The maximum number of telmetry datasets to record in a single session. (Default: 128)
For more information, go to https://gist.github.com/alexrudy/2b2d97d94009cdb21bd0.
Ancillary Software
Measuring the seeing from open loop data taken with the COG centroider
can be done with the dimm
program. This program runs as gavel@real. Syntax is as follows:
dimm
dimm assumes the current date is the proper directory to look for the file.
There are other command line functions available in case you need to look for
data in another date directory:
dimm [-h --help | -d date ] filenum
Use DIMM analysis to produce a histogram of possible seeing FWHM
given an open-loop data telemetry file (result from a ShaneAO 'data()' command)
Arguments:
-h, --help: print help
-d date: set the date of the desired file directory using the format
YYYY-MM-DD. Default is today's date
filenum: an integer. Data files are named Data_xxxx.fits where xxxx is
the file number. You don't need the leading 0s.
Examples:
dimm 2 <- evaluate file Data_0002.fits in the present night's directory
dimm 0002 <- leading zeros are ok
dimm -d 2015-06-29 2 <- evaluate file Data_0002.fits in June 29, 2015 directory
dimm -d 6-29 2 <- present year is implied
dimm -d 29 2 <- present year and month is implied
dimm /local/data/telemetry/2015-06-30/Data_0002.fits <- evaluate a specific file
sa@ucolick.org
Last modified: Sat Nov 28 18:32:11 PST 2015