TotalView Users Guide - CI Wiki

Examining and Analyzing Arrays
Filtering Array Data: The procedure for filtering an array is simple:
select the Filter field, enter the array filter expression, and then press Enter.
TotalView updates the Variable Window to exclude elements that do not
match the filter expression. TotalView only displays an element if its value
matches the filter expression and the slice operation.
If necessary, TotalView converts the array element before evaluating the filter
expression. The following conversion rules apply:
� If the filter operand or array element type is floating point, TotalView converts
the operand to a double-precision floating-point value. TotalView
truncates extended-precision values to double precision. Converting integer
or unsigned integer values to double-precision values might result in a
loss of precision. TotalView converts unsigned integer values to nonnegative
double-precision values.
� If the filter operand or the array element is an unsigned integer, TotalView
converts the operand to an unsigned 64-bit integer.
� If both the filter operand and array element are of type integer, TotalView
converts the values to type 64-bit integer.
TotalView conversion operations modify a copy of the array’s elements—
conversions never alter the actual array elements.
To stop filtering an array, delete the contents of the Filter field in the Variable
Window and press Enter. TotalView then updates the Variable Window
so that it includes all elements.
Filtering by Comparison
The simplest filters are ones whose formats are as follows:
operator value
where operator is either a C/C++ or Fortran-style comparison operator, and
value is a signed or unsigned integer constant or a floating-point number.
For example, the filter for displaying all values greater than 100 is:
> 100
The following table lists the comparison operators:
Comparison C/C++ Operator Fortran Operator
Equal == .eq.
Not equal != .ne.
Less than < .lt.
Less than or equal .gt.
Greater than or equal >= .ge.
The following figure shows an array whose filter is < 0. This tells TotalView
to only display array elements whose value is less than 0 (zero). See
Figure 214 on page 339.
338 Chapter 15: Examining Arrays