DS9 Reference Manual
Table of Contents

Preferences

Allows the user to customize the appearance and behavior of the GUI .

Information Panel
Buttons
Colorbar
Information Panel Contents
WCS
Frame
Panner
Magnifier
Horizontal Graph
Vertical Graph
Dialog Box
Pan
Tile
Blink Interval
Examine
URL
Help
Misc
MinMax Parameters
ZScale Parameters
Save Preferences
Clear Preferences

Information Panel

Show/Hide the Information Panel. The contents of the panel may be specified below.

Buttons

Show/Hide the Button Control Panel. These buttons duplicate some of the functions available from the menus.

Colorbar

Show/Hide the Colorbar. Colorbar functionality is available, even when the colorbar is not visible.

Information Panel Contents

Controls what information is displayed in the Information Control Panel.
  • Filename

    • Show/Hide base name of the current FITS image.
  • Object

    • Show/Hide the contents of the FITS keyword OBJECT, if present.
  • Min Max

    • Show/Hide the min and max values for the current FITS image.
  • Frame Info

    • Show/Hide the frame number, zoom, and angle of the current frame.
  • WCS

    • Show/Hide WCS coordinate values, for the current FITS image, if present.
  • Detector

    • Show/Hide Detector coordinate values, for the current FITS image. Requires the DTV/DTM keywords be present in the header. See NOAO IRAF Mosaic Data Structures for more information.
  • Amplifier

    • Show/Hide Amplifier coordinate values, for the current FITS image. Requires the ATV/ATM keywords be present in the header. See NOAO IRAF Mosaic Data Structures for more information.
  • Physical

    • Show/Hide Physical or CCD coordinate values, for the current FITS image. Requires the LTV/LTM keywords be present in the header. See NOAO IRAF Mosaic Data Structures for more information.
  • Image

    • Show/Hide Image or Logical coordinate values, for the current FITS image.

    WCS

    Sets the current WCS in degrees or HMS.
  • Equatorial B1950
  • Equatorial J2000
  • ICRS
  • Galactic
  • Ecliptic
  • Degrees
  • HMS

    • Frame

    Sets the size of the display frame, within DS9.
  • Auto Size

    • Sets the frame size to be as big as possible, given the current window size.
  • 256x256

    • Sets the frame size to be 256x256, centered in the window.
  • 512x512

    • Sets the frame size to be 512x512, centered in the window.
  • 1024x1024

    • Sets the frame size to be 1024x1024, centered in the window.

    Panner

  • Orientation Compass

    • Show/Hide the image orientation compass.
  • WCS Compass

    • Show/Hide the WCS compass.
  • WCS Compass Tangent Point

    • Display the WCS compass at the tangent point or the center of the panner.

    Magnifier

  • Graphics

    • Show/Hide regions  and crosshair in the magnifier window. This is not available for the 'Fast' display algorithm.
  • Cursor

    • Show/Hide the cursor in the center of the magnifier window. This cursor displays the size and orientation of one pixel, given the current zoom, angle and orientation of the frame.
  • Display Algorithm

    • Two algorithms are available for the magnifier.
  • Fast

    • This algorithm is a fast method, best for slow machines and images that are not rotated.
  • More Accurate

    • This algorithm renders the image for the magnifier in the most accurate manner as possible. This is the default algorithm. This method is best for non factor of 2 zooms and orientations of angle other than zero.
  • Magnification

    • Current magnification factor of the image rendered into the magnifier.

    Horizontal Graph

  • Grid

    • Show/Hide the grid on the Horizontal graph.
  • Linear

    • Configure the graph for linear data.
  • Log

    • Configure the graph for log data. IMPORTANT: your data min value must be >=1 for it to display properly.

    Vertical Graph

  • Grid

    • Show/Hide the grid on the Vertical graph.
  • Linear

    • Configure the graph for linear data.
  • Log

    • Configure the graph for log data. IMPORTANT: your data min value must be >=1 for it to display properly.

    Dialog Box

  • Motif

    • All Standard Dialog boxes will be in Motif style.
  • Windows

    • All Standard Dialog boxes will be in Microsoft Windows style.
  • Blue Plate Special

    • All Standard Dialog boxes will be in the John Roll, Blue Plate Special style.

    Pan

    Configure the interactive pan method.
  • Click to Center

    • Center image at click point. Same method as SAOimage.
  • Drag to Center

    • Click, drag, and release to pan the image in the current frame

    Tile

    Configure the tiling pattern to be used while in Tile mode.
  • Grid
  • Row
  • Column

    • Blink Interval

    Set the blink interval while blinking between frames.

    Examine

    Configure the Examine function. While in examine mode, the user may indicate that all new examine operations go to one frame, or create a new frame each time. Also, the user may indicate the scale factor to be used in the examine frame. If the base frame is an image, the zoom factor is changed, if the base frame is a FITS Binary Table, the block factor is changed.

    URL

  • Show FTP Log

    • Show/Hide the FTP log window when using FTP to access an FITS image.
  • Show HTTP Log

    • Show/Hide the HTTP log window when using HTTP to access an FITS image.

    Help

  • Reference Manual URL

    • Set the URL for the reference manual documentation. To set to a local file, use: FILE://.
  • Users Manual URL

    • Set the URL for the users manual documentation. To set to a local file, use: FILE://.

    Misc

  • User Cursors

    • Change the current mouse cursor to reflect the current state of DS9. As the mouse cursor is placed over region handles, the cursor will indicate the type of function that is possible. If you wish to disable this function, unselect this item.
  • Scan for Min Max on Load

    • When an image is first loaded, indicate if the entire image is to be scanned to determine the min and max data values. This function can slow down the process of loading images greatly, so be default, it is disabled.

    MinMax Parameters

    Select the increment  interval for determining the min and max data values. The larger the interval, the quicker the process is.

    ZScale Parameters

    Select the parameters for the IRAF ZScale algorithm.

    Save Preferences

    Saves the current values of all preference items in the preference file name ~/.ds9.prefs. DO NOT EDIT this file, since it will be overwritten the next time preferences are saved.

    Clear Preferences

    Clears all current preferences. Actually deletes the ~/.ds9.prefs file, if present. The next time DS9 is started, default settings are used.