Search
Text Size:
Smaller Text Normal Text Larger Text

MOSCA SEQUENCER Script Reference

MOSCA miscellaneous scripts (mosca.script in scripts)

  • log-comment "Comment in quotes" [file1 file2 file3 ...]
    Adds a remark to the FITS headers of an existing data file, in the LOGCOMME keyword.

    When invoked with just the comment, it will be applied to the latest available image with a prefix for the current night (which starts at noon) and the sequencer's instrument.

    If image names are provided, the program will test the existence of ALL them before applying the change.

    Eg.

            $ mosca.log-comment "This is a comment"

        $ mosca.log-comment "Comment for two" MOug170154 MOug170155
    Notice that there's no need to add the ".fits" after each image's name

    If no arguments are provided, a usage message is displayed
 

MOSCA acquisition scripts (mosca.script in scripts)

  • targetoff [1-4,c]
    Calculates the telescope offset required to move a target from one position on the mosaic to another and performs the required telescope offset. If run without any arguments, the target position is identified interactively by the user through an imexam session on the currently loaded DS9 image. If an argument in the range 1-4 is given to the command, the target position corresponds to the center of the CCD 1-4. If the desired target position is the center of the mosaic, the argument 'c' should be given to the command.
 

MOSCA DS9 and Analysis scripts (mosca.script in scripts)

  • setdisplay [X server]
    Set the X server on which the DS9 window will be displayed. If no X server is specified, the server from which the command is issued will be used. (Note that the X server must allow for remote connections).

  • display [file]
    Loads an image into the MOSCA DS9 display. If no file is specified, the last image obtained will be loaded. A MOSCA DS9 display will be created if none is available.

  • display-start
    Starts an empty MOSCA DS9 display.

  • focus-auto focus-step-size [image]
    Computes the best focus value from a focus sequence image taken with the command 'focus5'. If no image name is given, the last obtained image will be used. The "telescope focus-FWHM" plot shows the detected sequences, the "rejected" sequences as red crosses and the best focus is indicated as a vertical line.
    You need to kill the window to get the prompt back.
    Note 1, the computed focus value is not automatically sent the the TCS.
    Note 2, this script will only work properly with a 5 point focus sequence, not with a 3 or 7 point focus sequence.

  • overlay
    Overlays the loaded DS9 image with seeing information and marks saturated objects.

  • hicut value
    Applies a minmax scaling of the loaded image and sets the highcut to the value specified.

  • locut value
    Applies a minmax scaling of the loaded image and sets the lowcut to the value specified.

  • wcs-align [yes|no]
    Display the loaded image using world coordinates such that North is up. Called with the 'no' option, the image is aligned according to orientation on the detector.

  • zscale
    Sets the upper and lower limits of the loaded image based on the IRAF ZScale algorithm. (Displays the image values near the median image value).

  • imexam
    Initiates an IRAF imexam session on the image currently loaded into the MOSCA DS9. While active in the imexam session, no further commands can be issued from the sequencer window.

    CURSOR KEY COMMANDS: 

    ?       Print help
a       Aperture radial photometry measurement (see above for output)
c       Column plot
e       Contour plot
f       Redraw the last graph
j       Fit 1D gaussian to image lines
k       Fit 1D gaussian to image columns
l       Line plot
m       Statistics
            image[section] npixels mean median stddev min max
q       Quit
r       Radial profile plot (see above for output)
s       Surface plot
x       Print coordinates
            col line pixval [xorign yorigin dx dy r theta]

  • killdisplay
    Terminates all instances of the MOSCA DS9 display.

  • killimexam
    Terminates all MOSCA sequencer scripts related to imexam and the MOSCA DS9 display.
 

MOSCA Staff-only scripts

  • gainron [file]
    Computes detector gain and read-out-noise based on a sequence of two bias frames and two flat fields. The filename must be the last in the sequence.
    If no filename is given, the last obtained image name will be used. Calculated values are being compared to previous values before being uploaded to database.
    If the deviations from previous results are found to be too large, the script can be terminated without uploading results.

  • killpostprocess
    Terminates all MOSCA sequencer scripts and the MOSCA DS9 display. Note that this will terminate any running observing scripts.
Back to top Last modified: 12-Mar-2012