Name

do_check_boxes -- define and verify slitmask alignment box coordinates using either blue or red side data with default settings. Analyzes the image in progress if currently taking data or the most recent image if no image is in progress.

check_boxes -- define and verify slitmask alignment box coordinates using blue or red side data

Usage

do_check_boxes [image]

check_boxes image

Parameters

optional
image	Name of the input LRIS image showing slitmask alignment boxes.
maskname.box	Defaults to using a coordinate file named `maskname.box`, and has the x,y coordinates for box centers. The maskname is as seen in xlirs or the header keyword slitname. You can force a naming convention by specifying a name (not recommended).
doxbox = yes	Flag whether to run the xbox task after boxes have been verified.

Description

The check_boxes and do_check_boxes tasks have you interactively define the list of box coordinates required by the do_lbox and lbox routines for slitmask alignment, and to verify visually that existing coordinates match up with their respective boxes.

After launching the routine:

The specified image will be displayed on the ds9 display and the cursor will be moved onto the image display.
If you have already created a coordinate file for the mask, the positions will be read from the file and marked on the image display.

The program then enters interactive mode, in which you can issue the following keyboard commands:

m	Mark a new box at the current cursor location.
d	Delete the box nearest to the current cursor position.
D	Delete all boxes.
s	Shift one box. Step 1: center cursor on any box and press key: Does not have to be exactly centered because the program locates the nearest box to the cursor position. Step 2: center cursor on new box position and press key: Center the object well. Redisplays the image.
S	Shift all boxes. Step 1: center cursor on any box and press key: Does not have to be exactly centered because the program locates the nearest box to the cursor position. Step 2: center cursor on new box position and press key: Center the object well. Redisplays the image.
+	Shift all boxes to the right by 21 pixels.
-	Shift all boxes to the left by 21 pixels.
q	quit and save the boxes. Will launch do_lbox on exit if dolbox=yes.
I	quit without saving (abort).

Press the q key when done identifying alignment boxes. If dolbox=yes (default), the routine will launch do_lbox at the end of the routine.
On exit, the routines write the locations of the marked boxes to the coordinate file (default maskname.box).

Examples

Creating a New Coordinate List

It isn't necessary to spend time tabulating slitmask alignment box coordinates into files because with check_boxes you can do it in a few seconds. Follow these steps to generate a new coordinate list and not run xbox:

Type "check_boxes dolbox-" to run the program; you will be prompted to enter the name of the input image. The program will send the image to the image display.
For each alignment box, put the image cursor over the center of the box and press "m" to mark the box. The program will draw a red circle around each box.
Type "q" to quit the task after the alignment boxes are identified.

Verifying an Existing Coordinate List

If you have a coordinate list already, you can use check_boxes as a "sanity check" to preview your box coordinates and ensure that lbox will be able to find them.

Type "check_boxes doxbox+" to run the program; you will be prompted to enter the name of the input image. The program will send the image to the image display and mark the positions of the boxes you've defined.
Visually inspect the image and verify that each alignment box lies within the corresponding red circle, which indicates the coordinates you input. If a single box requires adjustment, use the "s" key to shift it. If all boxes are off by a constant amount, use the "S" key to shift them all in parallel.
Type "q" to quit the task and proceed with lbox.