irsim-analyzer man page

irsim-analyzer

Synopsis

analyzer node...

Description

The analyzer provides a graphical interface to irsim; displaying the state of the nodes (or vectors) node...

Every invocation of the analyzer command adds a new set of signals to the display list.

The view is split into 3 regions: a trace window, a text window, and a banner. The banner displays the name of the simulation (from the sim file), and the pull-down menu headers. The text window is a 1-line window used to request and display certain information.

The trace window displays the following information:

left side:
names of the signals (nodes/vectors) displayed.
top side:
On the left and right sides, the time corresponding to the left and right edges of the trace window. In the center, the time of the current cursor position.
right side:
Values of the signals under the cursor.

Mouse Functions

The analyzer provides various functions depending on where in the window a mouse button is depressed. All buttons have the same meaning, except inside the scrollbar. Pressing a mouse button in the following regions will provide:

Signal names:
The signal name where the button was depressed will be highlighted and will be moved to the position where the button is released, scrolling the other traces if necessary. If the button is released under the same signal on which it was pressed, that signal will become selected. The selected signal is always underlined, and some information regarding that signal is printed in the text window.

If the button is released outside the traces area (above or below) the signal will be removed from the display. It can only be added again by invoking the analyzer command.
Left Arrow:
The traces are scrolled left by half a page (move back in time).
Right Arrow:
The traces are scrolled right by half a page (move forward in time).
Double Left Arrow:
Scrolls traces left by a full page.
Double Right Arrow:
Scrolls traces right by a full page.
Scrollbar:
The left button allows to stretch the left side of the window, thereby zooming in/out by an arbitrary amount. The right side of the window remains the same.

The right button allows to stretch the right side of the window, thereby zooming in/out by an arbitrary amount. The left side of the window remains the same.

The middle button moves the whole view back and forth in time. The magnification factor remains the same.
Traces
The cursor is moved to the time-step where the mouse is clicked. Some lack of accuracy in selecting the time may become apparent due to screen resolution round off.

Holding down the shift key simultaneously with the mouse button will not move the cursor, but rather show the value of the signal at the time-step where the mouse is clicked. The value is printed in the text window using the following format:

name @ time:value=value,input=status

The value is always shown in binary, regardless of the base selected for that signal. The status is a string showing which nodes where inputs at that time. Nodes that were inputs have an i in their respective position, otherwise an -.
Cursor Values:

The selected signal value is highlighted and, when the button is released, the value of the signal is expanded in the text window. This is useful for displaying each of the bits that make up a vector. The information printed has the following format:

name:value=value input=status

where value and status have the same meaning as above.
Banner:
Clicking on the banner brings the window to the foreground.
Box on Banner:
Clicking in the little box on the left side of the banner iconizes the analyzer window. To de-iconize the window, simply click any button within the icon.
Banner Menus:
Pressing a mouse button in one of the banner menus (on the right side) will pull down the corresponding menu.

X Defaults

The analyzer application uses the appropriate resource specification at startup time to customize the appearance of its window. The format for a resource specification in the .Xdefaults file is:

[name.]resource: value

For the analyzer, the available names are irsim and analyzer. The available resources are:

background
Specifies the traces window background color. The default is black.
foreground
Specifies the text color, or the background of everything else besides the traces window. The default is white.
geometry
Specifies the default geometry (window size and screen location) of the graphic window. The default Xgeometry is "=1000x300+0+0".
reverseVideo
Specifies whether the foreground and background colors are to be reversed (on monochrome displays only). The default is off.
font
Specifies the fixed-width font displayed. The default is 6x13.
borderWidth
Specifies the width of the border (in pixels). The default is 2.
borderColor
Specifies the border color when the window is selected. The default is black.
highlight
Specifies the color used for highlighting. The default is red (color displays only).
traceColor
Specifies the color in which the traces are drawn. The default is white.
bannerBg
Specifies the background color for the banner. The default is white.
bannerFg
Specifies the foreground (text) color for the banner. The default is black.

See Also

irsim(1)

Referenced By

irsim(1).

IRSIM USER'S MANUAL