Copyright: Compaq Array Viewer © 2001 Compaq Computer Corporation
Citation: © 2001 Compaq Computer Corporation


Introduction

Many of us encounter large amounts of technical data with increasing frequency, but making sense out of this data becomes harder as the amount increases.   Analytical methods of data analysis can produce powerful and informative numerical results.  But, significant expertise may be needed to interpret the results accurately and use them effectively.

The Compaq Array Viewer (formerly the DIGITAL Array Viewer) is a Windows application that dynamically displays array data.  It lets you view and analyze the array data graphically, which can lead to immediate insights, such as discovering hidden patterns in large multidimensional arrays.

Array Viewer can also be used as a standalone application to display array data saved in a file.

Developers writing applications in the following languages can use Array Viewer:

•	Basic

•	Fortran

•	C/C++

The following image shows Array Viewer displaying some sine data. Click on any part of this image to get further information about it:

The Array Viewer presents data using visual methods that range from simple X-Y charts to three-dimensional height plots. Each method can capture thousands of data values in a single image. Array Viewer is also interactive. You can:

•	Control how the data is represented

•	Inquire about specific data values

•	Examine different regions of the data set

Array Viewer normally displays data in two panes:

•	The top pane is called the "Data View". It displays array data in a spreadsheet-like format.

•	The bottom pane is called the "Graph View". It displays data in one of four graph types:

•	Height Plot

•	Image Map

•	Vector Graph

•	Plane View

You can adjust the relative sizes of these two panes by dragging the splitter bar between them. You can move around in the panes by using the markers.

The following images show how graphed data can appear in the Graph View:

As a height plot graph:

As an image map:

As a vector graph:

As a two-dimensional (plane) graph:

For more information, see How to Use Array Viewer.

For general information on Array Viewer displays, see How Array Viewer Displays Data.


Related Software

The Compaq Array Visualizer is a set of software components for viewing and analyzing scientific and technical array data graphically. The Array Viewer is one component of the Compaq Array Visualizer.  Other components include:

•	The Avis2D and AvisGrid OCX controls

ActiveX™ controls that you can use to simplify development of an application that displays array data.

•	The Aview library

A software library (aview.lib) that enables C and Fortran programs to communicate with the Compaq Array Viewer through OLE Automation.  The Aview library also lets you save array data to an .AGL file format for later viewing.

•	HDF libraries

Pre-compiled NCSA Hierarchical Data Format (HDF) libraries and utilities, source code, and documentation.

•	Enhancements to the visual development environment

Enhancements to the Developer Studio debugger that let you select an array in the watch window and use the Array Viewer to inspect it.

Developers who want to create new applications that use Array Viewer must use one or more of the above components to enable their application to communicate with Array Viewer.

For more information about these components, see the Compaq  (formerly DIGITAL) Array Visualizer Reference documentation.


Performance Notes

Because the Array Viewer renders many of its graphs in 3D (a CPU-intensive process), certain hardware characteristics can affect its performance:

•	System performance

For optimal performance, Array Viewer sometimes adjusts its behavior based upon the CPU speed.  For example, on slow processors it might display large arrays in less detail or take slightly longer to refresh. Overall, performance improves when Array Viewer is running on a fast Pentium or an Alpha processor.

•	Graphics card

Array Viewer uses the OpenGL graphics API for 3D rendering.  If your processor has a graphics card that supports the OpenGL API, many of the complex calculations required for 3D rendering are off-loaded to the card. This frees up the CPU for other work.

Your graphics card also determines color resolution options. Array Viewer uses a broad range of colors to display graphical data, so one of the following color resolutions is recommended:

•	High Color (65536 colors)

•	True Color (16777216 colors)

To change your color resolution:

1.	Select the Display icon in Control Panel.

2.	Click on the Settings tab.

3.	Select the appropriate Color Palette. The list of choices that you see usually is the full list of color resolutions that your card supports. Not all cards support the higher color resolutions.

If you change your color resolution, you should restart Array Viewer to make sure the new resolution is in effect.


Overview of Arrays

The array is a common data item used in languages such as C, Fortran, and Basic. An array provides programmers with an easy way to refer to a collection of similar variables using the same name but different indexes. For example, consider the following C statement:

Float X[100];

This declaration creates an array that provides memory storage for 100 floating-point values.

The following statement places the value 3.12 into the third element of the array:

X[2] = 3.12;

In C, array indexes always start at 0, so the first element of the array has index 0, the second has index 1, etc.

An equivalent Fortran array declaration and assignment follows:

Real*4 X(100)
X(3) = 3.12

In Fortran, array indexes start at 1 by default, so the index 3 refers to the third element.

An equivalent Basic array declaration and assignment follows:

Dim X(100) As Single
X(2) = 3.12

As in C, Basic array indexes start with 0 (unless your array definition specifies a different starting index value).


Array Terminology

Although the syntax used to declare arrays and refer to their elements differ somewhat in C, Fortran, and Basic, the concepts are the same. The following terms are the ones that usually appear in a discussion of an array:

•	Dimension — A range of values for one index (or subscript) of an array.  An array can have from 1 to 7 dimensions.

•	Rank — The number of dimensions in an array.

•	Type — The data type of the array elements, such as float, integer, character, etc.

•	Extent (of a dimension) — The total number of elements in a dimension.

•	Size — The total number of elements in an array (the product of the extents).

•	Shape — The organization of the array, as determined by its rank and extents.

•	Lower bound (of a dimension) — The starting index for a dimension (always 0 for C arrays).

•	Upper bound (of a dimension) — The ending index for a dimension (always Extent−1 for C arrays).


Row and Column Dimensions

Array data is displayed as a two-dimensional grid containing:

•	Rows of array elements

•	Columns of array elements

For all the graph types (except vector graphs), rows are associated with the x-axis, and columns with the y-axis. When setting the region of interest (ROI) values, you can specify the x and y dimensions.

For arrays of rank 1:

•	The column dimension is set to 1 (because there is only one dimension).

•	The row dimension is not defined. For your convenience, sometimes the data is displayed differently.

Arrays of rank 2 or greater follow the conventions of the languages, if any, in which they are defined. The default row and column assignments depend upon the language used to define the array:

•	For Fortran arrays, the row dimension is dimension 1 and the column dimension is dimension 2.

•	For C and Basic arrays, the row dimension is dimension 2 and the column dimension is dimension 1.

To redefine the row and column dimension settings, select the appropriate radio buttons in the Row and Col fields of the ROI Settings Dialog.


Array Sections

When using Array Viewer, you may want to work with just a subset of the array. (Such a subset is called a Region of Interest.)  For example, in an array of 2000 elements, you might want to look at only elements 200-700. An array section is a contiguous subset of the original array. Moreover, an array section is "rectangular," which means rectangular in two dimensions, box-like in three dimensions, etc. You specify an array section by providing start and ending indexes for each dimension of the array.

The following examples show arrays with array subsections shaded:

One-dimensional array with a one-dimensional array subset:

A(10) → SA(2:5)

Two-dimensional array with a two-dimensional array subset:

B(4, 8) → SB(2:3, 5:8)

Two-dimensional array with a one-dimensional array subset:

C(4, 8) → SC(3:3, 1:6)

Three-dimensional array with a two-dimensional array subset:

D(3, 4, 5) → SD(3:3, 1:4, 1:5)

This last example is of special importance, because Array Viewer cannot display an entire three-dimensional data set at once. When an array having three or more dimensions is loaded into Array Viewer, each view of the array is a two-dimensional "slice".  You can control which slice of the array to display, and the "direction" in which the array is sliced.


Multidimensional Arrays

Multidimensional arrays use two or more indexes to refer to each array element. For example, the following C declaration creates a two-dimensional array:

Int A[3][4];

This array has 12 elements (3 x 4). Each element has two indexes, the first referring to the position in the first dimension (in the range 0-2 in the example), and the second refers to the position in the second dimension (in the range 0-3).

If we think of the first dimension as the rows of the array and the second dimension as the columns of the array, then the statement:

A[2][1] = 1234;

assigns the value of 1234 to the element in the third row, second column of the array.

The same two statements in Fortran would appear as follows:

Integer*4 A(3, 4)
A(3, 2) = 1234

And in Basic:

Dim A(3, 4) As Integer
A(2, 1) = 1234

You can declare an array to have many dimensions, although the language you use generally has a built-in maximum. Array Viewer allows arrays of up to seven dimensions.

The number of elements can grow quickly as you add dimensions. For example, consider the following Fortran declaration:

Integer*4 C(12, 23, 34, 45, 56)

This declaration creates a five-dimensional array with over 23 million elements (12*23*34*45*56 = 23,647680)!  With each element requiring four bytes, this is a 92-megabyte array.


How to Use Array Viewer

The Array Viewer displays array data in two adjustable panes (note):

•	The top pane (the Data View) shows the array's numeric values in a scrollable spreadsheet.

•	The bottom pane (the Graph View) displays a graphical view of the array data as a three-dimensional surface. Other viewing modes include graphical representation of the array data as an image map, a vector graph, or a plane graph.

If the Data View does not yet contain data, you can open a file:

To open a file, in the File menu, click Open. Select the folder and the file you want to open.

You can open AGL files, HDF files, and other file types.  For information on other ways to add data to Data View, see Loading Data into Array Viewer.

You can also create a new file.

Once data is present, you can:

•	Display the top pane of array values:

From the View menu, select Split. Adjust the top and bottom pane sizes as needed by dragging the splitter bar.

•	Edit array values:

You can either use Cut, Copy, or Paste from the Edit Menu to load data values , or you can edit individual cell data if Cell Edit is enabled.

•	Rotate the current view for certain graph types:

Drag the mouse pointer to adjust the angle of view.

•	Select a different type of view:

From the View menu, select the type of view: Height plot, Image map, Vector, or (if applicable) Plane view.

•	Display and move the marker:

To display the red marker, click the appropriate button on the toolbar.

To move the marker, double-click the appropriate area on the graph or double-click the appropriate array element in the top pane.

You can also use the arrow keys to move the marker one cell in the direction indicated by the key. If you hold down the Shift key and press one of the arrow keys, you move by approximately 10 percent of the total area in the direction indicated by the arrow key.

Note: If you have installed the Compaq Array Visualizer, which is part of the Compaq Visual Fortran Professional and Enterprise Editions, you can view demonstrations of common Array Viewer tasks.

For more information:

On controlling how the graph appears, see Changing the View Perspective of a Graph  and Settings Menu.

On how to view specific data values on the graph, see Data Tips.

On how to edit cell values, see Cell Editing.

On how to examine different regions of the data set, see Region of Interest.

On Array Viewer displays, see How Array Viewer Displays Data.

On graphing, see Graphing Overview and Considerations.


Loading Data into Array Viewer

Array data can be loaded into Array Viewer in four different ways:

•	By opening a data file in Array Viewer, which supports several file formats.

•	By using the Windows clipboard to copy data from other Windows applications (for example, Microsoft Excel™) and paste them into the viewer.

You can also select a region of the data set in Array Viewer, copy it to the clipboard, and then paste it into a text editor. You can then paste it back into Array Viewer as a new data set.

•	By writing applications that use the Aview software library.

The Aview library enables you to write Fortran or C applications that can dynamically display data using the Array Viewer.  For more information, see Related Software.

•	By launching Array Viewer directly from the Microsoft visual development environment and then using it while debugging Compaq Visual Fortran applications.

For more information about how to use Array Viewer from the Microsoft visual development environment, see the Debugger chapter in the Visual Fortran Programmer's Guide.

For general information on Array Viewer displays, see How Array Viewer Displays Data.

For some tutorial information on graphing, see Graphing Overview and Considerations.


Cell Editing

Array Viewer supports two types of data editing.  One is the Cut, Copy, and Paste operations provided in the Edit Menu.  The other is the Cell Edit mode, which lets you edit an individual cell.

To enable Cell Edit mode, click on the "Cell Edit Enabled" check box in the Data View Settings dialog.

To edit a cell, double-click the cell; this begins Cell Edit mode. Any changes you make to the cell are saved if you press Enter or if you exit the cell.

When you have finished editing the cell, you can:

•	Exit Cell Edit mode by clicking anywhere outside the cell being edited.

•	Continue editing by double-clicking another cell.

While in Cell Edit mode, you can also exit the current cell and move to another cell by pressing one of the following keys:

•	The Tab moves to the cell on the right.

•	The Shift/Tab moves to the cell on the left.

•	The up-arrow moves to the cell above the current one.

•	The down-arrow moves to the cell below the current one.


Region of Interest

Before proceeding, you may want to visit the following sections for background information: Row and Column Dimensions and Multidimensional Arrays.

The "Region of Interest" (ROI) is an array section of the source array. Like any array section, it is determined by the start and length values for each dimension. When an array is first loaded into Array Viewer, the ROI is the entire array, by default.

All graph types take their data from the data window.  So, at any one time, Array Viewer can display only one- or two-dimensional sections of a data set.

