Name

check_boxesb -- define and verify slitmask alignment box coordinates using blue side data

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

Usage

check_boxesb image input

check_boxes image input

Parameters

images	Name of the input LRIS image showing slitmask alignment boxes.
input	Name of the file listing alignment box coordinates.
doxbox = yes	Flag whether to run the xbox task after boxes have been verified.

Description

The check_boxesb (blue side) and check_boxes (red side) tasks allow you to define interactively the list of box coordinates required by the xboxb and xbox program for slitmask alignment, and to verify visually that existing coordinates match up with their respective boxes. The programs apply the same shifts to the coordinates, and hence prevents confusion caused by the change in coordinates between IRAF and FIGDISP coordinates.

After launching the routine:

The specified image will be displayed on the imtool 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 xboxb or xbox on exit if doxbox=yes.
I	quit without saving (abort).

Press the q key when done identifying alignment boxes. If doxbox=yes (default), the routine will launch xboxb for the blue side or. xbox for the red side.
On exit, the routines write the locations of the marked boxes to the coordinate file.

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 doxbox-" to run the program; you will be prompted to enter the name of the input image and the name of the box file to create. 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 xbox 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 and the name of the box file to create. 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 xbox.