NAME

image - takes a picture with the CCD camera

SYNOPSIS

image time=# [bin=] [camera=] [outfile=name] [notel] [dark] [lowfile=] [hdr] [debug] [notime] [box=sr,sc,nr,nc] | [box=cr,cc,nr,nc,1] [mode=] [minexp=]

DESCRIPTION

This program takes a picture of exposure time specified by the time flag, and writes the file image.fits in the working directory, unless over-ridden by the outfile= switch. The telescope coordinates and telescope focus are written in the FITS header unless the notel option is specified.

If the exposure time is long enough and you are running X-windows, an xtime timer will appear with an approximate count down timer.

The server on the localhost at port 0x1340 is used unless overridden by the XPC options (see tx).

The amplifier in use is not set by this command. If you want to change the amplifer use the tx ccd_setup command.

OPTIONS

time=# sets exposure time to # seconds. Mandatory.

camera= sets the camera name (default:ccd).

outfile=xxx -writes the image into the file xxxx.fits. The default is image.fits. If desired compressed files can be written if the outfile has a .gz or .fz extension (true for HDR too).

bin=m sets the square bin to n x n . (default: n=1). If the environment variable CCD_BIN is set the binning is set. The camera will change this.

box=sr,sc,nr,nc restricts the readout to a box restricted to a starting row (sr), starting column (sc), number of rows (nr) and number of columns(nr).

box=cr,cc,nr,nc,1 like the above, but with center row and center columns specified.

minexp= sets the minimum exposure time in seconds.

mode= passes the mode flag (including mode=) to the ccd command. What happens next depends on the nature of the CCD camera.

lowfile= - specifies the filename for the low gain fits file. It also sets the hdr flag as a courtesy.

hdr - uses High Dynamic Range mode (if available). You must specify a filename for the low gain using the lowfile= option.

notel - omits the telescope coordinates and telescope focus into the FITS header.

debug - more printout.

dark - to make exposure without opening shutter.

notime - removes the xtime pop up timer that is available in X-Windows.

Example

image time=1
   takes 1 second image with default binning writes file image.fits
image time=60 bin=1 outfile=m1
   takes a 60 second image with 1x1 binning and writes file m1.fits
image time=300 dark outfile=dark1.gz
   takes a 5 minute exposure with shutter close writing dark1.fits

Program index