Sometimes, you may want to work with a subset of a one- or two-dimensional data set.  For example, you might be interested in just the values in the upper-left quadrant of a two-dimensional array. Or, if your data is topographical, you might be interested in the area near a mountaintop or in a "shelf" area that might be either good for hiking or the possible location of a future landslide.

Given an array of rank three or greater, you can view the entire array only by "slicing" it into a collection of two-dimensional pieces and then viewing them one slice (ROI) at a time.

The ROI is defined by specifying two dimensions, one as the row dimension of the slice and the other as the column dimension. You can further specify any contiguous, rectangular piece of that slice as another ROI.

The ROI can be redefined by adjusting the Start and Length fields in the ROI Settings Dialog.  The ROI is also modified when you choose Zoom In or Zoom Out from the View Menu.

Example:

Suppose you have a one-dimensional array that you want to display as a two-dimensional graph, using array indexes as x-values and array values as y-values. The ROI dialog for such an array is:

When you display the graph, Array Viewer looks similar to:

Array Viewer arranges the data into ten columns, with a row for each ten array values.  For example, to find the array value whose index is 107, look in row 10 and column 7.

You can also restrict the data set to show a subset by changing the Start and Length values in the ROI dialog box:

These values restrict the example data set to indexes 3 through 9.


Graphing Overview and Considerations

The following topics provide some tutorial information and information on graphing considerations:

•	Graphing a One-Dimensional Array

•	Graphing a Two-Dimensional Array in Plane View Mode

•	Graphing in Height Plot Mode

•	Graphing in Image Map Mode

•	Graphing in Vector Mode

For general information on Array Viewer displays, see How Array Viewer Displays Data.


Graphing a One-Dimensional Array

Array Viewer treats array data as if it has been defined in the Fortran programming language. For example, if the array has 100 elements, then it would be equivalent to an array declared using A(100) as the array declaration. By pasting a one-dimensional set of data into Array Viewer, you create an array whose values, as interpreted by Array Viewer, would be A(1), A(2), A(3), and so on, where the last data element is A(100):

The values in parentheses are both the indexes of the array and the column numbers in the Data View window of Array Viewer.

To set up a one-dimensional array for graphing, you can import an existing AGL file or a subfile of an HDF file, or you can create a new file as follows:

1.	Open Array Viewer and either click on the New button or select New from the File menu.

2.	Place your data onto the clipboard, by copying either a single line of space-separated numbers from a text file or all or part of a row or column from a spreadsheet program.

3.	Paste the data into the Data View window of Array Viewer by clicking the Paste button on the toolbar or by selecting Paste from the Edit menu. Whether you copy the data from a row or from a column, Array Viewer imports it as a row. If the data set consists of more than 10 numbers, Array Viewer arranges them using multiple rows, each (except maybe the last) with 10 values, making it easier for you to see your data without doing lots of scrolling. Nevertheless, Array Viewer treats the data set as single row:

Note that as soon as you place your data into Array Viewer, the Height Plot, Image Map, and Vector Graph buttons become disabled. Plane View, the only remaining graph type, is the one that Array Viewer uses for your data. Also, Array Viewer automatically associates data values with the z-axis, using the smallest and largest data set values as its minimum and maximum z-axis values. Array Viewer displays your data according to whichever Plane View settings happen to be in effect at the time.

You can modify the graph in several ways:

•	If you want to display only a contiguous subset of your array, you can select the ROI… (region of interest) item from Array Viewer’s Settings menu. This produces the ROI dialog box:

To specify the subset completely, place its starting value and length in the ROI dialog box.

•	If your data set has a few very large or very small numbers, you may consider them aberrant and want to exclude them from graphing. To restrict the graph, you can specify two values, such that no data set value smaller than the first will display and no data set value larger than the second will display. Call these two constraining values Minval and Maxval.

To enforce these restrictions, select Axis… from the Settings menu:

Disable the "Auto adjust to min, max data range" feature, and then enter Minval and Maxval in the Z-Min Value and Z-Max Value boxes, respectively.

When you place these changes into effect by clicking on the Apply or OK button, the graph changes in two ways:

•	Z-axis labels change to reflect the new minimum and maximum z-values.

•	Data values outside of the specified graphing range do not display.

•	If your graph has multiple colors and you want it to be monochrome, or if it is one color and you want it to have colors that depend on the values for which points are displaying, select Graph from the Settings menu. To convert a multi-colored graph into a single-colored graph, disable the Use Palette feature. To do the opposite, enable the feature.

If your graph is single-colored, you can change it to a different color by selecting Graph… from the Colors menu. When you do this, the standard color-selection dialog comes up, and you can use it in the usual way to select or create another color.

•	By default, the color palette is based on the values in the data set, so color assignments range from the smallest data set value to the largest. You can change this by selecting Range… from the Palette menu:

Verify that the "Auto adjust to min, max data range" box is disabled. Then enter the desired Min and Max values, and click Apply or OK.

Note that if the data range you specify is not entirely in the current z-axis range, you will see the part of the color spectrum that is in that range. In addition:

•	Values above the top of the color range display in the color assigned to the top of the color range.

•	Values below the bottom of the color range display in the color assigned to the bottom of the color range.

•	You can change the style of your graph. When you select Graph… from the Settings menu, you can see that there are three styles: lines, points, and barchart.  Try them all to see which style is most suitable for your graph.  Some hints:

•	If your data set is small or scattered, the points style is usually not the best choice, because isolated points are hard to see.

•	If your data set is large and scattered, the best choice is probably barchart. In barchart, each bar extends from the bottom of the graph up to where the corresponding point is, so if plotted as such, a large collection of bars has color-coding that is more likely to reveal patterns in the data.

For general information on graph types, see How Array Viewer Displays Data.

See also Plane View Graph.


Graphing a Two-Dimensional Array in Plane View Mode

This topic describes the process for displaying two-dimensional data using the Plane View graph type.  This kind of graphing is similar to graphing one-dimensional data.

Array Viewer treats a two-dimensional data set as a collection of columns (not rows), where each column, being one-dimensional, displays as its own plane graph, so multiple columns display as multiple plane graphs that share the graphing surface.

To keep the graphing surface from becoming too cluttered, the Plane View supports only 10 columns of data at any one time. If you have more than 10 columns, you must select ROI… from the Settings menu, and modify the region of interest so that it contains 10 or fewer columns. These columns must be contiguous in the data set. The only way to graph a non-contiguous collection of columns using the Plane View is to:

1.	Create a new data set.

2.	Copy the desired columns into it.

3.	Use the new data set for graphing.

All column graphs existing in the same plane view have the same attributes, because the process of setting attributes applies universally.

Of the three graph styles (lines, points, and barchart), lines works best in most cases. However, barchart can produce some dazzling effects.

When Use Color Palette is disabled, each graph has its own color, which is the same throughout the graph and is not user-definable. Often, this is useful because it lets you distinguish between the graph for one column and graphs for other columns.

When Use Color Palette is enabled, each point on the graphing surface has a color that depends upon its data value, not upon its column. In this case, you can use data tips to distinguish between the graphs.

For general information on graph types, see How Array Viewer Displays Data.


Graphing in Height Plot Mode

If the data in Array Viewer has more than two dimensions, you must decide which two-dimensional portion to graph.

Most of the options you can select to determine the appearance of the height plot graph are described in Height Plot Settings Dialog.

You may also need to consider the following:

•	Do you want to only graph part of the data set?  If so, see ROI Settings Dialog.

•	Do you want to adjust the vertical scaling (tall or short) for the graph?  If so, see Scale Settings Dialog.

If the data set has both large and small values, making a short graph can sometimes provide a better view of your data.

•	Do you want to have the color palette or the height plot marker, or both, in your Graph View?  If so, see Color Palette and Markers.

If you want to use coloring from the color palette, you must also decide the range of data values (the palette range) to which the color palette is to be applied (see Palette Menu).

Once the graph is displayed, you can customize your view.  You can also zoom and pan independently.


Graphing in Image Map Mode

Creating an image map graph is similar to creating a height plot graph. There are only three significant differences:

•	The Settings dialog is different.

•	You need not worry about choosing a suitable scale for the z-axis, because an image map is flat, using only the x- and y-axes.

•	Once the graph is displayed, you cannot change the view angle and you cannot zoom.


Graphing in Vector Mode

A vector graph and a height plot graph can both display data in three-dimensions.

Creating either type of graph is somewhat similar and the opportunities to customize the view after graphing are identical.

The vector settings dialog is different; some settings are unique to vector graphing.

The most significant decision is which columns are to be assigned as the x-, y-, z-, and w-component indexes. If the data set is designed specifically for vector graph display, then it is likely that the default indexes are the ones you want.  Otherwise, you may have a great many possibilities to choose from.

For example, if your data set has 100 columns, then you can select four columns in 3,921,225 ways; further, you can assign each of those selections to columns in 24 ways.


How Array Viewer Displays Data

Array Viewer normally displays data in two adjustable panes:

•	The top pane is called the Data View, which displays array data in a scrollable spreadsheet-like format with rows and columns.

•	The bottom pane is called the Graph View, which displays data in one of the following graph types:

Height Plot — A three-dimensional surface where each point on the surface corresponds to an array element, and both the color and the height of the points correspond to the value of the associated array element.

Image Map — A two-dimensional image where each point of the image corresponds to an array element; each point has a color that corresponds, according to the color palette, to the value of the associated array element.

Vector Graph — Array data plotted as a series of (x,y), (x,y,z), or (x,y,z,w) vectors, where there is one graph point for each row. The first and second vector values constitute the x- and y-axis values, the third, if present, the z-axis value, and the fourth, if present, the color of the point, according to the color palette.

Plane View — An xy-plot of the data set, where each row is displayed separately. Column numbers are the x-values and row element values are the y-values.

For more information about Array Viewer display, see:

•	Markers, Data Tips, and Color Palette

•	Changing the View Perspective of a Graph

For information on using Array Viewer, see How to Use Array Viewer.


Data View

The Data View is the upper pane in the Array Viewer window. It looks like a spreadsheet, with the column dimension name and numbered column labels along the top and the row dimension name and numbered row labels down the left side:

For all the graph types (except vector graphs), rows are associated with the x-axis, and columns with the y-axis. When setting the region of interest (ROI) values, you can specify the x and y dimensions.

For example, you can create a one-dimensional array with extent 1000 and display it as a two-dimensional graph with array indexes as x-values and array values as y-values.  Array Viewer arranges the data into ten columns, with a row for each ten array values.

If a data set contains more data than can be displayed, scroll bars are seen.  Scrolling has no effect on what displays in the Graph View, because the current ROI controls what is displayed there.  The portion of the data set that is outside the ROI is displayed in a lighter text in the Data View.

If you double-click on an item (called a "cell") in the Data View, the marker moves to the position of the cell.  If marker display is enabled, the following occurs:

•	The cell acquires a red border, as shown in the above figure.

•	The graph marker moves to the corresponding position in the Graph View.

You can change the dimension names displayed in the Data View by selecting Dimensions from the Data menu .  This opens the Dimension Labels dialog box.

You can change the row and column to be viewed by selecting from the dimension list when you right-click on a dimension name in the Data View.


Graph View

The Graph View is the lower pane in the Array Viewer window. It is where graphing takes place.  Data is displayed in one of the following graph types:

•	Height plot

•	Image map

•	Vector graph

•	Plane view

The following example shows a height plot graph:

If color palette display is enabled, the Graph View contains both the graph and the color palette. If marker display is enabled, the marker is visible.  Data tips are also available, so you can get both coordinate and value information about a point simply by moving the mouse cursor to the point.

For more information on how to see a graph from different angles and distances, see Changing the View Perspective of a Graph.


Height Plot Graph

A height plot graph displays array data as a 3D surface where the X and Y dimensions correspond to the array indexes, and array elements are mapped as a displacement in Z.

The following is an example of a height plot graph:

Height plot graphing is available for arrays of rank 2 or greater ( or when there are multiple rows and columns in the ROI).

You can select it by clicking the Height Plot button on the graph toolbar or by selecting Height Plot from the View menu.

One horizontal axis of a height plot graph is always labeled "X" and refers to array index values in the column dimension of the ROI. Another horizontal axis is always labeled "Y" and refers to array index values in the row dimension of the ROI. The vertical axis is always labeled "Z" and refers to data values in the ROI.

You can explicitly set the Z-axis range so that its lowest value is either:

•	Greater than the smallest array value

•	Less than the smallest array value.

Likewise, you can set the high value of the Z axis to a value either:

•	Less than the largest array value

•	Greater than the largest array value

For details on setting the Z-axis range, see the Axis Range Dialog.

By default, Array Viewer height plot graphs use the color palette.  If you want the graph to be colored with a uniform color, deselect Use Palette in the dialog.  When Use Palette is not selected, you can assign a different color by selecting Graph from the Colors menu.

You can choose any of several options and any of several graph styles using the Graph Settings dialog for height plot graphs.

When a height plot graph is displayed, you can make changes to the display.

For information on options for height plot graphs, see the Height Plot Settings dialog.

