DEIMOS user script tvfocloop

Name

tvfocloop -- increment TV focus when images are saved

Purpose

Move the TV focus through a series of values, pausing at
each focus position until new camera image(s) have been saved.

Usage

tvfocloop [-wait n] <start> [n [incr]]

Arguments

-wait = wait for <n> camera images to appear before moving (default=1)
start = starting tv focus position (units)
n = number of focus positions to test (default=7)
incr = increment in focus [mm] (default=20 units)

Output

Restrictions

The script will not actually *take* the TV guider frames;
this must be done by the OA using Xguide.

Exit values

0 = normal completion
1 = wrong number of arguments
3 = start and/or incr are not valid floats
4 = n too large

Example

1) To acquire TV guider frames in the least painful manner,
ask the OA to save a sequence (perhaps 30) of guider frames,
then execute the script, specifying that the script will pause
until TWO new images have been written:
tvfocloop -wait 2 900 11 20