This page is also available as a Postscript file (13 kBytes).
abort
syntax: abort
Aborts 'read' and/or 'macro'-execution
aperture
syntax: aperture name
Move the aperture wheel to position 'name'. The named positions are defined in the file $HOME/info/wheel2
syntax: aperture ?
Prints all possible aperture-position names and the actual one.
syntax: aperture fine steps
Moves the aperture wheel 'steps' motor steps. The sign of 'steps' may be positive or negative. 1 degree is about 40 steps. ATTENTION: !!! backlash !!!
area
syntax: area x1 y1 x2 y2
Sets the area of the image that is used for all 'save' operations.
x1/y1: lower left corner
x2/y2: upper right corner
autosave
syntax: autosave {yes,on} [-f n] [-l n] [-r n1 n2] [-1] [-i] [-d]
Enables automatic 'save'-operation after a 'read'. The switches are explained with the save-command.
syntax: autosave {no,off}
Disables automatic 'save'-operation after a 'read'.
syntax: autosave ?
Prints the status of the autosave-flag.
backup
syntax: backup path
Copies all files in the directory 'path' to /dev/ndat (DAT). You must enter the full path (beginning with '/'). You have to set the actual save-path (MAGICPATH) to a different directory than the one to be copied.
The DAT-Tape is NOT rewinded at the beginning or the end of the backup, so you can copy more than one directory to the tape.
syntax: backup -abort
Aborts a running backup.
cassoff
syntax: cassoff angle
Sets 'angle' as the cassegrain-angle for the NSEW orientation.
syntax: cassoff ?
Prints the cassegrain-angle at the NSEW orientation.
casspos
syntax: casspos angle
Sets 'angle' as the actual cassegrain angle.
syntax: casspos ?
Prints the cassegrain-angle realative to NSEW. This is 'actual cass.angle' - 'cassoff'. This value is written into the FITS-headers as CASSPOS.
cd
syntax: cd [directory]
Changes directory for 'save' operations (UNIX style).
charm
syntax: charm position {number,in,out,?}
The parameters 'in' and 'out' move the mirror to the defined in/out position. '?' returns the actual position. 'number' moves it to the absolute position.
syntax: charm move steps
Moves the mirror 'steps' times 20 nanometers.
syntax: charm define {in,out}
Defines the actual mirror position as the in/out position. Recommended values are '0' for the 'out' position and '-5780000' for the 'in' position.
syntax: charm init
Initializes the CHARM mirror position. This procedure may take up to 2 minutes. While initializing you cannot talk to CHARM.
syntax: charm mode {sky,centroid,peak,?}
Defines the CHARM mode.
'sky': Take sky for later subtraction. The mirror is not tip-tilted.
'centroid': Tip-tilt correction using the centroid of the subarray.
'peak': Tip-Tilt correction using the peak-pixel in the subarray.
'cpeak box': Tip-tilt correction unsing the centroid around a box of size 'box'.
'?': returns the actual CHARM mode.
syntax: charm xgain {value,?}
Defines or prints the gain of the piezo-controller in x-direction. Recommended value is -0.84.
syntax: charm ygain {value,?}
Defines or prints the gain of the piezo-controller in y-direction. Recommended value is -0.84.
syntax: charm rotangle {value,?}
Defines or prints the rotation angle for the piezo-controller. Recommended value is 50.
clobber
syntax: clobber {yes,no,on,off}
Enables/disables overwriting existing files. Default is 'no'.
continue
syntax: continue
Continues a paused macro.
crep
syntax: crep n
Sets the cycle repeat count. When starting a measurement with 'read', 'n' images are taken.
ctype
syntax: ctype readmode [parameters]
Sets the cycle-type. Valid cycle-types 'readmode' are:
'rr': reset.read mode (no paramters)
'rrr': reset.read.read mode (no parameters)
'multi': mulitple.endpoint mode (parameter=number of endpoints)
'ramp': ramp mode (parameter=number of ramp points)
'speckle': speckle mode (parameter=number of speckle frames)
'subarray': subarray readouts only parameters: center-x center-y size
'crrr': CHARM-reset.read.read mode parameters: center-x center-y size itime(ms)
syntax: ctype ?
Prints actual cycle-type.
dir
syntax: dir [filenames] display
syntax: display [-c numcols] [-l colormap]
Starts display-module. eng_status
syntax: eng_status exit
syntax: exit filter
syntax: filter position syntax: filter ? fits
syntax: fits syntax: fits comment text syntax: fits mosstep text help
syntax: help syntax: help command history
syntax: history syntax: !! syntax: !xxx infowin
syntax: infowin init
syntax: init system syntax: init wheels syntax: init parameters interactive
syntax: interactive {on,off,yes,no} syntax: interactive ? itime syntax: itime time syntax: itime ? kill syntax: kill process load syntax: load filename [n] logfile syntax: logfile filename syntax: logfile ? ls syntax: ls [switches] [filename] lyot syntax: lyot name syntax: lyot ? macro syntax: macro filename msio syntax: msio drive command next syntax: next filename object syntax: object text syntax: object ? observer syntax: observer name syntax: observer ? pause syntax: pause polpos syntax: polpos value pwd syntax: pwd quit syntax: quit read syntax: read [n] [-c] satcheck syntax: satcheck on [limit] syntax: satcheck off save syntax: save [-f n] [-l n] [-r n1 n2] [-i] [-1] [-d] [-c] [filename] sky syntax: sky filename sound syntax: sound {on,off} syntax: sound ? sync syntax: sync [read] [tele] [wheel] telescope syntax: telescope absolute hr min sec dg min sec [equinox] syntax: telescope relative dx dy syntax: telescope position verbose syntax: verbose {on,off,yes,no} syntax: verbose ?
Executes 'ls -l' in current directory. The output stops after 1 page, to proceed with the next page, enter:
syntax: ddisplay [-c numcols] [-l colormap]
'display' uses 1x1 dots per pixel.
'ddisplay' uses 2x2 dots per pixel.
'tdisply' uses 3x3 dots per pixel.
'numcols' must be in the range 4..240 (default ist 64).
'colormap' must be one of {gray,temp,heat} (default is 'gray').
Resquests the engineering status from the camera and prints it on the screen.
After an 'init parameters' command the returned values of 'eng_status' should be like this:
Integration time 0 = 100
Time 0 granularity = 1
Integration time 1 = 500
Time 1 granularity = 1
Cycle type = 3
Cycle type memloc = e49
Cycle repeat count = 1
Pixel time [100 ns] = 15
Leave the MAGIC-shell. Subprocesses are not killed.
Where 'position' is a filter-macro defined in $HOME/info/fmacros. These macros imply the positions of the 2 filter wheels and the lyot-stop position. The aperture wheel is not effected.
Prints list of avaliable filter-macros and the actual one.
Prints the actual FITS-header. The output stops after 1 page, to proceed with the next page, enter:
Sets 'text' in the FITS-header as COMMENT.
Sets 'text' in the FITS-header as MOS-STEP.
prints the list of commands
prints information about command 'command'
Prints the command history.
Repeats the last command.
Repeats the last command that starts with 'xxx'.
Opens a window with system/camera informations.
Initialize wheels, parameters, shared memory data base (executes 'init parametes' and 'init wheels'). Use 'init system' afer a power-on of the camera.
Read filter/aperture - wheel database and move wheels to the ZERO-position. (detent-position). Use 'init wheels' after manual a movement of the wheels.
Ask for username, telescope and camera parameters. Initialize shared memory. Read filter/aperture - wheel database. Set camera parameters to the values in the shared memory. Use 'init parameters' after a change of the optics (e.g. secondary mirror).
If you use the interactive-mode, the outputs are blocked after 19 lines, until you enter
Prints status of the interactive-flag.
Set the integration-time 'time' in seconds.
Prints the actual integration-time
Sends a 'terminate' to the following subprocesses:
'process' =
- display -> disp,ddisp,tdisp
- infowin -> sawin,sewin
- satcheck -> satcheck
Loads 'n' FITS-files into the shared memory. Since the shared memory frame-buffers are unsigned short integers, the displayed values may be not correct. You also have to swtich the cycle-type to reset.read (rr).
Sets 'filename' as logfile name
Prints name of logfile.
Executes 'ls' (UNIX style)
Move the lyot-stop wheel to position 'name'. The named positions are defined in the file $HOME/info/wheel2.
Prints all possible aperture-position names and the actual one.
Executes the macro 'filename'
This macro-file contains commands like you use with the shell. Be carful when invoking commands like 'read', 'telescope' or 'filter' that run in the background. Make sure that the next command does not conflict with the previous or use the 'sync' command. The default-drectory for the macros is $HOME. If you want to start the macro test.mac in $HOME/macros then enter 'macro macros/test.mac'.
!!! You MUST NOT invoke a macro in a macro !!!
Sends 'command' to motor-drive 'drive'. (prvileged command)
This command is used for test with the filter-, lyot- and aperture wheels. 'command' uses the syntax of the motor drives: e.g.:
'move 10' moves the motor +10 steps
'move -20' moves the motor -20 steps
'pos 9000' moves the motor to the absolute position 9000
'ver p' returns the absolute position in motor steps
drive = 1: lower filter
2: lyot stop
3: upper filter
4: aperture
Sets 'filename' as the default-filename. This filename is used, when no filename is given with the 'save' command.
Sets 'text' as object in the FITS-header.
Prints the actual object.
Sets 'name' as observer in the FITS-header. This name is used as password for the privileged commands.
Prints the actual observer's name.
Stops macro execution. The macro will be continued by entering the 'continue' command or may be aborted by 'abort'.
Writes 'value' at keyword POLPOS into the FITS-header.
Shwos actual directory for the 'save' operation. (UNIX style).
Leaves the MAGIC-shell and kills all subprocesses. (e.g. display,infowin,satcheck ...)
Read 'n' images according to the actual cycle type. Default is the 'crep' parameter.
-c: continous read until 'abort'.
Switches the saturation check on. The optional limit uses absolute counts of the A/D converter. These counts range from about 10000 - 55000. The non-linearity starts at about 40000 counts, which is the default limit. If 'sound' is on, you get a accoustic warning.
Switches the saturation check off. This is recomended at intgration times smaller than about 150 ms.
Save frames in the shared mamory according to the actual cycle type (ctype).
-f: save from frame 'n' (= 'first frame is')
-l: save upto frame 'n' (= 'last frame is')
-r: save only frames from 'n1' through 'n2'. Default is all.
-i: save the integral of the selected frames.
-1: write all images into one FITS-file (cube).
-d: do not create FITS-files. Just dump the filled shared-memory-framebuffer.
-c: overwrite existing files (for this save-opereation only).
If no filename is given, the default filename is used.
Use 'filename' for sky-subtraction in the display and use this file as SKYFRAME in the FITS-header.
Enables/disables sound after some operations like 'read', 'filter', 'aperture', 'lyot', 'telescope', 'macro', or as a warning if the saturation check is on. Default is 'off'.
Prints the sound status.
Waits for termination of the read, telescope, filter, lyot-stop and aperture moving process.
Moves the telescope to the absolute position
alpha: 'hr' 'min' sec'
delta: 'dg' 'min 'sec'
Be carefull with negative declinations. If 'dg' = 0 'min' has to have the minus (`-`).
Moves the telescope 'dx' 'dy' arc-seconds.
Returns the telescope position.
If you set 'verbose yes', you will get more output to the screen. e.g. while executing a macro the system will print every command (and the line number), so you always know which macro-line is executed. Default is 'yes'.
Prints status of the verbose-flag.