See also Graphing in Height Plot Mode.


Image Map Graph

An image map graph displays array data as a 2D image where the X and Y dimensions correspond to the array indexes, and array elements are mapped to a color range.

The following is an example of an image map graph:

Image map graphing is available for arrays of rank 2 or greater.

You can select it by clicking the Image Map button on the graph toolbar or by selecting Image Map from the View menu.

It is helpful to imagine the image map as a rectangular arrangement of rectangular tiles, where the number of rows and the number of columns are as defined for the row and column dimensions of the ROI.  If the numbers of rows and columns are small, each tile in the graph will be relatively large, whereas if they are large, each tile will be small:

The horizontal axis of the image map graph is always labeled "X" and refers to column index values in the ROI. The vertical axis is always labeled "Y" and refers to row index values in the ROI.

Each tile of the graph corresponds to a unique row-dimension-index/column-dimension-index pair. These indexes refer to a unique data array value that determines the tile’s color, as indicated by the current color palette.

For information on options for image map graphs, see the Image Map Settings dialog.

See also Graphing in Image Map Mode.


Vector Graph

A vector graph displays array data as a series of 2, 3, or 4 component vectors.  In this mode an array is viewed as a list of vectors.  For example an array declared as M(3, 500) would consist of 500 vectors of the form (x, y, z).  The first three components are mapped to the X, Y, and Z axis.  The fourth component (if present), is mapped to a color using the color palette..

Vector graphing is available for arrays of rank 2 or greater.

You can select it by clicking the Vector Graph button on the graph toolbar or by selecting Vector Graph from the View menu.

A vector is an ordered list of components. For example, a two-component vector is commonly denoted as (1, 3), where 1 is the X component, and 3 is the Y component.

In the Vector graph, each row in the ROI is associated with one vector, having either two, three, or four components. By default, the X component is associated with the first column in the ROI, the Y component with the second column, the Z component with the third, and the W component with the fourth.  However, you can use the Vector Plot Settings dialog to assign any column in the data array to any component, even if the columns are not contiguous.

If you set any component index to one less than the valid range (for example, −1 for a C-based array), that component is not used in the display of the graph. So, setting the w-component to −1 for a C-based array causes the graph to display in only one color. Note that a three-column data array, when graphed with default settings, displays in one color for the same reason — no color values are available.

Unlike the other graph types, none of the axes in a vector graph displays array indexes. Instead, each axis indicates the range of the associated component.

If the number of vector components is two, the X-axis range runs from the smallest value of that component to the largest. Similarly, the y-axis range starts at the smallest value of the Y component and ends at the largest value. For each element in the ROI, Array Viewer uses its X and Y components to plot one element in the graph.  If the graph style in the Vector Plot Settings dialog is set to "Lines", Array Viewer draws line segments between adjacent members of the ROI:

When the number of vector components is three, a Z axis displays Z-component values. In this case, the graph can be three-dimensional. As the example shows, the graph displays in only one color:

When the number of vector components is four, the fourth component, the W component, is available for assigning colors to the elements being graphed. The default color palette extends from the smallest w-component value to the largest.  You can override the default color palette by selecting Range… from the Palette menu.

For information on options for image map graphs, see the Vector Plot Settings dialog.

See also Graphing in Vector Mode.


Plane View Graph

A plane view graph displays array data as a conventional 2D graph where the X dimension corresponds to the array index, and array elements are mapped as a displacement in Z.

The following is an example of a plane view graph:

Plane view graphing is available for arrays of rank 1 or greater, but the number of rows or columns must be 10 or less.

You can select it by clicking the Plane View button on the graph toolbar or by selecting Plane View from the View Menu.

Consider a case where the number of rows is 1 (as in a one-dimensional array). In this case, the horizontal axis (the X axis) extends from the beginning to the end of the range of array indexes in the region of interest (ROI).  Similarly, the vertical axis (the Z axis) extends from the smallest to the largest of the range of array values in the ROI. In certain cases, Array Viewer adjusts the range of array values somewhat.  For example, if the largest array value is 99.4, the top of the Z axis might be 100.0.

Regardless of how many rows are in the data set, once the settings are to your liking and you click on the dialog’s Apply or OK button, Array Viewer draws an appropriate item at the appropriate height and in the appropriate color, for each element of each row.

Using the Plane View Settings dialog, which you get when you select Graph… from the Settings menu, you can choose to have Array Viewer graph the elements of the ROI as separate points, as separate bar charts, or as points connected to form a curve.

By default, Array Viewer graphs using a uniform color. If you want the graph to be colored according to the color palette, select Graph… from the Settings menu, and then select Use Palette in the Graph Settings dialog.  On the other hand, if you want a uniform color, but not the default color, leave Use Palette disabled and select Graph from the Colors menu; then select a color using the standard Color dialog.

For information on how you can control the appearance and other attributes of the vertical axis, see Customizing the Axis Display.

If Array Viewer is using uniform coloring and there are multiple rows in the ROI, it uses a different color for each row.

If the number of rows in the ROI is greater than 10, the horizontal axis is labeled "Y", and Array Viewer draws a separate graph for each column.

For information on options for plane view graphs, see the Plane View Settings dialog.

See also:

Graphing a One-Dimensional Array

Graphing a Two-Dimensional Array in Plane View Mode


Markers, Data Tips, and Color Palette

Array Viewer has the following features that provide visual information about data:

Markers — Provide positional information

Data Tips — Provide the coordinates and value of a data point

Color Palette — Provides additional visual cues in graphs


Markers

You can move around in Data View and Graph View by using the marker. To enable the marker, click the Marker button on the graph toolbar or select Show Marker from the View menu.

In Data View, double-clicking on a data cell moves the marker to the position of the cell. The cell acquires a red border if the marker display is enabled.

In Graph View, the marker’s appearance depends upon the current graph type:

•	In height plot graphs, the marker is red and has the shape of two pyramids joined at a rectangular section of the graph’s surface.  Depending on which data point is selected, you may or may not see both pyramids.  The pyramids are semi-transparent, so they do not obscure your view of the graph. The rectangle where they join is the one associated with the current data value.

•	In image map graphs, the marker is a square with a smaller square inside it. The outer square is one-tenth the height and one-tenth the width of the entire image surface. The inner square is a rectangle whose boundaries are exactly those of the rectangular part of the color surface associated with the current data value:

If the data set has a very large number of rows and a very large number of columns, the inner part of the marker is so small it might not display as more than a pixel. To help you find the inner part, this marker contains four lines in addition to the parts already mentioned. Each connects one corner of the outer part to the corresponding corner of the inner part. When the inner part is very small, the four lines form an X, and the inner part is at the center of the X.

If either the number of rows or the number of columns is 10 or less, then, by the definition of the inner part of the marker, it should extend beyond the boundaries of the outer part. However, the Array Viewer does not display any part of the inner part outside of the outer part.

•	In both vector and plane view graphs, the marker has no special properties. To see what they look like, find the example graphs in the introduction.

For information on changing the marker position in Graph View, see Moving the Markers.


Data Tips

When you look at data in Graph View, you can see the coordinates of a data point, as well as its value:

This is called a "data tip". To display a data tip for a point in the Graph View, just place the mouse cursor on the point. When the cursor stops moving, the data tip pops up.

If the graph is a vector graph, the data tip displays the row number, followed, in order, by the x- and y-coordinates, the x-, y-, and z-coordinates, or the x-, y-, z-, and w-coordinates, depending on whether the ROI has two, three, or more than three columns.


Color Palette

The color palette is enabled by clicking the Palette button on the toolbar or by selecting Show Palette from the View menu.

The following is an example of a color palette:

The color palette is a continuum of color values that provide additional visual cues in graphs that are displayed.

For each data element in the graph, Array Viewer assigns a color value to the element by interpolating the element’s value within the palette range.

You can choose any of several pre-defined palettes and define how the numeric array values map to palette colors.  For more information, see Choosing a Color Palette.

You can also construct a new palette.  For more information, see Palette Editor Dialog.


Changing the View Perspective of a Graph

You can change the view perspective of a graph by:

•	Rotating the graph

•	Zooming in or out

•	Moving the markers

•	Choosing a color palette

•	Customizing the axis display


Rotating a Graph

You can rotate Height Plot graphs and 3- or 4-component Vector graphs:

1.	Point to a part of the graph.

2.	Press and hold the left mouse button, and drag. The graph rotates about a point near its center, letting you look at the graph from any angle. When you release the mouse button, the graph remains where you dragged it. You can repeat this procedure if desired.

You can also zoom the whole graph.


Zooming

You can use zooming in any graph type.  To zoom in the current displayed graph:

1.	Position the cursor at a place where you would like to see more detail.

2.	Select Zoom In or Zoom Out from the ROI 2D Toolbar or select Zoom In or Zoom Out from ROI 2D in the View menu.

If Zoom In is chosen, the graph size stays the same, but the effect is the same as it might be if you made the ROI smaller.  This can affect the color palette and change the colors in the graph.

You can zoom in as many times as the size of the data set permits. Bigger data sets allow deeper zooming. If you then zoom out a sufficient number of times, the graph will be as it was before you started zooming in and the Zoom Out option will be disabled.

In Height Plot graphs and 3- or 4-component Vector graphs, you can also move your "virtual eye" position closer by doing the following:

1.	Move the mouse into the graph window.

2.	Hold down both the SHIFT key and the left mouse button while you move the mouse.

When you do this, some parts of the graph may get cut off by the window border, but the ROI values don't change.


Moving the Markers

Array Viewer links the markers in Data View and Graph View so that when you move one, the other moves accordingly.

To move the marker in Data View, double-click on another cell.  To move a marker in Graph View, choose another point in the graph and double-click.

You can also use the arrow keys to move the data marker. Such a move has a corresponding effect on the graph marker:

•	The up-arrow ↑ increments the marker’s current row index by one.

•	The down-arrow ↓ decrements the marker’s current row index by one.

•	The right-arrow → increments the marker’s current column index by one.

•	The left-arrow ← decrements the marker’s current column index by one.

If you hold down the Shift key and press one of the above arrow keys, you move by approximately 10 percent of the total area in the direction indicated by the arrow key.


Choosing a Color Palette

You can choose any of several pre-defined color palettes using the palette menu. Also, AGL and HDF files can include their own custom palettes. If a custom palette exists for the current data file, you can invoke it as the active color palette by selecting Custom from the Palette menu.

You can also construct a new palette.  For more information, see Palette Editor Dialog.

An associated palette range defines how the numeric array values map to palette colors. For more details, see the Palette Range Dialog topic, which describes how you can define any range as the palette range and what you can expect when you do so.

For each data element in the graph, Array Viewer assigns a color value to the element by interpolating the element’s value within the palette range. If the Use Palette option is selected in the Graph Settings dialog for the graph type, Array Viewer uses the assigned color when displaying the element.


Customizing the Axis Display

Depending upon the current graph type, there can be one, two, or three axes that you can customize. You can do the following to modify axis display:

Action	Where to Find More Information
Customize X- and Y-axis scaling for vector graphs	Scale Settings Dialog
Customize Z-axis scaling  for height plot graphs, vector graphs, and plane view graphs	Scale Settings Dialog
Customize the region of interest (ROI), which affects the values available for axis scaling and graph coloring	Region of Interest  ROI 2D Toolbar  ROI 3D Toolbar
Clamp data to axis values	In height plot graphs, see Height Plot Settings Dialog In plane view graphs, see Plane View Settings Dialog
Select data columns to be used for axis values in vector graphs	Vector Plot Settings Dialog
Choose palette range settings, which work with axis settings to determine the coloring of graphs	Palette Range Dialog
Show or hide axes	In height plot graphs, see Height Plot Settings Dialog  In image map graphs, see Image Map Settings Dialog  In vector graphs, see Vector Plot Settings Dialog  In plane view graphs, see Plane View Settings Dialog
Swap X- and Y-axes of an image map	Image Map Settings Dialog
Flip an image map graph with respect to its axes	Image Map Settings Dialog
Control the range of values for the X-, Y-, or Z-axis	Axis Range Dialog
Modify axis settings, such as tickmarks or name	Axis Settings Dialog

For height plot and image map graphs, the X- and Y-axis typically show the array index values.  But sometimes you'd like the axis to display some other range.  For example, your array is actually elevation data and you want X to show Longitude in the range 48 to 65 and Y to show Latitude in the range 20 to 28.

An AGL or HDF file can have that data as part of the file.  When the file is loaded, if the axis scale information is available, it is displayed instead of the array index values.  To revert to the typical index values, uncheck the Axis Scales option in the View menu.


File Formats

Array Viewer supports three file formats: .AGL, .HDF, and ASCII text.


AGL File Format

The AGL file format is a binary format developed specifically for the Compaq Array Visualizer. An AGL file contains the following information:

•	All graph settings for the array

•	The array extents

•	The array rank

•	The array values

•	Custom Palette data (optional)

•	The language (C, Fortran, or Basic)

•	The array lower bounds, if applicable

•	The data type (double, float, long, etc)

