DS9

CXC Science Data Systems

Masks

A mask is an image used as a 1-bit overlay on the main image.

Note that there are two different dialogs with the same title "Mask Parameters" - Analysis - Mask Parameters and Analysis - Mask Parameters - File - Open - OK - Mask Parameters.

Command:mask open
Menu:Analysis - Mask Parameters
Description:Opens the Analysis - Mask Parameters dialog

Command:mask load [filename]
Menu:Analysis - Mask Parameters - File - Open
Description:Allows the user to open an image as a 'mask'. The image is displayedin a separate graphics layer overlay on the main image with a chosen degree of transparency.

Analysis - Mask Parameters - File - Open As - Mosaic (IRAF, WCS, WFPC2) are also supported for different input types.

The mask is displayed superimposed on the data.

Command:mask transparency [value]
Menu:Analysis - Mask Parameters - Transparency
Description:Value is 0 to 100.The GUI has an adjustable slider bar to adjust the transparency.

Command:-
Menu:Analysis - Mask Parameters - File - Apply
Description:Applies the changes to the mask parameters

Command:mask system [coordsys]
Menu:Analysis - Mask Parameters - Align
Description:Provides options to align the mask image with the main image based on WCS or other coordinates.Example:mask system physical

Command:mask color [value]
Menu:Analysis - Mask Parameters - File - Open - OK - Mask Parameters - Color
Description:Set the mask color. Example: mask color red.

Command:mask mark [option]
Menu:Analysis - Mask Parameters - File - Open - OK - Mask Parameters - Block Pixel
Description:Display mask pixels if their values are consistent with the selected option.Options are nonzero, zero, nan, nonnan, range [x] [y]. For the latter the command syntax is 'mask range [x] [y]' (no 'mark')

Command:mask blend source|screen|darken|lighten
Menu:Analysis - Mask Paremeters - Blend
Description:Provides options (Source, Screen, Darken, Lighten) to blend the main and mask images.

Command:mask clear
Menu:Analysis - Mask Parameters - File - Clear
Description:Clears the current mask.

Command:mask close
Menu:Analysis - Mask Parameters - File - Close
Description:Closes the current mask.