Display Window Menus

The window that displays the raster image and information of the selected data set is called the Display window; it has four menu buttons, File, Edit, Scale, and Options.

Figure 2.8: Display Window

File Menu

The File menu has five choices: Print Image, Redisplay Image, Update file's rc, Create filerc.list, and Close View.

Print Image

Selecting this item will create a PostScript file of the current raster image. A few parameters of the output PostScript image are changeable using the Print Options setup panel, see Section 2.3.2. In some situations you may wish to customize the hardcopy output in a manner that is not possible to do within aipsview. In these cases, the output PostScript file can be read into a page layout tool, such as the publicly available xfig program, which can be used for additional customization. The filename will be the window's label (without the scale information) with .ps appended. Aipsview prints the name of the PostScript file to the xterm from which aipsview was started. It is possible to override the filename and/or device through environment variables, see Appendix (A.1.1). Black and white vector colors have been interchanged from the screen display so the text will show up on white paper backgrounds. Other than this, the output should be fairly close to what is in the window. Out of bounds data are mapped to the ends of the colormap: values lower than the data clip minimum are given the first value, and values greater than the clip maximum are given the maximum colormap value. Blanked data are mapped to white. There is a limitation that the output image will only be given as many colors as the image in the window (i.e., if your window only has 40 colors to use, the output image will only use 40 colors).

Redisplay Image

By selecting this item, aipsview will reread the data set from disk and redisplay the image. This is useful if the data set has changed since aipsview first read the image. Note that the minimum and maximum of the data set are not reread; if they have changed, the user must set the appropriate values in the AIPS View window with the data slider (see Section 2.2.3).

Update file's rc

Any current settings aipsview has for this data set that have been changed from the default values are written to the user resource file. The resource file has the same name as the data file, but with no extension and with rc appended (e.g., smallcube.fits $\Rightarrow$ smallcuberc) and will be written to the directory where aipsview was started.

Create filerc.list

This is similar to Update file's rc except that all file-specific variables used by aipsview (not just the ones that have been changed by the user) are written to the file. The resource list file has the same name as the data file, but with no extension and with rc.list appended (e.g., smallcube.fits $\Rightarrow$ smallcuberc.list) and will be written to the directory where aipsview was started. The purpose of this option is to show the user a large list of file-specific variables that can possibly can be set.

Close View

This button deletes the Display window. Aipsview still knows about this data set, however. Using the Session menu (see Section 2.1.3) in the AIPS View window to select the data set and then clicking one of the Slice buttons (e.g., VELO) will redisplay the image in a new Display window. This method of closing a Display window should be used rather than closing a window with your window manager.

Edit Menu

The Edit menu has six choices: Contours, Axis, Wedge, Overlay, Profile, and Print Options. Note that Profile is available only for 3D data sets. Selecting any of these choices will open a separate window allowing control of the display of the selected item.

Contours

Selecting this menu item will open a Contour Setup window, which will affect the display of contours of this data set.

Figure 2.9: Contour Setup Window

Values are:

There are two possible methods of setting contour values. If the Contour Levels button is pressed, contours are shown as fractions of a value; select this choice and enter the value in the Values will be multiplied by field. This is the default, with the value set at the data maximum. If the Fractions of Range button is pressed contours are shown as the fraction of the currently selected range, which is difference between the data set maximum and minimum unless changed by the data slider in the AIPS View window (see Section 2.2.3).

Contour Lines are:

