TotalView Users Guide - CI Wiki

Visualizing Array Data
quickly see the result. You can even use this technique to display several
arrays simultaneously.
Launching the Visualizer from the Command Line
To start the Visualizer from the shell, use the following syntax:
visualize [ –file filename | –persist ]
where:
–file filename Reads data from filename instead of reading from standard
input. For information on crating this file, see “Setting
the Visualizer Launch Command” on page 194.
–persist Continues to run after encountering an EOF (End-of-
File) on standard input. If you don’t use this option, the
Visualizer exits as soon as it reads all of the data.
By default, the Visualizer reads its datasets from standard input and exits
when it reads an EOF. When started by TotalView, the Visualizer reads its
data from a pipe, ensuring that the Visualizer exits when TotalView does. If
you want the Visualizer to continue to run after it exhausts all input, invoke
it by using the –persist option.
If you want to read data from a file, invoke the Visualizer with the –file
option:
visualize –file my_data_set_file
The Visualizer reads all the datasets in the file. This means that the images
you see represent the last versions of the datasets in the file.
The Visualizer supports the generic X toolkit command-line options. For
example, you can start the Visualizer with the Directory Window minimized
by using the –iconic option. Your system manual page for the X server or
the X Window System User’s Guide by O’Reilly & Associates lists the generic X
command-line options in detail.
You can also customize the Visualizer by setting X resources in your
resource files or on the command line with the –xrm resource_setting
option. Using X resources to modify the default behavior of TotalView or
the Visualizer is described in greater detail on our Web site at http://
www.totalviewtech.com/Documentation/xresources/XResources.pdf.
Configuring TotalView to Launch the Visualizer
TotalView launches the Visualizer when you select the Tools > Visualize
command from the Variable Window. It also launches it if or when you use a
$visualize function in an eval point and the Tools > Evaluate Dialog Box.
TotalView lets you set a preference that disables visualization. This lets you
turn off visualization when your program executes code that contains eval
points, without having to individually disable all the eval points.
TotalView Users Guide: version 8.7 193