Because they have a binary format, you cannot create or edit AGL files directly. AGL files can be created by applications that use the Aview library to save array data as a file.

Data that has been loaded into Array Viewer from other sources, can be saved as an AGL file by using Save As… from the File menu.


HDF File Format

Hierarchical Data Format (HDF) is a binary, platform-independent format developed by the National Center for Supercomputing Applications (NCSA). The HDF group at NCSA provides libraries that enable applications on a variety of platforms to read and write data to HDF files.

The HDF file format enables:

•	Multiple data objects to be contained in a single file.

•	Metadata, which is information about the data encapsulated within the file. Examples of metadata include annotations, palette data, and axis-scale information.

When it contains an HDF file, Array Viewer displays an extra pane to the left of the Data View and Graph View panes. In this pane is a file tree on which each "leaf" is an AGL file. Whenever you select an AGL file in the tree, its data appears in the Data View and its graph appears in the Graph View:

You can remove the tree view when working with an HDF file in two ways:

•	Click on the close button at the upper-right corner of the tree view.

•	Select the HDF Tree menu item — a toggle — from the View menu.

For more information about HDF, see the NCSA HDF Home Page at http://hdf.ncsa.uiuc.edu.


Text File Format

Array Viewer can read a text file that contains numeric data. If the file contains any data that is not numeric, it is ignored.

If the text file contains multiple lines of numeric values, the Array Viewer assumes that each line represents one row of array data.   If each line does not contain the same number of fields, the Array Viewer reports the discrepancy in the input data and fills the missing values with zeros.  The data type of the data is assumed to be four-byte floating point (AGL_FLOAT).

If you want more control over how the text file is imported, four special header lines should be inserted at the start of the file to define the type, language, and dimensions of the input data.

The following example text file shows how the header lines are used:

   #agl ascii data V1.0

   #type AGL_DOUBLE

   #lang Fortran

   #dim 2 4

   10 20 30 40

   11 21 31 32

Explanation of the header lines in this example:

•	The first line should always be "#agl ascii data V1.0".

•	The second line indicates the data type to be used.  The line starts with the characters "#type" followed by one of the types listed in avdef.h.  In this case the desired type is eight-byte floating point.

•	The third line indicates the language style to be used.  The Array Viewer shows values used in data tip windows and in the status bar using either a C language style or a Fortran language style.  Use "#lang Fortran" for Fortran, or "#lang C" for C.

•	The fourth line indicates the array extents.  For each dimension in the array, provide a numeric value for the extent.  In this case, we're specifying a two-dimensional array of two rows and four columns.  When the "#dim" line is provided, the Viewer will ignore any line breaks and just scan the file until enough fields have been scanned to fill the array.

If you have an acceptable text file or spreadsheet file, you can select the rectangular region to be viewed, copy it onto the clipboard, and paste it into the data window of Array Viewer. It is then ready for viewing. If you want to save the data, be sure to save it as an AGL file, using Save As… from the File menu, before exiting Array Viewer.

You can also select a region of the data set in Array Viewer, copy it to the clipboard, and then paste it into a text editor. You can then paste it back into Array Viewer as a new data set.  To select the entire array, click on the empty cell in the top left corner of the Data View pane.


Menu Bar

The Menu Bar offers the following drop-down menus:

File Menu — Presents standard file-related choices, such as opening, saving, and printing.

Edit Menu — Presents universal editing choices: cut, copy, and paste.

View Menu — Presents three groups of options that affect the appearance of Array Viewer and its contents:

•	Options that show or hide interface aids

•	Options that specify the graph type to display in the graph window

•	Options for zooming

Settings Menu — Presents choices, each leading to dialog boxes where you can make selections that configure your graphs to your liking. This is the most important menu, as well as the one you will use most often.

Colors Menu — Presents the standard color-selection dialog box, so you can choose colors for various elements of graphs.

Palette Menu — Presents variations on the color palette for the data set. It also lets you specify a range of values for the palette, and lets you tell Array Viewer to use any custom palette that is in the current AGL file.

Data Menu — Presents two items, Refresh and Annotation… Refresh is enabled only when Array Viewer has an active connection with another program that is the source of its data. The Annotation dialog lets you write text that becomes part of the file when it is next saved.  When the file is reopened the text can be viewed and amended.

Help Menu — Lets you open this help file or look at information about Array Viewer (such as the current version number).


File Menu

The File menu lets you perform standard file-related operations.  The options are:

New — Opens an empty file, into which you can paste numeric values from other applications, such as a text editor or a spreadsheet program.

Open File… — Opens an existing .AGL, .HDF, or other Array Viewer compatible file, with the data, settings, and annotations that were in effect when the file was last saved.

Open URL… — Downloads an .AGL, .HDF, or other Array Viewer compatible file from the Internet and displays it.

Save — Saves the current Array Viewer environment, including data, graph, settings, and annotations, under the current file name.

Save As… — Saves the current Array Viewer environment, including data, graph, settings, and annotations, using the name and location that you specify.

Print… — Prints the current Graph View; lets you select a printer and change its options.

Print Preview — Displays the page as it will look when printed.

Recently-Used File List — Lists the files you have opened in this program. When you have opened more than eight files, it lists the eight files you have opened most recently. You can reopen any of these files by selecting it from this list.

Exit — Closes the Array Viewer.


Edit Menu

The Edit menu lets you perform standard editing operations. The options are:

Cut — Copies any data selected to the clipboard and then converts each selected data item to the value designated as the fill value.

Copy — Copies data values or a bitmap to the clipboard. If the Data View window is the active window, data values from the Data View selection area are copied to the clipboard.  If the Graph View window is the active window, a bitmap of the current Graph View window is copied to the clipboard.  The active window is selected by clicking in the desired window with the left or right mouse button.

Paste — Copies information from the clipboard into Array Viewer.

If the clipboard contains one value, it replaces the currently-selected value.  If the data on the clipboard contains a rectangle of values, pasting it overwrites a rectangle of identical dimensions, where the upper-left value of the pasted data overwrites the upper-left value of the currently-selected region

When pasting into an existing array, the array extents won't be extended to include the clipboard data.  Any clipboard data elements that fall outside the bounds of the array will be ignored.  However, if there is no array loaded in the Array Viewer, a new array will be created with array extents equal to the number of rows and columns in the clipboard data.

To select a cell or a region in Data View, hold down and drag the left mouse button in the cell or across the region.

To select an entire row or column, hold down and drag the left mouse button in the index cell of the row or column.

To select the entire array, hold down and drag the left mouse button in the top left corner of the index area.


View Menu

The View menu lets you select a graph type or perform operations on display features that are generally independent of the current graph type.  The options are:

Toolbars — Displays or hides the toolbars.

Status Bar — Displays or hides the status bar.

Split — Moves focus to the divider between the data and graphing areas of Array Viewer, so you can drag the divider to any desired position.

Home View — Returns the graph window to its home (default) view.

Set Home — Sets the current view of the graph window as the home (default) view.

Show Marker — Displays or hides the current-location marker for any graph, regardless of its type.

Show Palette — Displays or hides the color palette for all graph types.

Axis Scales — Displays or hides the axis scale information, if available, for height plot or image map graphs.  By default, this option is set to display the information.

HDF Tree — Displays or hides the HDF tree when the current data file is an HDF file.

Height Plot — If the graph in the graph window is not a height plot graph, displays the current data as a height plot graph, using the current settings for that graph type.

Image Map — If the graph window does not contain an image map graph, displays the current data as an image map, using the current settings for that graph type.

Vector Graph — If the graph window does not contain a vector graph, displays the current data as a vector graph, using the current settings for that graph type.

Plane View — If the graph window does not contain a plane view graph, displays the current data in the plane view, using the current settings for that graph type.  Note that the plane view is not available if the current ROI for the data set has both 10 or more rows and 10 or more columns.

ROI 2D — Provides the options that appear on the ROI 2D toolbar.  These menu items let you conveniently move the ROI within the current 2D "slice"; that is, the two-dimensional sub-array that is currently displayed in the Graph and Data Views.

ROI 3D — Provides the options that appear on the ROI 3D toolbar.  These menu items let you conveniently move the current 2D "slice" of a 3D (or larger) array forward and backward along a third dimension defined as the largest array extent that is not being used as a row or column dimension.  For 1D or 2D arrays, the items in this menu are not enabled.


Settings Menu

This menu serves as the gateway to making attribute settings. .These settings let you control the appearance of a graph to present your data in the most meaningful and pleasing way.

The following categories of dialog boxes are available in the Settings menu:

Data View…	This dialog lets you control how the data set values are displayed in the Data View window.
Graph…	This dialog differs depending on which graph type is currently being displayed. Each dialog offers several options that, collectively, give you a large amount of control over how the graph displays the data in the region of interest (ROI).
ROI…	This dialog differs depending on how many dimensions are in the current data set. It lets you specify a region of interest within the array.
Scale…	This dialog lets you set the scaling of the z-axis. Scaling determines how far apart the values are to be on the axis. In other words, scaling makes your graph taller or shorter.
Range…	This dialog lets you use numbers to set the starting and stopping values on each axis.
Axis…	This dialog lets you customize how the graph’s axes are displayed.
Options…	This dialog lets you modify the default settings for Array Viewer.


Data View Settings Dialog

This dialog lets you specify how the data set values are to be displayed:

The options in this dialog are as follows:

Default Format — Check this box if you want to use a default format for displaying the data set values. The precision and the field width used are shown in the edit boxes. Uncheck this box if you want to use the Exp form, the Hex form, or to change the precision or the field width for the display.

Exp Form — Check this box if you want to use scientific notation to display floating-point numbers.

Hex Form — Check this box if you want to display integer values as hexadecimal numbers.

Show Dimension Labels — Check this box to display dimension names.

Cell Edit Enabled — Check this box to enable the Cell Edit Mode.

Precision — Specifies how many digits to the right of the decimal point are displayed for floating-point data.

Field Width — Specifies the width allocated to display each data value.  If the required field width of a data value exceeds the specified field width, the data value is displayed as a string of stars.


Graph Settings Dialogs

This dialog provides options for the graph type currently being displayed in the graphing area.  Each of the following graph types has its own dialog box in which you can make settings that apply to graphs of that type:

Height Plot graphs

Image Map graphs

Vector graphs

Plane View graphs


Height Plot Settings Dialog

The options in this dialog are as follows:

Style — Specifies the graph style used. The following styles are available:

Wireframe — Displays the graph with lines connecting points whose values are adjacent in the data array.  It:

•	Uses interpolation to get appropriate values for intermediate points

•	Uses the color palette to get the appropriate color for each point plotted

Surface — Displays the graph as a fully-filled-in surface.  It:

•	Uses interpolation to get appropriate values for intermediate points

•	Uses the color palette to get the appropriate color for each point plotted

Barchart — Displays the graph as an array of bars. For each data value there is one bar whose:

•	Height matches the data value

•	Color is the one associated with that data value on the color palette

Lines — Displays a collection of lines, each based on the values in a data column.  It:

•	Uses interpolation to get appropriate values for intermediate points

•	Uses the color palette to get appropriate colors for each point plotted

Points — Displays only the points corresponding to the data values, using the color palette to get appropriate colors for each point plotted.

Flat Shading — Colors each polygonal section of surface graphs uniformly with a color that is appropriate for the "height" of the polygon. When you clear the box, Array Viewer interpolates colors between the points of adjacent polygons. This makes the color transitions on the graph smooth.

Highlighting — Shows highlights from the reflection of a virtual light source that seems to be above and to the right of the person facing the screen.

Smooth Lines — Reduces the jagged edges that appear when diagonal lines are drawn on the computer screen.

Texture On — Increases the precision of the interpolation that takes place on surface graphs when Flat Shading is unchecked. Selecting this option returns both Flat Shading and Highlighting to their default values and disables them.

Depthcue — Fades out parts of the graph that are farther away from the viewer. The purpose of this option is to provide visual cues to distance.

Show Grid — Shows grid lines on surface graphs.

Hidden Line — Shows only lines that are not "behind" a closer part of the graph. When cleared, it shows all lines (which might create a cluttered effect). In addition:

•	When you check this box, all lines, when viewed from underneath the "surface" are hidden.

•	This option applies only to Wireframe and Line graph types.

Show Axis — Displays the three axes and their labels, tick marks, and values, as well as the background planes of the viewing region.

Use Palette — Shows graphs using the color palette.

Clamp Data — You can use the Settings Axis Range dialog to constrain axis values to a range that does not include all values in the ROI.  When you select this check box, points with values outside the z-axis range are clamped to the z-axis range under the following conditions:

•	If the value of a point is larger than the high end of the z range, then the point plots as if its value is equal to the high end of the z range.

•	If the value of a point is smaller than the low end of the z range, then the point plots as if its value is equal to the low end of the z range.

When Clamp Data is not selected and a data point is outside the z-axis range, the point is "clipped," that is, you will see a hole in the graph around the data point.

Grid Density — By sliding the handle, you can set a density value for display of grid lines on surface graphs. These lines are parallel to the X and Y axes. The density increases as you slide the handle to the right.

