- DataPaths: Opens a window that allows to set the data path
for the FITS files.
- QuickLook Tool: Opens the QuickLook window.
- Dewar Status: Opens the Dewar Status window.
- CCD Hardhat: Opens the CCD Hardhat window.
- File Number: Makes the File number edit window on the Direct-CCD GUI
editable.
- Please press the Enter key after you change the file number.
- Software Documentation: Opens
this
document in a web-browser.
- User Manual: Opens the official Direct-CCD user manual in a web-browser.
Direct-CCD GUI
- ExpTime: sets the exposure time (1..8200 seconds)
- Loops: number of exposures per sequence
- ExpType: sets the exposure type
- { Object, Focus, Bias, Dark, Flat }
- Readout: sets the readout mode
- { Full, Subraster }
- Binning: sets the binning for the X,Y directions
- { 1, 2, 3, 4 }
- Speed: sets the readout speed/gain combination
- Filter: moves the filter wheel to the requested position.
- Object: OBJECT value in the FITS header
- Comment: COMMENT value in the FITS header
- Start: starts a loop sequence of Loops exposures
- Snap: takes a single exposure in 4x4 binning.
- After the exposure the previous settings are automatically restored
- File: next file name number (ccdNNNN.fits)
- The number may be set using the Main Menu
- Pause: close the shutter and stop the exposure timer
- Resume: open the shutter and re-start the exposure timer
- Abort: aborts the current readout (frame will be lost)
- Stop: stops the current exposure, the shutter closes and
the readout will start immediately.
- Execute: executes the script file in the edit-box
to the right of the button.
- Disk: disk status
Data Paths
Select the data path(s) for the FITS files.
The Default button
automatically sets the path following the standard at the duPont telescope.
The Browse button opens a file selector that allows to
set an optional secondary data path (eg. an external USB disk).
Dewar Status
Displays the temperatures, heater currents and setpoints of the DSP
control loop.
CCD Hardhat
- Reset DSP/CCD-Server: Re-Load the DSP code.
- The controls below require the software to be in Engineering mode
should only be used by the instrument specialists.
- CCD Voltages:
- CDST/Gain:
Quick-Look Tool
- Color: sets color lookup table
- { Gray, BBdy, Rain, InvG }
- Stretch: sets the dynamic range of the scaling algorithm
- cuts: manual data range (edit-boxes at the top and bottom)
- med3: -3..+3 sigma around the background (median of frame)
- med5: -5..+3 sigma around the background
- 3/10: -3..+10 sigma around the background
- mima: full data range
- Scale: sets the scaling scope
- { Global, Chip }
- Mag: Magnification factor of the Magnifier window.
- Pixel: The current cursor pixel coordinate
(center of the aperture and magnifier)
and pixel value at the cursor position.
- Radius: Sets the radius for the aperture statistics
(MinMax, AveSig above).
- min/max: Minimum and maxium pixel value within the aperture.
- mean/dev: Average and standard deviation within the aperture.
- flx,fwhm: flux and FWHM estimate
- Press the 'space' key while centered on a star to calculate
an estimated FWHM and flux.
- Left mouse button: moves the Magnifier window.
- Right mouse button: adjusts the contrast and level of the color map
(SAOimage, DS9).
- Cursor keys: moves the Magnifier window by 1 pixel.
Preferences
- Speak Error Messages: Makes the computer voice say
"invalid exposure time" or similar.
- Engineering Mode: Certain features (eg. CCD-Voltages)
are not available in user mode.
- The password which will be requested when switching
to engineering mode.
- Email: The GUI sends an email if the CCD temperature
rises more than 3 [C] above the setpoint.
- Shutter Closed: sound (text) that plays after the shutter closes.
- If the string is enclosed in single quotes it will be spoken by the computer,
otherwise it will be interpreted as a path of a soundfile.
- Exposure Done: sound (text) that plays after the exposure has finished readout.
- Script Done: at the end of a (macro) script.
- Snap Binning: binning for Snap exposures.
- Saturation Level: pixels above this threshold will be displayed in red.
- Default Subraster: subraster geometry when created by the
QuickLook tool.
- Clear Display Before Readout: clears (black) the data display before
the readout starts.
- If this option is not set, the new data just overwrites the previous display
data as each line is readout.
- Trim bias section from loaded FITS files:
This allows to display the bias sections (overscan and biaslines)
- in the
QuickLook tool for FITS files loaded from disk (not for data directly read
from the array).
Scripting
Macro scripts are simple ASCII files that will be executed
sequentially; there are no loops or conditional branches.
Any parameter that is not set within the script defaults to
the current GUI value.
If the filename starts with a '/' it is assumed to be an absolute
path and is used directly as the macro file.
If not, the GUI first looks in this path (common to all users!):
/Users/Shared/Library/Application Support/Direct/Scripts
If the file is not there, the GUI looks in the current home directory.
When you create a new macro script please ensure its read/write
privileges are set to chmod a+rw so that all observers may
modify the script.
- exptime #
- set the exposure time to '#' seconds.
- loops
- set the number of exposures for the next exposure loop.
- exptype { Object , Bias, Dark, Flat }
- set the exposure type.
- object name
- set the object record in the FITS header to 'name'.
- comment text
- set the comment record in the FITS header to 'text'.
- start
- start the next exposure loop.
- move dx dy
- move the telescope by 'dx,dy' arc-seconds.
- coord dx dy
- move the telescope by 'dx,dy' arc-seconds and the guider box by '-dx,-dy'.
Instrument Software Documentation Index
2019-01-25 (2009-12-04),
Christoph C. Birk, Carnegie Observatories