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
|| Name of the input LRIS image showing slitmask alignment boxes.
|| 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
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
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
- The program then enters interactive mode, in which
you can issue the following keyboard commands:
|| Mark a new box at the current cursor location.
|| Delete the box nearest to the current cursor position.
|| Delete all boxes.
|| Shift one box.
|| Shift all boxes.
|| Shift all boxes to the right by 21 pixels.
|| Shift all boxes to the left by 21 pixels.
|| quit and save the boxes. Will launch do_lbox
on exit if dolbox=yes.
|| 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).
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
- 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.