For more information on this type of graph, see Height Plot Graph.


Image Map Settings Dialog

The options in this dialog are as follows:

Flip X — Rotates the image view around a line that bisects the view and is perpendicular to the x-axis. The rotation carries the x-axis itself (including the tick marks and values) around the same line. The rotation is a half-turn (180°).

Flip Y — Rotates the image view around a line that bisects the view and is perpendicular to the y-axis. The rotation carries the y-axis itself (including the tick marks and values) around the same line. The rotation is a half-turn (180°).

Swap XY — Rotates the image view around the line that contains the lower-left and upper-right corners of the image view. After the rotation, the image view automatically adjusts its shape so that it still has horizontal and vertical sides. When you swap the X- and Y-axes, then they, as well as their tick marks and associated values, trade places.

Swapping axes in the graph window produces a corresponding row and column swap in the data window.

Fixed Aspect Ratio — The ratio of the x-axis length to the y-axis length is preserved during Swap XY operations. Unless the image map is square, the boundaries of the image view also change.

When this option is not selected, the shape of the image view is preserved during Swap XY operations, so its effect on the boundaries of the view is to leave them the same, just as in Flip X and Flip Y operations.

Show Axis — Displays the two axes and their labels, as well as tick marks and their associated values.

Linear Filter — The color of each data item in the graph is blended with the colors of its neighboring items.

When this option is not selected, the color of each data item is determined solely by the data value and color palette. This produces a blocky appearance.

Show Grid — Displays horizontal and vertical grid lines on the image view.

For more information on this type of graph, see Image Map Graph.


Vector Plot Settings Dialog

The options in this dialog are as follows:

Style — Specifies the graph style used. The following styles are available:

Lines — Displays the vector plot as a line.  It:

•	Uses interpolation to get appropriate values for intermediate points

•	Uses the color palette to get appropriate colors for each point plotted

Points — Displays only one point for each row.  It uses as coordinates the data values in the columns designated for that purpose and uses as the color values the ones in the column designated as the source of color values.

Smooth Lines — Reduces the jagged edges that appear when diagonal lines are drawn on the computer screen.

Show Axis — Displays the three axes and their labels, tick marks and their associated values, and the background planes of the viewing region.

Depthcue — Fades out parts of the graph that are farther away from the viewer. The purpose of this option is to provide visual cues to distance.

X-Component Index — In the data array, the number of the column to be used as the source of x-coordinates of plotted points. This choice overrides the Row setting in the ROI Settings dialog .

Y-Component Index — In the data array, the number of the column to be used as the source of y-coordinates of plotted points. This choice overrides the Col setting in the ROI Settings dialog.

Z-Component Index — In the data array, the number of the column to be used as the source of z-coordinates of plotted points.

W-Component Index — In the data array, the number of the column to be used as a value associated with a color on the color palette. The point for each row displays in the color corresponding to the value in that row and the w-component column.

If you set any component index to 0, that component does not participate in the display of the graph. For example, setting the w-component to 0 causes the graph to display in only one color. Note that a three-column data array, when graphed with default settings, displays in one color for the same reason — no color values are available.

If you set either the x-component or the y-component (not both) to 0 while the z-component is not 0, the result is a plane view graph. For example if the x-component is 0 and both the y- and z-components are not 0, the graph has y as its horizontal axis and z as its vertical axis.

Similarly, if the z-component is 0 and the x- and y-components are both not 0, the graph has x as its horizontal axis and y as its vertical axis. This graph is also the projection onto the xy-plane of the three-dimensional vector graph you might get by setting the z-axis to a non-zero value, except for some possible differences in coloring. Coloring differences, depending only on the w-component, would not occur unless you also change the w-component.

For more information on this type of graph, see Vector Graph.


Plane View Settings Dialog

The options in this dialog are as follows:

Style — Specifies the graph style used. The following styles are available:

Lines — Displays a collection of lines, one for each column in the data set.  It:

•	Uses interpolation to get appropriate values for intermediate points

•	Uses the color palette to get appropriate colors for each point plotted

Points — Displays a point for each value in the data set.  It uses as the x-coordinate the row number of the value, and the value itself as the y-value. The color of the point depends upon whether the Use Palette check box is selected.

Barchart — Displays a vertical bar for the largest value in each row of the data set.  It uses the row number as the central axis of the bar and uses the data value itself to determine the height of the bar. Each bar starts on the x-axis. The color of the depends upon whether the Use Palette check box is selected.

Smooth Lines — Reduces the jagged edges that appear when diagonal lines are drawn on the computer screen.

Clamp Data — The z-axis can be constrained (using the Settings Axis dialog) to a range that does not include all values in the ROI.  When this occurs, points with values outside the z-axis range are clamped to the z-axis range under the following conditions:

•	If the value of a point is larger than the high end of the z range, then the point plots as if its value is equal to the high end of the z range.

•	If the value of a point is smaller than the low end of the z range, then the point plots as if its value is equal to the low end of the z range.

When Clamp Data is not selected and a data point is outside the z-axis range, the point is "clipped," that is, you will see a hole in the graph around the data point.

Show Axis — Displays the two axes and their labels, tick marks and their associated values, and the background of the viewing region.

Use Palette — Shows graphs using the color palette. The colors of points and bars can change as you make changes to the ROI.

For more information on this type of graph, see Plane View Graph.


ROI Settings Dialog

The appearance of this dialog is determined by the number of dimensions in the current data set.  The following figures show examples of ROI Settings… dialog boxes for one-, two-, and three-dimensional data sets:

Regardless of array rank, each ROI dialog lets you specify a region of interest within the data array.  If the data set has more than two dimensions, your definition of a new region of interest may involve changing more than just the dimensions that you see in the data window.

The options in this dialog are as follows:

Dim — For each row, the dimension number for the dimension that the row represents.

Extent — The extent for that dimension of the array.

For C arrays, which always start at index 0, the extent is just the number of elements for that dimension of the array.

For Fortran arrays:

•	If the dimension is 1 (the Fortran default), the starting index for the extent is also the number of elements along that dimension.

•	If the starting index is other than 1, the extent is labeled in three parts:

1.	The first index

2.	A colon (:)

3.	The last index

For example, if the size of a dimension in the array is 25, the extent might display as 25, or as 3:27, or even as —10:14, depending upon where indexing begins for that dimension.  In this case, the number of elements for that dimension is equal to the ending index minus the starting index plus one.

Row — The row dimension determines which data elements get mapped to the rows of the data and graph windows, except for vector graphs.  In this case, use the Graph Settings dialog to select columns individually for point placement and coloring. You can change the row dimension to a different dimension simply by selecting that dimension’s Row button.

If you select the dimension that is currently the one specified as the column dimension, Array Viewer picks a different dimension to be the column dimension.

Col — The column dimension determines which data elements are mapped to the columns of the data and graph windows, except for vector graphs.  In this case, use the Graph Settings dialog to select columns individually for point placement and coloring. You can change the column dimension to a different dimension by selecting that dimension’s Col button.

If you select the dimension that is currently the one specified as the row dimension, then Array Viewer picks a different dimension to be the row dimension.

Start — The value in this field has two meanings, depending upon whether the dimension is a row or column dimension or one of the other dimensions:

•	If the dimension is the row (or column) dimension, then the Start value is the number of the row (or column) where the ROI is to begin. This implies that, in the data window, only the rows whose numbers are ≥ the Start row and the columns whose numbers are ≥ the Start column will be mapped into data elements in the graph window.

The Start values for the row and column dimensions have no effect on the contents or appearance of the data window.

•	If the Start value is for a dimension other than the row and column dimensions, then the Start value identifies the smallest index to be used in the definition of the data subset being defined for later viewing.

If your data set has three or more dimensions, you can use this dialog as a means of viewing your data as a series of two-dimensional "slices," as follows:

1.	Decide which dimensions are to be the row and column dimensions for each slice.

2.	Select a dimension to use for slice control.

3.	Step through the valid Start index values for the control dimension, returning each time to this dialog to increment the value.

4.	If there the data set has four or more dimensions, repeat step 3 after assigning another value to one of the dimensions other than the three you have been using. Do this as many times as is necessary.

5.	If there are more than four dimensions, generalize the previous instructions and step through as much of the data set as you want to view.  The ROI dialog is your control center for this type of exploration. A thorough search of a many-dimensional data set is an arduous and complex task. Use the design of the ROI dialog as the basis for designing your search.

Length — The value in this field always has exactly one of the following meanings:

•	If the dimension is the row (or column) dimension, then the Length value is the number of the rows (or columns) in the ROI.

•	If the Length value is for a dimension other than the row and column dimensions, then the Length value is fixed at 1, because the thickness of each slice is one data value.

Lower Bound — This field is present only when the current array is a Fortran array. You can use it to define a new starting index for a dimension of the array.

A Lower Bound value has no effect on what values display in the graph. The only visible effects are in the axis labeling and the row and column indexes of points selected in the graph.


Scale Settings Dialog

This dialog, which is enabled only for three-dimensional graphs, lets you make immediate changes to the scaling of the z-axis. Moving the slider to the right stretches the z-axis, making the image taller; moving it to the left compresses the z-axis, making the image shorter.

This action is different from and independent of zooming.


Axis Range Dialog

One of two possible Axis Range dialog boxes appears, depending on which graph type is currently selected.  For Height Plot or Plane View graphs, the first dialog below appears; for Vector graphs, the second appears.  Axis range setting is not available for Image Map graphs.

You can use this dialog to control the range of values for whichever of the following apply to the graph type currently being displayed: the x-axis, the y-axis, and the z-axis.

If you select the check box titled "Auto adjust to min, max data range," then Array Viewer automatically uses the minimum and maximum data values for each dimension.

Disabling the automatic assignment of minimum and maximum values enables all scroll boxes on the screen.  You can then assign any values you wish by entering them into the appropriate boxes or by scrolling to them.


Axis Settings Dialog

When you select Axis… from the View Menu, the Axis Settings Dialog appears:

The options in this dialog are as follows:

Show Axis — When this box is checked, the dialog displays the three axes and their labels, tickmarks, and values, as well as the background planes of the viewing region.

Font Auto Detail — When this box is checked, the text size used for the axis varies with the size of the graph window.  Otherwise, the text size remains fixed.

Axis Auto Detail — When this box is checked, the number of tickmarks for each of the graph’s axes is automatically adjusted based on the data range and the size of the graph view window.  If this box is not checked, you can use the X-,Y-, and Z-axis tickmark fields in this dialog to directly control the number of tickmarks.

Axis Style — This combo box lets you select from a number of axis styles.

X-Axis Name — This edit box can be used to change the axis name for the X-axis, if the X-Axis corresponds to one of the array dimensions.   For example, in a Height Plot graph, the X-axis corresponds to the array’s column dimension.

Y-Axis Name — This edit box can be used to change the axis name for the Y-axis, if the Y-Axis corresponds to one of the array dimensions.   For example, in a Height Plot graph, the Y-axis corresponds to the array’s row dimension.

Z-Axis Name — This edit box can be used to change the axis name for the Z-axis, if the Z-Axis corresponds to one of the array dimensions.   For example, in a Height Plot graph, the Z-axis corresponds to the array values.

Use Dim Name — This checkbox can be used to control whether the axis name is displayed or the dimension name. (See also Dimension Labels Dialog.)

X-Axis Tickmarks — The two edit boxes in this section can be used to select the number of major and minor tickmarks displayed along the X-Axis.  If "Axis Auto Detail" is checked, these items are disabled and the number of tickmarks is automatically controlled.

Y-Axis Tickmarks — The two edit boxes in this section can be used to select the number of major and minor tickmarks displayed along the Y-Axis.  If "Axis Auto Detail" is checked, these items are disabled and the number of tickmarks is automatically controlled.

Z-Axis Tickmarks — The two edit boxes in this section can be used to select the number of major and minor tickmarks displayed along the Z-Axis.  If "Axis Auto Detail" is checked, these items are disabled and the number of tickmarks is automatically controlled.


Options Dialog

Use this dialog to modify the option settings for the Array Viewer. For example, you can:

•	Specify whether .AGL file attributes are to be saved with the file and whether those attributes are to be used when opening .AGL files subsequently

•	Set default attribute settings for files that don't contain attribute information

•	Set the fill value that will be used to replace values that you cut from the Data View

The options in this dialog are as follows:

Default Settings — These settings define the default Array Viewer settings that are used for files that don't contain attribute information (or when the Restore Attributes checkbox is unchecked); they do not affect how the current file is displayed (but may effect how the next file is loaded). Array Viewer settings include graph type, graph style, current palette, palette range, axis range, and so forth.

The following selections are available:

Save Current — Saves the current Array Viewer settings as the default settings. These attributes become the new default settings for files until you change them, either by saving new settings or by clicking on the Restore Original button.

Restore Original — Restores the default settings to the values used when the program was first installed.

