Back to Programs

adjust-mask

Like align-mask, adjust-mask uses a direct or dispersed image to make adjustments to a dewar offset file. However, adjust-mask does this by user interaction, allowing one to make corrections in cases where the image is too complex or confused for the automated process to work.

 

USAGE

adjust-mask -o observset -f framename  [-d newdef]

INPUT

 

 

framename is a set of image files containing a direct or dispersed image of a slitmask. observset.obsdef is the name of an existing observation definition file which describes the observing setup used for the frame and specifies an existing dewar offset file . newdef.dewoff is an optional name for the new dewar offset file.

OUTPUT

framename.dewoff, or newdef.dewoff a new dewar offset file, and an updated observset.obsdef file.

PARAMETERS

adjust-mask uses the parameter set of mark-slits to control the marking of slit images

 

Details:

adjust-mask displays the specified frame in a ds9 window, then marks the predicted locations of the slit images. The user is prompted to click on the true and predicted locations of slit images in the center, then at the edge of the field, from which corrections are made to the scale, x,y offset and rotation angle of the dewar offset file. A new dewar offset file of name framename.dewoff or newdef.dewoff is created and the observation definition file is updated with the name of the new dewar offset file.

adjust-mask is most useful in two situations; when the current dewar offset is so far off that align-mask is unable to match existing and predicted locations of features, or when the image is confused, for example when mapping the location of zero and second order images lying on top of a first order spectrum. Because it relies on mouse pointing for locations, it is not precise, but  the dewar offset files  it produces are adequate for input into align-mask, and to predict location of unwanted spectrum orders for input to badorders. In the latter case, where different orders may require different dewar offsets, one can specify a unique name for each using the -d newdef input parameter.

Back to Programs