The next section of the Contour Setup window allows you to set the type of contour lines. The default is solid for positive values and dashed for negative values. The default for contour colors is mixed, which means that different colors will be used for different contour values. All contours may be drawn in a single color by selecting that color. The contours are drawn in static colors (i.e., the color won't change if the palette is changed). Note that the representation of the colors white and black depends on the output device, e.g., selecting white will display white contours (against the default black background) in the X-windows display, but will be black (against the white background) in the PostScript output. The opposite is true for black. After the color selection, there is slider which controls the line thickness of the contours.

Show Contours, Show Labels and Show Title, Enable Blanking, Emphasize, and Immediate Update

The next section has options to control the display of contours. Show Contours controls whether contours are displayed or not. Show Labels will display a text string of the contour value next to each contour. These generally look better on the printed PostScript version than on the screen. Show Title is meant to be a simple title only. The Axis Setup window (see Section 2.3.2) gives much more flexible control of content and position of titles. Enable Blanking chooses between different contouring routines; one supports blanking and the other does not but supposedly does a better job with dashed lines. Selecting Emphasize will cause the contours to be drawn with a border around each contour (n.b., the width of the border on each side is equal to the width of the contour). The default color for the emphasis is black in the X-windows display (n.b., this will be white in the PostScript output), but this can be changed by editing the emphasisColor variable in the configuration file, see Section A.1.4. This option may be useful when the contour color blends in with the background image. By default, changes to the setup window only take effect when the Done button is pressed. However, if Immediate Update is toggled, the contours will be redisplayed each time a setup value is changed.

Contour Values

The numbers in the Contour Values display area are the values, multiplied by the value in the multiplier field, which will be displayed. Values are entered in the text field below the list of contour values. Only one value may be entered at a time, followed by pressing the <RETURN> key or the Add button on this panel. You should not be able to enter an invalid number. Pressing the Clear button will erase all values in the list. If the Enter a Contour Value area is not empty, pressing the Delete button will delete the first item to match the value, otherwise pressing the Delete button will delete the last item which was entered in the list. You should not to be able to enter the same value more than once. Pressing the Cancel button will restore the state of the window to the way it was when it was opened and close the window. It may cause the contour to be redisplayed. Pressing Done will update and (re)display the contours (assuming the Contour item of the Show submenu of the Options menu of the Display window has been selected, see Section 2.3.4), and close the window. Pressing Apply duplicates Done except that the setup window remains open.

Notes on contours:

1. Windows are not automatically notified when a contour overlaid from another window changes. The Included Contours item of the Show submenu of the Options menu of the Display window must be toggled off then on.

2. The contours routines are currently pixel-based, not world coordinate-based. Thus, when plotting the contours from one data set onto a raster image of another, it is the responsibility of the user to insure that world coordinates of two data sets are displayed on exactly the same pixels.

3. Contouring large images or images with low signal-to-noise can take a long time.

4. The contours shown on the screen may be slightly ($<$ 1 pixel except for very large image display scale factors) displaced from their correct positions; the printed PostScript output will be correct.

Axis

Selecting this menu item will open an Axis Setup window, which will affect the display of the axis labels and markers of this data set. Changing options in this window will interactively update the display if the axis is currently displayed (i.e., the Axis item has been selected from the Show submenu from the Options menu of the Display window, see Section 2.3.4). Changes to the display of the axis will affect both the image in the Display window and the output PostScript file, when the Print button is pressed.

At the top of the Axis Setup window there are nine buttons that toggle the layout of the remainder of the panel: Global, Axes, X Label & V. Grid, Y Label & H. Grid, X Axis, Y Axis, Title, Markers, and Captions. Initially, the Axis Setup window starts with the Global selected. Fig. 2.10 shows the Axis Setup window, including the X Axis subpanel. Two versions of this are presented, for the default curvilinear (left) and rectilinear (right), see Section 2.3.2.

Figure 2.10: X Axis Setup Window for curvilinear (left) and rectilinear (right) coordinate systems.

Global

These options include a button for selecting the Font and sliders for selecting the Line Width and Character Scale of the frame, title, and axis labels (numeric and text). Note, that the character scale for the text in the X Label, Y Label, Title, and Captions can be independently manipulated within their respective subpanels. Labels (i.e., text strings for the X and Y axis and plot title) can be turned off with the Show Labels button.

The global color of the frame and grid (and for curvilinear coordinates, the numeric labels) is selected by clicking on a Global Color/Frame & Grid Color button at the bottom of the panel. Note that for curvilinear coordinates, grid colors can be independently chosen for the X and Y axes.

Axes

The Draw Frame button turns on and off the frame and tick marks around the images and the Draw Grid button controls whether lines connecting major tickmarks are drawn; by default this is on. The Axis Type buttons select between Curvilinear, Rectilinear, Linear Offsets, and Abs Pixel. The curvilinear coordinates (the default) show correct representations of the sky over large fields of view or near the poles. The curvilinear coordinate system is computationally more time-consuming to draw and will in most cases look the same as rectilinear coordinates. For people using the glish interface of AIPS++ to read in a ScrollingBuffer data set (e.g., at the Parkes telescope), certain caching mechanisms cannot be used and interactive manipulation of the axes may take a significant time. Thus, if interactive speed is a factor and your image does not encompass a large field of view and is not near one of the poles, you should try changing from the default curvilinear coordinate system to the rectilinear one. Because the options of these two ways of drawing axes are different, this selection changes the subsequent subpanels of X Axis and Y Axis, see Section 2.3.2. Linear Offsets, and Abs Pixel use the rectilinear coordinate system. Abs Pixel labels raw pixel numbers, starting with (1,1) in the lower left-hand corner; Linear Offsets is described below.

If Linear Offsets is selected the options in the Offset Format box are unghosted (i.e., you can select them). A choice of five units of linear offsets are available. Default provides the offsets from in the units of data set (e.g., degrees for declination, km/s for velocity). For axes which show angular positions, (i.e., right ascension and declination) the units of arcminute, arcseconds and milliarcseconds are available as well. When Linear Offsets is selected the default label for the X and Y axes change to something like $\Delta$RA (Origin: 05h 32m 46.60s). Note, that if you wish to edit the string in the label once linear offsets have been selected (See Section 2.3.2), you have to click on Text Field first and then on Default in order for the proper string to appear as the default value in the text window. Choosing Pixel gives the offset position in units of pixel numbers.

For linear offsets, the origin is selected initially to be the center of the image. However, the origin can be placed interactively by clicking on Place Origin (n.b. the name of the button then changes to Origin Tracks Mouse); it can be reset to the center of by clicking on Set Offset to Center. The button Offset Only Angular Positions determines whether or not axes which don't represent angular positions (e.g. Velocity) are affected by selecting linear offsets. The default for this toggle is on, however it can be toggled off and all units will be affected (n.b., arcmin, arcsec, and marcsec never affect a non-positional axis). This toggle can be pressed in order to give offsets for velocity of some other axis in its native units or pixel units.

X Axis & V. Grid

The X Axis & V. Grid subpanel controls the tickmarks and numerical labels. The layout of this and the Y Axis & H. Grid subpanel changes depending on whether the default curvilinear or rectilinear coordinate system is chosen; both layouts for the X Axis & V.Grid subpanels are shown in Fig. 2.10.

Figure 2.11: Display window showing curvilinear coordinates near the North Celestial Pole.

Curvilinear

The first slider controls the tickmark intervals. Note that for curvilinear coordinates there are no minor tickmarks. Below the tickmark slider there is a toggle and color selector for the color of the X axis grid. If the Use Global Color Selector toggle is activated (the default), the color of the X axis grid will be that chosen in the Global Color/Frame & Grid Color selector on the Global subpanel (see Section 2.3.2), otherwise the grid color will be that chosen in the Grid Color selector of this subpanel. Below the section on Grid Color is a section on Numerical Coordinates. The toggle Label Color Tracks Grid/Tick Color determines if the color of the numerical coordinates tracks that of the grid. If this is selected, changing the grid color will also change the color of the numeric labels for that axis. In the case of images near a celestial pole, lines of constant Right Ascension and Declination may cross the same edge of a frame (see Fig. 2.11) and having the colors of the numeric labels track those of the grid may make the coordinates easier to read. Below the color options is a toggle for the Label Format between Default and Raw. Selecting Default creates labels in formatted units (e.g., hours, minutes, seconds for Right Ascension). If Raw is selected, the values of the axis labels will be in unformatted units (e.g., decimal degrees for Right Ascension). Note, this toggle can be used in conjunction with Raw Position option of the Misc submenu of the Options menu of the Display window (see Section 2.3.4) to display both the values and axes with unformatted numbers.

At the bottom of the panel, there are buttons to allow the placement of the numeric labels of the X axis (e.g., RA) on any or all of the four sides of the image. The labels will not actually be drawn, however, unless tickmarks for the axis cross that side of the image. For example, in case of an image far from a celestial pole, activating the Left and Right buttons on the X (RA) axis will have no effect because the tickmarks for RA do not cross the left or right edges of the image. However, doing the same for an image near a celestial pole may cause numerical labels to appear due to the curvature of the coordinate system, in which tickmarks of the RA axis cross the left and right (as well as the bottom and top) edges of the frame, see Fig. 2.11. Note that when writing labels on the right-hand side of the frame, the labels will be overwritten by the wedge, unless the wedge is turned off by toggling off the Wedge option of the Show submenu of the Options menu of the Display widow, see Section 2.3.4.

Rectilinear

The first row of buttons selects if a zero line is drawn. If this is selected, tickmarks at a value of zero in X or Y will be connected across the image. Note, unless the data displayed crossed the zero line of the coordinate system of the data, this button will have no effect. The major and minor tickmark intervals can be selected (or turned off) by sliders. The format of the numerical labels can be changed from Decimal to Exponential (n.b., Exponential will not be useful for most astronomical images). The numeric labels can be placed in the Normal (bottom for X, left for Y) or Alternate (top for X, right for Y) positions.

Y Axis & H. Grid

The Y Axis & H. Grid subpanel is identical to the X Axis & V. Grid, except for the Y Axis (and for horizontal grid lines).

X Label

A button near the top of the X Label field chooses between the default string for the X axis (obtained from the input file header) and a user-supplied string. The string displayed in the Text Field is displayed on the image after a <RETURN> has been entered by the user. Note, that if linear offsets are displayed and you wish to edit the default label, which includes an origin position, you have to first click on Text Field and then on Default, see Section 2.3.2. By clicking on the Show Escape Codes button the window will be lengthened and a series of special PGPLOT characters and positions will be listed. These escape codes can give finer control of characters (e.g., Greek font) and placement (e.g., super and subscripts) in axis labels. The user can select the placement of the label between the Bottom and Top of the raster image by clicking on the desired Side button. The Character Scale slider controls the size of displayed X label text.

Below the character scale slider is a selector for the Text Color. If the Use Global Color Selector is chosen the color is bound to that chosen in the Global Color/Frame & Grid Color selector on the Global subpanel (see Section 2.3.2). If Opaque Background is selected, the text will be drawn over a background, which will obscure any underlying graphics. In the Text Placement subpanel, the position (X position, Y position, and angle) of text can be controlled. Note that the X and Y positions are in units of the viewport (i.e, from 0.0-1.0 in both axes).

Y Label

The Y Label subpanel is almost identical to the X Label, except for the Y axis.

Title

The Title subpanel is identical to the X Labels and Y Labels, except for the plot title. The default title string is the name in the title bar of the Display window.

Markers

The first slider in the Marker window is the Marker #. As this slider is moved, the bottom portion of the panel is changed to represent the setup for the specified marker. The marker number (e.g., Marker_00) is printed in the upper left corner. By default there are eight markers available, although this can be changed by use of the configuration file (see Section 3.4 and the example configuration file in the Appendix A.1.4). In order to customize a marker (specified by the Marker # slider) first the Show Marker button is pressed. The size of the marker is selected with the Scale slider (n.b., if the marker is not visible initially, it is likely due to the marker being too small to see). The marker type is selectable from the list of buttons near the bottom. By default, there are eight choices for marker types, additional numbers and types of markers are available by customizing the configuration file (see Section 3.4). Any valid PGPLOT symbols can be used; for details, consult the PGPLOT Graphics Subroutine Library. The marker color is selected from the list of Color buttons at the bottom of the panel.

Once a marker is selected, click the Place Marker button; the button label will change to Track Mouse. The marker will track the mouse (while holding down any mouse button) in the Display window until the Place Marker/Track Mouse toggle is reset, even if the setup window is closed (n.b., markers cannot be placed outside the raster image). The pixel and world coordinates are updated as the mouse is moved to allow placement at a particular world coordinate. When finished with a marker, click again on Track Mouse (the button label will change to Place Marker) and go on to the next marker by moving the Marker # slider (n.b., markers aren't shown unless the axis is displayed). In order that the marker can be seen without confusion with the cursor, users may want to turn off cursor drawing when placing markers (i.e., choose Invisible from the Box Draw Mode submenu from the Options menu of the Display window).

Captions

The first slider in the Captions window is the Caption #. As this slider is moved, the bottom portion of the panel is changed to represent the setup for the specified caption. The caption number (e.g., Caption_00) is printed in the upper left corner. By default there are two captions available, although this can be changed by use of the configuration file (see Section 3.4 and the example configuration file in the Appendix A.1.4). In order to customize a caption (specified by the Caption # slider) Select Text Field and enter text in the text window. The color and placement of text is selected in the next six buttons. The size and placement are at the bottom of the panel and are similar to that in the X Label, see Section 2.3.2.

Note on the Speed of Window Generation

Note that creating the Markers and Captions subpanels take a considerable amount of time, even if you never access them. If it appears too slow you can set the number of captions and markers to zero in the configuration file (see Section 3.4). An example of this is shown in the configuration file in the Appendix A.1.4.

Wedge

Selecting this menu item will open a Wedge Setup window, which will affect the display of the wedge of this data set. The Wedge Setup window is identical to the Axis Setup window (see Section 2.3.2), except that there is no option for using curvilinear coordinates for labeling. The user has control of everything that can be controlled for the main axis (except for interactively placing markers), although the sections pertaining to the X axis and title are not likely to be used. The Y Label subpanel of the Wedge Setup window can be used to add a text string for the units of the wedge (and image) and interactively place the text next to the desired numeric label of the wedge.

Overlay

Selecting this menu item will open a small Overlay Setup window, shown in Fig. 2.12. This window has only a few controls to read in an external overlay file. Commands in the file control the appearance of overlaid text, vectors, and line drawing in the Display window and in hardcopy output.

Figure 2.12: Overlay Setup Window.

At the top of the panel is a label Filename:; beneath this is the currently selected filename. In order to change the name of the overlay file to load select the Select Input File button. The default file name is that of the data set with .overlay appended. The format of the input overlay file is listed below and a extensive description and examples are given in Appendix A.2. Next to the Select Input File button labeled Reload; pressing this button rereads the selected overlay file. Thus, you can be editing the overlay file in one window, save the file and see the changes immediately in the Display window.

Below the two file selection buttons, is the Vector Scale slider, which goes between 0.1 and 10.0. The lengths of vectors in the plot are the number specified by the user in the overlay file (using vector, pavector, vectora, or pavectora) multiplied by the value selected by the slider. The units are in percentage of the viewport size.

Note that this overlay is drawn after the raster, contours, and axis labeling and will thus be drawn on top of any other graphics. Also note that the scale of text is computed from the current scale of the image. Changing the scale (by using the Scale menu of the Display window, see Section 2.3.3) will result in text of a different size.

Profile

Selecting this menu item will open a Profile Setup window, which will affect the display of profile of this data set in hardcopy and in the Display window.

Figure 2.13: Profile Setup Window

Changing values in the Profile Setup window affects the profile shown in the Display window. Note that this window also affects how the data are presented in profile displays of any other window which ``includes'' the profile from this window (see Section 2.3.4).

The affect of changing the values of the Profile Setup window depends on whether the default or previewed profile (see Section 2.4.4) is displayed. If the default profile is shown (see left-hand panel of Fig. 2.17), changing the line color, style, and width, as well as the X and Y Axis Min/Max in the Profile Setup window will interactively change the display of the profile, however, all other options (e.g., character scale, title, etc.) will be ignored, although they still affect the hardcopy output. If the previewed profile is displayed (see right-hand panel of Fig. 2.17), changing any value in the Profile Setup window will immediately update the displayed profile, which is very nearly identical to the hardcopy PostScript output.

Global

Most of the options are similar to those of Global subpanel of the Axis Setup window (see Section 2.3.2), except that for the profile, the color selection is made on the Profile subpanel. In addition, there is a toggle to chose whether a zero line (i.e., $Y = 0$) is drawn.

Profile

These options control the display of the line profile. The first option is Line Style, which can be toggled among SOLID, DASHED, DOTDASH, DOTTED, and DASHDOTDOT. Another characteristic that can be controlled is the Plot Type, which can be Normal (i.e., connect the points in the profile), Histogram (i.e., stair step), or Markers Only (i.e., no lines, but include symbols for the data points of the profile, see Section 2.3.2). The next row shows a choice of profile colors that can be selected.

At the bottom of the panel there is a selection for X Axis Min/Max and Y Axis Min/Max. Selecting Default will display the profile in the order that the data is stored in the input file. Selecting Flipped for the will flip the corresponding axis. Min First will force the minimum to be on the left-hand (X axis) or lower (Y axis) side of the profile (regardless of how the data is stored) and Max First will have the opposite effect. For example, in some cases the data cube may have channels, whose velocities decrease with increasing channel. The default action is for the velocity scale to increase to the left of the profile. By selecting Flipped (or Min First), the profile in the output PostScript file will have velocities increasing to the right.

Output

The Output subpanel allows the selection of the orientation (portrait or landscape) and color (color or monochrome). The output size (in fractions of a page size) can be selected with a slider from 0.2 and 1.4. Note that values greater than about 0.8 may not show all the labels in the hardcopy output.

X Label

The X Label subpanel allows a new label string for the X axis to replace the default from the file header. Escape codes can be displayed in a similar manner as for the X Label subpanel from the Axis Setup window (see Section 2.3.2).

Y Label

The Y Label subpanel is identical to the X Label, except for the Y Axis.

Title

The Title subpanel is identical to the X Label, except it affects the title at the top of the output profile.

Markers

The Markers subpanel is used to select whether or not markers are shown at the data points of the profiles (markers are shown by default). Also the Scale, Marker Type, and Marker Color can be selected.

Print Options

Selecting this menu item will open a Print Setup panel. At the top of the panel is an area for text input specifying the name of the output PostScript file. Initially the default file name is shown which is created from the name of the input image file followed by information about the orientation of the image with the extension ``ps'' or ``eps''. When the default name is displayed the extension changes depending on the layout selected. On the panel there are four output choices: Portrait, EPS Portrait, Landscape, and EPS Landscape. Note that EPS Portrait and EPS Landscape are essentially the same since the bounding box of the EPS file includes only the image and thus the aspect ratio doesn't change between the two layouts. Above the choice of layouts is a slider bar to select the scale. Again for EPS output the scale is less important since packages that read EPS files can scale the EPS files themselves. For Portrait and Landscape, however, scale can be used to enlarge or shrink the image on the page. There is a button to smooth the image using a PostScript algorithm.

Near the bottom of the panel there is a text input field for comments to be placed in the PostScript file. The comments that are entered will be written near the top of the PostScript file after the header information. Note that comment information about the file name, data Min/Max, and axis information (similar to what is displayed in the AIPS View Window Information Area, see Section 2.2.1) are written to the PostScript file by default.

At the bottom of the panel there is a selection for Paper Size. You can select one from the short list of common types (Letter, Legal, or A4) or select Other. If you select Other, You may be surprised to see the window expand. A large number of PostScript paper options are presented in this window. When you select any item from the large page of choices, the window immediately shrinks to the original, smaller size.

Scale Menu

This allows changing the scaling of image pixels to screen pixels, in order to zoom (or reduce) an image. The default scaling of an image is to 256 screen pixels, so, for example, a 128$\times$128 image would initially be displayed with a scale of 200%. The Scale menu is customized for each data set size, so it only presents selection options that allow the particular data set being displayed to be scaled from the minimum 64$\times$64 screen pixels to approximately the maximum screen size. It is recommended that this Scale menu be used to resize images. However, the size of the display window may also be adjusted by standard window management (grab the corner with the mouse pointer and drag it to a different size). The image will be re-sized to approximately fit the new window. However, this method is less robust than using the Scale menu. Sometimes, some window managers require that you very slightly move a window resized in this manner in order to get it to repaint properly.

The main scale menu allows scaling both axes simultaneously. Selecting from either the X or Y submenus will scale the image in only that direction. The X=Y toggle is used when it is desired to resize the window by dragging. If the toggle is on (the default), aipsview will force the X and Y scales to be the same.

Notes on scaling:

1. Changing the state of the toggle does not force a redraw. Nothing happens until another scale request.

2. With independent X and Y scaling, if the resultant X scale is such that the image is not as wide as the parent window (with the readouts), aipsview will scale it up automatically to fit the window.

Options Menu

The Options menu has for choices: Show submenu, Include submenu, Box Draw Mode submenu, and the Misc submenu.

Show Submenu

This submenu has nine selections: Region, Profile, Included Profiles, Raster, Contours, Included Contours, Axis, Wedge, and Overlay. These are toggles which may be turned on and off. For Region and Profile the default mode is to expand the area of the Display window above the image in order to provide room for these functions. If the Info Outside option (see Section 2.1.4) was selected under the main aipsview window Options menu, or if an X-defaults file (see Appendix A.1.2) is used to change this default, there will be a single choice of Show View Info instead of separate choices for these functions. When the Show View Info option is listed, clicking on it will open a separate window, which will contain all addition information about the data set (i.e., everything but the raster image itself). The remaining five choices control what will be displayed; they may be selected in any combination. Thus, if you wish to display the raster image, the wedge, its contours, contours generated from a different data set, and axes all at the same time, you may do so. Then, turning off the raster toggle will show two sets of contours and the axes. Note turning off the raster automatically turns off the wedge.

If Included Profiles is selected, profiles from all windows will be displayed in the current window. Note, that world coordinates values of all included profiles are compared and the ``included'' profiles are shown where they overlap with the displayed profile.

If Included Contours is selected, contours from all windows with their Include flags set will be displayed on the Display window. The properties of the included contours are separately controlled by the Contour Setup window for each included window (see Section 2.3.2).

Include Submenu

This submenu has five selections: This, All, None, Invert, and Track 3D (see Section 3.2). The purpose is to include Display windows in a list of images for animation, blinking, contouring, or synchronized picking. The background of the Motif menu bar changes color (to white by default) to show that a Display window has been ``included''. By default, if no Display windows have been explicitly included, the first Display window opened is implicitly included.

Box Draw Mode Submenu

This submenu has five selections: Normal, Mode 1, Mode 2, Invisible, and a toggle for Cross. The purpose of this submenu is to make the cursor visible against a background image; the first four selections change the colors used for region drawing. Selecting between the various modes can be done if the region boundary lines don't show up well or to make the region selected invisible (which may be useful for screen dumps). The last selection toggles a cross, which is centered at the current cursor location and is displayed in addition to the box. Displaying a cross can be useful when the pixels are small and a small box, which may only be a single point, is difficult to see.

Misc Submenu

This submenu currently has two toggles Raw Position and Print Statistics. When Raw Position is selected, the positions shown in the Value subpanel of the Display window (see Section 2.4.2) are displayed as unformatted numbers. Selecting the Print Statistics item will print simple image statistics (e.g., minimum, maximum, average, and rms) for the displayed plane of the Display window to the xterm which started aipsview. Note that if some pixels in the relevant image display are outside the current data range (see Section 2.2.3) two sets of statistics are printed, one made using the entire range and another made using the data range set by the data range slider.