HW Acceleration — Check this box to enable OpenGL Hardware Acceleration in Array Viewer and the Avis2D ActiveX control (if supported by the graphics adapter). Deselect this box to force Software Rendering.

Fill Value — The value that is to be used, until changed here, to replace any data that is deleted (cut) from a data set.

AGL Files — These settings affect how attributes of an .AGL file are loaded or saved; they do not affect how the current file is displayed. The following settings are available:

Save Attributes — Check this box if you want to save the current Array Viewer settings as attributes for the current .AGL file.  These attributes are saved when File Save or File Save As is used to save the file.

Restore Attributes — If you check this box, attribute information in the file (if any) is used to set the Array Viewer settings the next time the file is opened.  If this box is not checked, the Default Settings are used.

Show Annotation —Check this box to see any annotation that may exist for a file. The annotation will appear when the file is opened.

HDF Files — Check this box to display the file tree pane when an .HDF file is opened.

Context Menus — Check this box if you would like clicking on the Graph or Data Views to bring up the property pages for the Avis2D and AvisGrid ActiveX controls used by the Graph and Data View windows.  These property pages enable settings for some additional properties that are not available from Settings dialogs, such as Line and Point size in the Graph View.  However, if you later use File Save to create or modify an AGL file, the changes made by using the property pages won’t be reflected in that file.


Colors Menu

The options on the Colors menu are:

Background — The background in the Graph View

Graph — Applies to surface graphs only. This option is not available unless you do the following in the Settings Graph dialog:

•	Select Surface

•	Deselect Vector Plot

•	Deselect Use Palette

Grid Lines — All grid lines on graphs whose graph style is Surface

Marker — The marker in the Graph View

Labels — All axis names and values in the Graph View

Axis Foreground — All visible edges, including tick marks, of the display portion in the Graph View

Axis Background — All visible faces of the display portion in the Graph View


Palette Menu

The Palette menu lets you determine how colors in the graph and color windows correspond to array data values.

The options on the Palette menu are:

Range… — Sets the range of z-values that determine where the color palette begins and ends.

If you want the range of color palette values to coincide exactly with the range of z-values in the graph, then select "Auto adjust to min, max data range."

Not selecting that option enables two scroll boxes, named Min Value and Max Value. Any data values smaller than the value in the Min Value box have the color at the bottom of the color palette. Likewise, any data values larger than the value in the Max Value box have the color at the top end of the color palette.

Edit… — Constructs a new palette using the Palette Editor.  The graph in the Graph View is updated using the new palette.  You can save a new palette in an .AGL file.

Custom — Applies only to data sets whose files include a custom color palette for that data set.  Selecting this menu item loads the custom array.

Gray Scale — Maps the data to the gray-scale spectrum, with the smallest value in the data set mapping to black and the largest mapping to white.

Gray Scale Banded — Like Gray Scale, except that the visual effect is a collection of alternating light and dark rings, with the rings getting lighter overall as the values increase. The number of rings is typically between 20 and 30.

Gray Scale Inverted — Like Gray Scale, except that the smallest value maps to white and the largest value maps to black.

Rainbow — Maps a segment of the color spectrum to the data, with the smallest value mapping to dark blue and the largest value mapping to red.

Rainbow Banded — Like Rainbow, except that the visual effect is a collection of colored rings, each displaying a part of the color spectrum, with the rings stepping from the blue part of the spectrum to the red part, as the values increase. The number of rings is typically between 20 and 30.

Rainbow Inverted — Like Rainbow, except that the smallest value maps to red and the largest to dark blue.


Palette Range Dialog

When you select Range… from the Palette menu, the Palette Range Dialog appears:

This dialog lets you assign any two values — say PaletteMin and PaletteMax — as the bottom and top, respectively, of the palette range.

The default palette range is identical to the data value range; that is, PaletteMin = DataMin and PaletteMax = DataMax. The default palette range is in effect whenever "Auto adjust to min, max data range" check box is enabled.

Note: When you make vector graphs, the W column contributes the a value for each row in the data set. So, if you are especially interested in vector graphs, mentally substitute the minimum value in the W column for DataMin and the maximum value in the W column for DataMax. For simplicity, this topic uses DataMin and DataMax to describe the concepts for all types of graphs.

When you disable the "Auto adjust to min, max data range" check box, the default is:

•	PaletteMin  = Min Value

•	PaletteMax = Max Value

You can change the Min Value and Max Value numbers, and thus the PaletteMin and PaletteMax values, whenever you want.  This gives you great control over the coloring of your graphs. The following generalizations apply:

PaletteMin  > DataMin	All data values less than PaletteMin are assigned the color for PaletteMin.
PaletteMax < DataMax	All data values greater than PaletteMax are assigned the color for PaletteMax.
PaletteMin  < DataMin	The color range extends beyond the bounds of the data set, so the colors at the bottom of the color palette do not appear in the graph.
PaletteMax > DataMax	The color range extends beyond the bounds of the data set, so the colors at the top of the color palette do not appear in the graph.
PaletteMax < PaletteMin	The color range is being defined in a meaningless way, so Array Viewer does not change its display.
To better understand palette range values for any graph, you may want to experiment with them.  In particular, you will quickly get insights by looking at the results of making settings such as:

•	PaletteMin < DataMin    < DataMax    < PaletteMax

•	DataMin    < PaletteMin < PaletteMax < DataMax


Palette Editor Dialog

When you select Edit… from the Palette menu, the Palette Editor Dialog appears:

The colored rectangle near the top left of the dialog is the palette to be edited.  It is initialized with the current palette values.  The slider beneath the palette points to an entry in the palette.  You can move the slider by using the mouse, or by pressing Page Up, Page Down, Home, End, or the arrow keys.

The edit box above the palette displays the value of the array data element that is mapped to the palette entry at the slider position.

The options in the Color group box let you scan individual color in the palette, or select a color to replace existing entries in the palette.  You can also click on the colored square to select or create a color using a color-selection dialog.

The rectangle near the center of the dialog is a drawing region for the color components.  If the RGB color model is selected, the components are Red, Green, and Blue.  If the HSV color model is selected, the components are Hue, Saturation, and Value.

You can design a new palette by holding down the left mouse button and moving the mouse inside the drawing region to redraw each color component for the palette.

You can choose a color component to draw by clicking one of the buttons in the Edit Component box.  You can select the components to be shown in the drawing region by clicking one or more check boxes in the Show Component box.  You can also choose the Point or Line drawing style for the component drawing.

When the Apply or the OK button is clicked, the graph in the Graph View is updated using the new palette.  The new palette becomes the custom palette and can be saved in an AGL file.

When the Cancel button is clicked, any changes you made to the palette after the last Apply are not saved.


Data Menu

The options on the Data menu are:

Refresh —  This option is enabled only when Array Viewer has an active connection with another program that is the source of its data. When selected, this item displays the data most recently received from the application.

Dimensions —  Lets you change the dimension names displayed in the Data View.  This dialog also displays the array extents for each dimension of the current array, and it  can be used to import axis scale data.

Annotation… — Lets you write text that becomes part of the current AGL file when you save the file. When you open an AGL file with annotations, you can use this option to read them, edit them, or delete them.  Just be sure to save the file any time you make any annotations that you want to keep.


Dimension Labels Dialog

When you select Dimensions from the Data Menu, the Dimension Labels Dialog appears:

For each dimension in the array, this dialog shows the dimension extent and dimension name.  You can modify a dimension name by editing the name field. To save changes made to the name, press the OK or Apply button.

If data is available on the clipboard, you can use the Import… buttons to copy in axis scale values for the corresponding dimension.  These values will be displayed along the graph’s axis instead of array index values when the View… Axis Scales menu item is enabled

To exit this dialog without making changes, press the Cancel button.


Annotation Dialog

When you select Annotation… from the Data Menu, the Annotation Dialog appears:

This dialog lets you enter descriptive or notational text for a data set.  You can also use this dialog to read any such information that has been added to the data set.

To exit this dialog without making changes, press the Cancel button.

To save any additions you have made to the annotations, press the OK button.

To keep new or amended annotations with the data set, save the file after making the annotations.


Toolbars

There are four toolbars, which can be displayed or hidden independently:

•	The Standard toolbar

•	The Graph toolbar

•	The ROI 2D toolbar

•	The ROI 3D toolbar

Each toolbar is a floating toolbar, which can be dragged or moved as desired.  For example, the Standard and Graph toolbars can be dragged to create 1 line of icons, such as:

Your toolbar arrangement is saved when you exit Array Viewer.

The Standard and Graph toolbars may appear on two lines:

•	When you first install Array Viewer

•	If you open a file with a different file type; for example, you were viewing an AGL file, but are now opening an HDF file


Standard Toolbar

The following are descriptions of the options that appear on the toolbar. They are described in the order they appear above:

New — Clears any file that might be in Array Viewer. This lets you open a new .AGL file by pasting in data from either a text file or a spreadsheet.

Open — Opens an existing .AGL file using the data and settings that were in effect when the file was last saved.

Save — Saves the current Array Viewer environment, including data, graph, and attribute settings, under the current file name.

Cut — Converts any data selected in Data View to the value designated as the fill value.

Copy — Copies to the clipboard any data selected in Data View.

Paste — Copies information from the clipboard into Array Viewer.  Data from the clipboard replaces any data that may have been in Data View.

Print — Prints the current Graph View; lets you select a printer and change its options.

Help About — Shows information about Array Viewer (such as the current version number).

What’s This Help — Causes the cursor to change to a "What’s this?" cursor. Move this cursor to the part of the screen for which you want help and then press the left mouse button. Appropriate help pops up and the cursor returns to its normal state. To remove the help window, click on anything in the window or press the Esc key.


Graph Toolbar

The following are descriptions of the options that appear on the toolbar. They are described in the order they appear above:

Home — Returns the graph window to its home (default) view.

Set Home — Sets the current view of the graph window as the home (default) view.

Show Color Palette — Displays or hides the color palette for all graph types.

Show Marker — Displays or hides the marker for all graph types.

Display Data as Height Plot Graph — If the graph window does not contain a height plot graph, displays the current data as a height plot graph using the current settings for that graph type.

Display Data as Image Map — If the graph window does not contain an image map graph, displays the current data as an image map graph using the current settings for that graph type.

Display Data as Vector Plot Graph — If the graph window does not contain a vector graph, displays the current data as a vector graph using the current settings for that graph type.

Display Data as Plane Graph — If the graph window does not contain a plane view graph, displays the current data as a plane view graph using the current settings for that graph type.  The plane view graph type is not available if the current ROI for the data set has both 10 or more rows and 10 or more columns.

Refresh — Is enabled only when Array Viewer has an active connection with another program that is the source of its data.  Its purpose is to update the data set with the most current values in the other program.


ROI 2D Toolbar

This toolbar lets you conveniently move the ROI within the current 2D "slice;" that is, the two-dimensional sub-array that is currently displayed in the Graph and Data Views:

The following are descriptions of the options that appear on the toolbar. They are described in the order they appear above:

Zoom In — Zooms in the current display, using the marker as the fixed point of the zoom, with the following features:

•	The display can be of any graph type.

•	When you have zoomed in so that the row count and the column count are each 10 or smaller, it is not possible to zoom in further, and this menu item becomes disabled.

•	This type of zooming is implemented by changing the ROI.  So sometimes when you zoom in, the color palette, and therefore the colors in the graph, may change.  To keep these elements fixed, disable Auto Adjust in the Axis Range and Palette Range dialogs before invoking this menu item

•	This method of zooming is different from the zooming that you can do by dragging the mouse toward you while holding down the Shift key.

Zoom Out — Zooms out the current display, using the marker as the fixed point of the zoom, with the following features:

•	The display can be of any graph type.

•	When you have zoomed out so that all of the graph is showing (the ROI is the entire data set), it is not possible to zoom out further, and this menu item becomes disabled.

•	This type of zooming is implemented by changing the ROI.  So sometimes when you zoom out, the color palette, and therefore the colors in the graph, may change.  To keep these elements fixed, disable Auto Adjust in the Axis Range and Palette Range dialogs before invoking this menu item

•	This method of zooming is different from the zooming that occurs when you push the mouse away from you while holding down the Shift key.

Pan Left — Adjusts the current ROI area to the left; that is, decreases the value of column settings in the ROI dialog.  The amount of the shift is approximately 25% of the ROI width.  The marker position also shifts left causing the Data View to scroll left.  This option has the following features:

•	The display can be of any graph type.

•	If the left edge boundary of the ROI equals the array extent for that dimension, the ROI can not be shifted anymore to the left and this menu item becomes disabled.

•	Any change in the ROI causes the display of a new set of data elements.  This may change the palette range, and therefore the colors in the graph.  The Axis Range values may also change.  To keep these elements fixed, disable Auto Adjust in the Axis Range and Palette Range dialogs before invoking this menu item.

Pan Right — Adjusts the current ROI area to the right; that is, increases the value of column settings in the ROI dialog.  The amount of the shift is approximately 25% of the ROI width.  The marker position also shifts right causing the Data View to scroll right.  This option has the following features:

•	The display can be of any graph type.

