DEIMOS user script wfi

Name

wfi -- wait for new DEIMOS image to be written to disk

Purpose

With no argument, wait for a new image to be written to disk
in the output directory, and print the name of the image to STDOUT.
With an argument, loop until the named image is written to disk.

Usage

wfi [-nowait] [-silent] [-timeout nsec] [image]

Arguments

-nowait = do not wait if image not in progress; return immediately
-silent = do not print image name
-timeout = wait up to nsec seconds for specified image to appear
image = name of the image for which to wait. This should be
the TAIL of the filename only (omit directory component)

Output

Full image name is written to stdout.

Restrictions

- If started during image readout, will not return the current image

Exit values

0 = normal completion
1 = wrong number of arguments

Example

1) Wait until next image has been written to disk:
wfi

2) Wait until image d0813_0032.fits has been written to disk,
checking each time a new image appears.
wfi d0813_0032.fits

3) Wait until image d0813_0032.fits has been written to disk,
checking every second for up to 60 seconds:
wfi -t 60 d0813_0032.fits

4) Wait only if an image is being taken...
wfi -n