•	If the right edge boundary of the ROI equals the array extent for that dimension, the ROI can not be shifted anymore to the right and this menu item becomes disabled.

•	Any change in the ROI causes the display of a new set of data elements.  This may change the palette range, and therefore the colors in the graph.  The Axis Range values may also change.  To keep these elements fixed, disable Auto Adjust in the Axis Range and Palette Range dialogs before invoking this menu item.

Pan Up — Adjusts the current ROI area up; that is, increases the value of row settings in the ROI dialog.  The amount of the shift is approximately 25% of the ROI height.  The marker position also shifts up causing the Data View to scroll up.  This option has the following features:

•	The display can be of any graph type.

•	If the top edge boundary of the ROI equals the array extent for that dimension, the ROI can not be shifted up anymore and this menu item becomes disabled.

•	Any change in the ROI causes the display of a new set of data elements.  This may change the palette range, and therefore the colors in the graph.  The Axis Range values may also change.  To keep these elements fixed, disable Auto Adjust in the Axis Range and Palette Range dialogs before invoking this menu item.

Pan Down — Adjusts the current ROI area down; that is, decreases the value of row settings in the ROI dialog.  The amount of the shift is approximately 25% of the ROI height.  The marker position also shifts down causing the Data View to scroll down.  This option has the following features:

•	The display can be of any graph type.

•	If the bottom edge boundary of the ROI equals the array extent for that dimension, the ROI can not be shifted down anymore and this menu item becomes disabled.

•	Any change in the ROI causes the display of a new set of data elements.  This may change the palette range, and therefore the colors in the graph.  The Axis Range values may also change.  To keep these elements fixed, disable Auto Adjust in the Axis Range and Palette Range dialogs before invoking this menu item.


ROI 3D Toolbar

For 3D (or larger) arrays, this toolbar lets you conveniently move the current 2D "slice" forward and backward along a third dimension defined as the largest array extent that is not being used as a row or column dimension.  For 1D or 2D arrays, the options on this toolbar are not enabled:

Any change in the ROI causes the display of a new set of data elements.  This may change the palette range, and therefore the colors in the graph.  The Axis Range values may also change.  To keep these elements fixed, disable Auto Adjust in the Axis Range and Palette Range dialogs before invoking this menu item.

The following are descriptions of the options that appear on the toolbar. They are described in the order they appear above:

Play Reverse — Moves the current array "slice" backward repeatedly, by decreasing index values along the third array dimension. This movement stops when the beginning of the array is reached (if auto-reverse is not enabled) or the stop button is pressed.

Step Reverse — Moves the current array "slice" backward by decrementing the index value of the third array dimension.

Stop — Stops any animation that was initiated by Play Forward or Play reverse.

Step Forward — Moves the current array "slice" forward by incrementing the index value of the third array dimension.

Play Forward — Moves the current array "slice" forward repeatedly, by increasing index values along the third array dimension. This movement stops when the end of the array is reached (if auto-reverse is not enabled) or the stop button is pressed.

Auto Reverse — If this feature is enabled, selecting Play Reverse or Play Forward results in the current ROI array "slice" changing continuously until the Stop button is pressed or a new file is loaded.


Status Bar

The status bar appears at the bottom of the Array Viewer window.  It provides information about:

•	The array — The current data set of the array

•	The currently selected value in the array — The current marker position, and corresponding data value

The appearance of the status bar differs depending upon the programming language used to create the array:

The above status bar is for an array created in a C language environment.  The bar indicates that the array is named M and is a 320x320 array of short values.  It also indicates that the currently selected array value appears in row 310 and column 10, and has a value of 32775.

The above status bar is for an array created in a Fortran language environment.  The bar indicates that the array is named M and is a 256x256 array of real*4  (REAL(4)) values.  It also indicates that the currently selected array value appears in row 1 and column 1, and has a value of -0.00000507036.

Be aware that arrays defined in C start in row 0, column 0, whereas arrays defined in Fortran start by default in row 1, column 1. Note also that the syntax, both for the array definition and for the reference to a particular element, is different in the two languages. There are additional differences in Basic.

You can display or hide the status bar by choosing Status Bar from the View menu.

The left side of the status bar displays messages that you may find helpful.


Glossary

ActiveX — A component technology built on Microsoft’s Common Object Model (COM).

API — Application Programming Interface.

Array — A set of scalar data that all have same data type.  The elements of the array can be referenced by using the array name and the element indexes, where the index is the offset from the base address of the array.

Attributes (settings) — All the user-selectable settings that determine how the array data is presented in the program. Specifically:

•	The Data View settings

•	The current graph type

•	The graph settings

•	The axis range

•	The Region of Interest

•	The color settings

•	The palette and palette range settings

Data Set — The numeric values of the array or array section that are displayed in the Data View pane of Array Viewer.

Data Tip — A small window that displays the indexes and the value associated with a point on a graph.  For more information and illustrations, see data tips.

Dimension — A range of values for one index (or subscript) of an array.  An array can have from 1 to 7 dimensions

Extent — The total number of elements in a dimension.

Grid Lines — Lines that run along the surface of the graph in the X and Y directions. Use of grid lines provides enhanced perspective for the graph.

Lower Bound — The starting index for a dimension. In Array Viewer, this field is present only when the current array is a Fortran array.# Metafile_in_Glossary

OLE Automation — A means of manipulating the objects in an application from outside that application.

OpenGL — A low-level graphics library used to create three-dimensional applications.

Palette — The colors available for graphing. More specifically, a sequence of colors that map data values to colors in the graph, so that each value is associated with one color in the palette.  For more information and illustrations., see color palette.

Pan — Change the viewing angle.  For details, see Controlling the Viewer Perspective of a Graph.

Rank — The number of dimensions in an array.

Region of Interest (or ROI) — A subset of the current array that is designated for graphing.  For more information and illustrations., see Region of Interest.

Scalar — A single data item of any intrinsic data type, such as floating point, integer, etc.

Shape — The organization of the array, as determined by its rank and extents.

Size — The total number of elements in an array (the product of the extents).

Type — The data type of the array elements, such as float, integer, character, etc.

Upper Bound — The ending index for a dimension.

Vector — A data item consisting of an ordered n-tuple of scalars, such as (1.5, 3.12, 2.86).

Zoom — Change the apparent distance (near or far) from the graph angle. See Controlling the Viewer Perspective of a Graph for details.


Creating a New File

To create a new file in Array Viewer:

1.	Open Array Viewer and either click on the New button or select New from the File menu.

2.	Place your data onto the clipboard, by copying one or more lines of space-separated numbers from a text file or one or more columns from a spreadsheet program.

3.	Paste the data into the Data View window of Array Viewer by clicking the Paste button on the toolbar or by selecting Paste from the Edit menu.


Graphic cards that support OpenGL
Graphics cards that support OpenGL

The Compaq (formerly DIGITAL) PowerStorm 4D 40T/50T/60T adapters are examples of cards that support OpenGL.


ROI dialog examples

Note that these examples are for Fortran arrays.  ROI dialogs for C arrays do not show a Lower Bound option.


Extra pane for HDF files

If you open an HDF file, an extra pane appears to the left of the Data View and Graph View panes.  The extra pane displays a file tree on which each "leaf" is an AGL file.  For more information, see HDF File Format.


Selecting in Data View

•	To select a cell or a region in Data View, hold down and drag the left mouse button in the cell or across the region.

•	To select an entire row or column, hold down and drag the left mouse button in the index cell of the row or column.

•	To select the entire array, hold down and drag the left mouse button in the top left corner of the index area.


Data loaded from other sources

For example, data can be loaded by copying and pasting from Microsoft Excel™ or a text file containing numeric data.


If you only see one large window

When you first install Array Viewer, you may see a large white window beneath the toolbar.  If so, drag down the top of the white window so you have two panes in the window.  Or, choose Split from the View menu.  Adjust the top and bottom pane sizes as needed by dragging the pointer.

Note that when you exit from Array Visualizer, your current settings will be saved.


Demonstrations
To see the demonstrations

In Compaq Array Visualizer Help, see "Using Array Viewer" in Getting Started.


Closes this dialog and saves any changes you have made.


Closes this dialog without saving any changes you have made.


Shows grid lines on surface graphs.


Shows only lines that are not "behind" a closer part of the graph.


Each section of a surface graph, as determined by its corner points, displays uniformly in one color.


Eliminates "jaggies" in lines.


Displays the three axes and their labels, tick marks and their associated values, and the background planes of the viewing region.


Click this button to activate your selections.


Shows graphs using the color palette.


Increases the precision of the interpolation that takes place on surface graphs when Flat Shading is unchecked.


The z-axis can be constrained (using the Settings Axis dialog) to a range that does not include all values in the ROI. When this occurs, points with values outside the z-axis range display as if their values are equal to the maximum or minumum, depending upon whether their values are actually above or below the maximum or the minimum, respectively.


Shows highlights from the reflection of a virtual light source that seems to be above and to the right of the person facing the screen.


Displays the data in the ROI with lines connecting points whose values in the data array are adjacent.


Displays the graph as a fully-filled-in surface.


Displays the graph as an array of bars, one bar for each data value in the ROI.


Displays the data in the ROI as a collection of lines, one for each data column.


Displays only the points corresponding to the data values in the ROI.


Sets the distance between grid lines on surface plots. Move slider left for low density and right for high density.


Enhances depth perception by emulating a foggy environment. Distant parts of the graph are harder to see.


Specifies one of the five graph styles to be used when displaying height plot graphs.


The starting index value for this dimension.


The starting index value for this dimension.


The starting index value for this dimension.


The starting index value for this dimension.


The starting index value for this dimension.


The starting index value for this dimension.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


The starting index value for this dimension.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


The number of consecutive indexes to be used for this dimension in the definition of your region of interest.


The number of consecutive indexes to be used for this dimension in the definition of your region of interest.


The number of consecutive indexes to be used for this dimension in the definition of your region of interest.


The number of consecutive indexes to be used for this dimension in the definition of your region of interest.


The number of consecutive indexes to be used for this dimension in the definition of your region of interest.


The number of consecutive indexes to be used for this dimension in the definition of your region of interest.


The number of consecutive indexes to be used for this dimension in the definition of your region of interest.


Select this to specify this dimension as the one whose values display in the data view as rows.


Select this to specify this dimension as the one whose values display in the data view as rows.


Select this to specify this dimension as the one whose values display in the data view as rows.


Select this to specify this dimension as the one whose values display in the data view as rows.


Select this to specify this dimension as the one whose values display in the data view as rows.


Select this to specify this dimension as the one whose values display in the data view as rows.


Select this to specify this dimension as the one whose values display in the data view as rows.


Select this to specify this dimension as the one whose values display in the data view as columns.


Select this to specify this dimension as the one whose values display in the data view as columns.


Select this to specify this dimension as the one whose values display in the data view as columns.


Select this to specify this dimension as the one whose values display in the data view as columns.


Select this to specify this dimension as the one whose values display in the data view as columns.


Select this to specify this dimension as the one whose values display in the data view as columns.


Select this to specify this dimension as the one whose values display in the data view as columns.


The smallest index to be allowed for this dimension in the definition of your region of interest.


The smallest index to be allowed for this dimension in the definition of your region of interest.


The smallest index to be allowed for this dimension in the definition of your region of interest.


The smallest index to be allowed for this dimension in the definition of your region of interest.


The smallest index to be allowed for this dimension in the definition of your region of interest.


The smallest index to be allowed for this dimension in the definition of your region of interest.


The smallest index to be allowed for this dimension in the definition of your region of interest.


The value to be associated with the origin of the x-axis. (Not used when check box above is enabled.)


The value to be associated with the origin of the y-axis. (Not used when check box above is enabled.)


The value to be associated with the origin of the z-axis. (Not used when check box above is enabled.)


The length (number of consecutive index values) for the dimension if the corresponding Lower Bound value is 1.  Otherwise, the range of index values for the dimension displays explicitly in the form startindex:endindex.


Select exactly one of the Row dimensions. That dimension becomes the one whose values display in the data view as rows.


The numbers of the dimensions in your data set.


Select exactly one of the Col dimensions. That dimension becomes the one whose values display in the data view as columns.


The starting index values for the dimensions in your data set.


The numbers of consecutive indexes to be used for the dimensions in your region of interest.


Moving the slider to the right stretches the z-axis, and moving it to the left compresses the z-axis.


The current z-scale value, on a scale from 0.0 (graph is completely flat and monochrome) to 1.0 (graph is tall). If the graph has a lot of ups and downs, try using a lower z-scale value.


Moving the slider to the right stretches the z-axis, and moving it to the left compresses the z-axis.


Array Viewer automatically associates the lowest color on the color palette with the smallest value in the ROI. Likewise, it associates the highest color on the color palette with the largest value in the ROI.


Determines the data value to be associated with the lowest color on the color palette. Any data values smaller than this number are colored with the lowest color on the color palette.


Determines the data value to be associated with the highest color on the color palette. Any data values larger than this number are colored with the highest color on the color palette.


Determines the data value to be associated with the lowest color on the color palette. Any data values smaller than this number are colored with the lowest color on the color palette.


Determines the data value to be associated with the highest color on the color palette. Any data values larger than this number are colored with the highest color on the color palette.


The value to be associated with the bottom of the z-axis.  (Not enabled when check box above is enabled.)


The value to be associated with the top of the z-axis.  (Not enabled when check box above is enabled.)


The value to be associated with the bottom of the z-axis.  (Not enabled when check box above is enabled.)


The value to be associated with the top of the z-axis.  (Not enabled when check box above is enabled.)


Array Viewer uses the minimum and maximum data values in the ROI as the values for the axis origin and axis end points, respectively.


The value to be associated with the top of the z-axis. (Not used when check box above is enabled.)


The value to be associated with the outer end of the x-axis. (Not used when check box above is enabled.)


The value to be associated with the outer end of the y-axis. (Not used when check box above is enabled.)


The value to be associated with the origin of the x-axis.  (Not used when check box above is enabled.)


The value to be associated with the outer end of the x-axis.  (Not used when check box above is enabled.)


The value to be associated with the origin of the y-axis.  (Not used when check box above is enabled.)


The value to be associated with the outer end of the y-axis.  (Not used when check box above is enabled.)


The value to be associated with the origin of the z-axis.  (Not used when check box above is enabled.)


The value to be associated with the top of the z-axis.  (Not used when check box above is enabled.)


The number of the dimension in the data set that is to be used as the source of x-axis values.


The number of the dimension in the data set that is to be used as the source of y-axis values.


The number of the dimension in the data set that is to be used as the source of z-axis values.


The number of the dimension in the data set that is to be used as the source of color values.


The number of the dimension in the data set that is to be used as the source of x-axis values.


The number of the dimension in the data set that is to be used as the source of y-axis values.


The number of the dimension in the data set that is to be used as the source of z-axis values.


The number of the dimension in the data set that is to be used as the source of color values.


The ratio of x-axis length to y-axis length is preserved during Swap XY operations.


When enabled, smooths the colors in the graph by blending them with the colors of neighboring points.  When disabled, coloring is dictated entirely by the color palette.


Rotates the image view about its horizontal midline, by 180 degrees.


Rotates the image view about its vertical midline, by 180 degrees.


Rotates the image view about the line that contains the lower-left and upper-right corners of the image view.


The smallest indexes to be allowed for the dimensions in the definition of your region of interest.


These choices let you control the orientation of the image map.


These choices let you control the manner in which the plane view graph displays.


These choices let you control the manner in which the vector plot graph displays.


The length (number of consecutive index values) for the dimension if the corresponding Lower Bound value is 1.  Otherwise, the range of index values for the dimension displays explicitly in the form startindex:endindex.


The length (number of consecutive index values) for the dimension if the corresponding Lower Bound value is 1.  Otherwise, the range of index values for the dimension displays explicitly in the form startindex:endindex.


The length (number of consecutive index values) for the dimension if the corresponding Lower Bound value is 1.  Otherwise, the range of index values for the dimension displays explicitly in the form startindex:endindex.


The length (number of consecutive index values) for the dimension if the corresponding Lower Bound value is 1.  Otherwise, the range of index values for the dimension displays explicitly in the form startindex:endindex.


The length (number of consecutive index values) for the dimension if the corresponding Lower Bound value is 1.  Otherwise, the range of index values for the dimension displays explicitly in the form startindex:endindex.


The length (number of consecutive index values) for the dimension if the corresponding Lower Bound value is 1.  Otherwise, the range of index values for the dimension displays explicitly in the form startindex:endindex.


The length (number of consecutive index values) for the dimension if the corresponding Lower Bound value is 1.  Otherwise, the range of index values for the dimension displays explicitly in the form startindex:endindex.


The number of one of the dimensions in your data set.


The number of one of the dimensions in your data set.


The number of one of the dimensions in your data set.


The number of one of the dimensions in your data set.


The number of one of the dimensions in your data set.


The number of one of the dimensions in your data set.


The number of one of the dimensions in your data set.


Lets you change the color of the background in the graph view.


Lets you change the color of all visible faces of the display portion in the graph view.


Lets you change the color of all visible edges, including tick marks, of the display in the graph view.


Lets you change the color of cursors (markers) in the graph view.


Lets you change the color of surface graphs when Use Palette is turned off.


Lets you change the color of grid lines on graphs that have them.


Lets you change the color of all labels used in the graph view.


Refreshes data when Array Viewer is used with another application to display data dynamically.


Presents the data for the current data set in spreadsheet form.


Presents the data for the current data set in graph form.


A toggle for displaying or hiding the tree view pane when Array Viewer contains .HDF files.


Returns the viewer perspective to the one saved as the home perspective.


Opens the Custom Palette dialog


Maps the data to the gray-scale spectrum, with the smallest value in the data set mapping to black and the largest mapping to white.


Like Gray Scale, except that the visual effect is a collection of alternating light and dark rings, with the rings getting lighter overall as the values increase. The number of rings is typically between 20 and 30.


Like Gray Scale, except that the smallest value maps to white and the largest value maps to black.


Maps a segment of the color spectrum to the data, with the smallest value mapping to dark blue and the largest value mapping to red.


Like Rainbow, except that the visual effect is a collection of colored rings, each displaying a part of the color spectrum, with the rings stepping from the blue part of the spectrum to the red part, as the values increase. The number of rings is typically between 20 and 30.


Like Rainbow, except that the smallest value maps to red and the largest to dark blue.


Opens the Palette Range dialog.


Makes the current viewer perspective the default for the current Array Viewer session.


Opens the Graph Settings dialog for the graph type currently being displayed.


Opens the Axis Range dialog for setting the beginning and ending values for each data axis.


Opens the ROI dialog for the graph type currently being displayed


Opens the Scale dialog for expanding or contracting the z-axis.


A toggle for showing or hiding the marker (cursor).


A toggle for showing or hiding the color palette in the graph view.


A toggle for showing or hiding the status bar.


Changes the display type to plane view.


A toggle for showing or hiding the data view.


A toggle for showing or hiding the HDF tree view pane.


Changes the display type to height plot.


Changes the display type to image map.


Changes the display type to vector graph.


Zooms the view in by one step.


Zooms the view out by one step.


Copies the currently-selected data to the clipboard.


Transforms the mouse cursor into the “What’s This?” cursor.


Replaces all currently-selected data with the default fill value.


Opens the Annotation dialog, where you can write messages to be saved with the file or read such messages.


Prepares Array Viewer to receive data for a new data set.


Displays the Open dialog, where you can select a .AGL or .HDF file to load into Array Viewer.


Saves the current file under its current name.


Displays brief information about Array Viewer.


Copies any data on the clipboard over the currently-selected portion of the data array.


Printing is not enabled in this version.


Opens the Options dialog.


Displays or hides the tree view pane when .HDF files are residing in Array Viewer.


Select the checkbox to Enable OpenGL Hardware Acceleration in Array Viewer and Avis2D ActiveX control (if supported by the graphics adapter).  Deselect the checkbox to force Software Rendering.


Restores the attribute settings that are stored in the file to the Array Viewer environment.


When this box is checked, saving an .AGL file saves the currently-specified attributes along with the file.


The number used to replace values that are cut from the data view.


The number used to replace values that are cut from the data view.


Restores the default settings to the values used when the program was first installed.


Saves all current settings for the Array Viewer application that are not file-dependent. These settings become the new operative default settings until you change them, either by saving new settings or by clicking on the Restore Original button.


Displays, from left to right

1.	1.	Helpful hint

2.	2.	Array declaration of the current array

3.	3.	Coordinates and value of the current data point


An edit box where you can write and read annotations.


Uses a default format to display the data in the grid.  If you choose to use the default format, you can not select the Exp Form, Hex Form, or to change the precision or the field width for the display.


Uses the scientific notation to display floating-point numbers.


Displays integer values as hexadecimal numbers.


Shows dimension labels in the grid display.


Enables cell editing.  You can then double-click on a cell and edit its value.


The number of digits to the right of the decimal point to be displayed for floating point data.


The width allocated to display each data value.  If the required field width of a data value exceeds the specified field width, the data value is displayed as a string of stars.


Use the arrows to select your preferred value.


Use the arrows to select your preferred value.


Opens the Palette Editor dialog.


The colored rectangle near the top left of the dialog is the palette to be edited.  The rectangle near the center of the dialog is a drawing region for the color components.  You can use one of two ways to edit the palette - draw in the drawing region, or use the color in the color square to replace one or more palette entries.


Displays the value of the array data element which is mapped to the palette entry at the slider position.


The color square shows the color of the palette entry at the slider position.


 Replaces the color of the palette entry at the slider position with the color shown in the color square.


The slider points to an entry in the palette.  You can control the slider using the mouse, PageUp, PageDown, Home, End, or the arrow keys.


Choose this color component to draw in the drawing region.  You can draw by holding down the left mouse button and move the mouse within the drawing region.


Choose this color component to draw in the drawing region.  You can draw by holding down the left mouse button and move the mouse within the drawing region.


Choose this color component to draw in the drawing region.  You can draw by holding down the left mouse button and move the mouse within the drawing region.


Choose Point drawing style when you draw a component in the drawing region.


Choose Line drawing style when you draw a component in the drawing region.


Choose Curve drawing style when you draw a component in the drawing region.


Shows this component in the drawing region.


Shows this component in the drawing region.


Shows this component in the drawing region.


Selects the color currently displayed in the color square.  You can also select a color by clicking on the color square to use a color-selection dialog.


Uses the Red-Green-Blue color model for drawing components.


Uses the Hue-Saturation-Value color model for drawing components.


Shifts the ROI to the right


Shifts the ROI to the left


Shifts the ROI downward


Shifts the ROI upward


Moves the current array "slice" forward by incrementing the index value of the third array dimension


Moves the current array "slice" forward repeatedly, by increasing index values along the third array dimension. This movement stops when the end of the array is reached (if auto-reverse is not enabled) or the stop button is pressed


Stops any animation that was initiated by Play Forward or Play reverse


Moves the current array "slice" backward by decrementing the index value of the third array dimension


Moves the current array "slice" backward repeatedly, by decreasing index values along the third array dimension. This movement stops when the beginning of the array is reached (if auto-reverse is not enabled) or the stop button is pressed


Displays or hides the Standard toolbar


Displays or hides the Graph toolbar


Displays or hides the ROI2D toolbar


Displays or hides the ROI3D toolbar


If this feature is enabled, selecting Play Reverse or Play Forward results in the current ROI array "slice" changing continuously until the Stop button is pressed or a new file is loaded


Dimension 1


Dimension 2


Dimension 3


Dimension 4


Dimension 5


Dimension 6


Dimension 7


The extent of dimension 1


The extent of dimension 2


The extent of dimension 3


The extent of dimension 4


The extent of dimension 5


The extent of dimension 6


The extent of dimension 7


The name associated with dimension 1


The name associated with dimension 2


The name associated with dimension


The name associated with dimension 4


The name associated with dimension  5


The name associated with dimension 6


The name associated with dimension 7


Copy axis scale data from the clipboard for dimension 1


Copy axis scale data from the clipboard for dimension 2


Copy axis scale data from the clipboard for dimension 3


Copy axis scale data from the clipboard for dimension 4


Copy axis scale data from the clipboard for dimension 5


Copy axis scale data from the clipboard for dimension 6


Copy axis scale data from the clipboard for dimension 7


Displays or hides the axis


If enabled, test will scale as the size of the Graph View window changes.  If disabled the text size will remain fixed


If enabled, the number of major and minor tickmarks will be set automatically.  If disabled, the  number of tickmarks can be set explicitly


The name to be displayed along the X-axis (if use Dim Name is not checked)


The name to be displayed along the Y-axis (if use Dim Name is not checked)


The name to be displayed along the Z-axis (if use Dim Name is not checked)


If enabled, the dimension name rather than the axis name will be displayed


If enabled, the dimension name rather than the axis name will be displayed


If enabled, the dimension name rather than the axis name will be displayed


Use pulldown menu to select from several different axis types


Use to select the number of large tickmarks to be displayed along the X-axis


Use to select the number of large tickmarks to be displayed along the Y-axis


Use to select the number of large tickmarks to be displayed along the Z-axis


Use to select the number of small tickmarks to be displayed along the X-axis


Use to select the number of small tickmarks to be displayed along the Y-axis


Use to select the number of small tickmarks to be displayed along the Z-axis


Type the URL of the Internet file you want to open.  For example: www.digital.com/Fortran/Aview/sinewave.agl and then select OK.


Check the Enable box if you would like clicking on the Graph or Data Views to bring up the Property Pages for the Avis2D and AvisGrid ActiveX controls used by the Graph and Data View windows.  These property pages enables some additional properties to be set that aren’t available from Settings dialogs, such as Line and Point size in the Graph View.  However if you later use File|Save to create or modify an AGL file, the changes made via the property pages won’t be reflected in that file.