1irsim-analyzer(3)             IRSIM USER'S MANUAL            irsim-analyzer(3)
2
3
4

NAME

6       irsim-analyzer
7

SYNOPSIS

9       analyzer node...
10

DESCRIPTION

12       The  analyzer  provides  a graphical interface to irsim; displaying the
13       state of the nodes (or vectors) node...
14
15       Every invocation of the analyzer command adds a new set of  signals  to
16       the display list.
17
18       The  view is split into 3 regions: a trace window, a text window, and a
19       banner.  The banner displays the name of the simulation (from  the  sim
20       file),  and  the  pull-down  menu headers.  The text window is a 1-line
21       window used to request and display certain information.
22
23       The trace window displays the following information:
24
25       left side:   names of the signals (nodes/vectors) displayed.
26
27       top side:    On the left and right sides, the time corresponding to the
28                    left  and right edges of the trace window.  In the center,
29                    the time of the current cursor position.
30
31       right side:  Values of the signals under the cursor.
32
33
35       zoom:
36                     in   Zooms in by a factor of 2 (magnify).
37
38                     out  Zooms out by a factor of 2 (reduce).
39
40       base:  Changes the numerical base used to  display  the  value  of  the
41              selected  vector (see below how to select a trace) to one of the
42              following:
43
44              bin  (base 2)
45
46              oct  (base 8)
47
48              hex  (base 16)
49
50       window:1
51
52              delta T     Allows to determine the difference (in time) between
53                          any  two edges.   First click the mouse (any button)
54                          to the right of the first edge, then to the left  of
55                          the  second edge.  The time of the two edges as well
56                          as their  difference  will  be  shown  in  the  text
57                          window.   As long as the button remains depressed, a
58                          line is shown between the two edges.  Times are  all
59                          shown in ns.
60
61              move to     Moves  the  left  edge  of  the  trace window to the
62                          specified time.  The time is requested in  the  text
63                          window.
64
65              set width   Sets  the number of ns. that will be displayed.  The
66                          time is requested in the text window.
67
68              name length Since the most important differentiating information
69                          in  a  long  signal  name is usually at the end, the
70                          analyzer will display the last 15  characters  of  a
71                          signal   name.   This  option  allows  changing  the
72                          maximum number of characters that will be displayed,
73                          which must be in the range [8-256].
74
75              scroll      Usually the analyzer displays simulation activity by
76                          scrolling the  traces  to  the  left,  so  the  last
77                          changes    are    shown.    The    scroll    feature
78                          enables/disables   this    scrolling,    effectively
79                          freezing  the  traces.  When scrolling is enabled, a
80                          check mark is shown on this menu entry.
81
82       print:  These options control  the  generation  of  a  PostScript  file
83               suitable for obtaining a hardcopy of the trace window.
84
85               file    Requests  the  filename  to hold the PostScript output.
86                       Hitting <return> will use the default  name  (shown  in
87                       parens).  Hitting <ctrl-C> will abort generation of the
88                       file.  The following menu entries control the aspect of
89                       the  PostScript file; a check mark in the corresponding
90                       menu entry implies that the feature will be included in
91                       the output.
92
93               banner  Generate  a  banner,  showing  the  simulation name and
94                       current date.
95
96               legend  Generate (in a separate  page)  a  description  of  the
97                       signals  displayed:  the complete names of nodes (since
98                       the first characters may be stripped), and for  vectors
99                       the names of the nodes of wich it is composed.
100
101               times   Generate a time ruler at the bottom of the traces.
102
103               outline Draw an outline around the trace window.
104

MOUSE FUNCTIONS

106       The  analyzer  provides  various  functions  depending  on where in the
107       window a mouse button is depressed.  All buttons have the same meaning,
108       except  inside the scrollbar.  Pressing a mouse button in the following
109       regions will provide:
110
111       Signal names:
112              The  signal  name  where  the  button  was  depressed  will   be
113              highlighted  and  will be moved to the position where the button
114              is released, scrolling the other traces if  necessary.   If  the
115              button  is  released  under  the  same  signal  on  which it was
116              pressed, that signal will become selected.  The selected  signal
117              is always underlined, and some information regarding that signal
118              is printed in the text window.
119
120              If the button is released outside  the  traces  area  (above  or
121              below) the signal will be removed from the display.  It can only
122              be added again by invoking the analyzer command.
123
124       Left Arrow:
125              The traces are scrolled left by half a page (move back in time).
126
127       Right Arrow:
128              The traces are scrolled right by half a page  (move  forward  in
129              time).
130
131       Double Left Arrow:
132              Scrolls traces left by a full page.
133
134       Double Right Arrow:
135              Scrolls traces right by a full page.
136
137       Scrollbar:
138              The  left  button allows to stretch the left side of the window,
139              thereby zooming in/out by an arbitrary amount.  The  right  side
140              of the window remains the same.
141
142              The right button allows to stretch the right side of the window,
143              thereby zooming in/out by an arbitrary amount.  The left side of
144              the window remains the same.
145
146              The  middle  button moves the whole view back and forth in time.
147              The magnification factor remains the same.
148
149       Traces
150              The cursor is moved to the time-step where the mouse is clicked.
151              Some  lack of accuracy in selecting the time may become apparent
152              due to screen resolution round off.
153
154              Holding down the shift key simultaneously with the mouse  button
155              will  not  move  the  cursor,  but  rather show the value of the
156              signal at the time-step where the mouse is clicked.   The  value
157              is printed in the text window using the following format:
158
159                 name @  time:value=value,input=status
160
161              The  value  is  always  shown  in binary, regardless of the base
162              selected for that signal.  The status is a string showing  which
163              nodes where inputs at that time.  Nodes that were inputs have an
164              i in their respective position, otherwise an -.
165
166       Cursor Values:
167              The selected signal value is highlighted and, when the button is
168              released,  the  value  of  the  signal  is  expanded in the text
169              window.  This is useful for displaying each  of  the  bits  that
170              make  up  a  vector.   The information printed has the following
171              format:
172
173                    name:value=value input=status
174
175              where value and status have the same meaning as above.
176
177       Banner:
178              Clicking on the banner brings the window to the foreground.
179
180       Box on Banner:
181              Clicking in the little box  on  the  left  side  of  the  banner
182              iconizes  the analyzer window.  To de-iconize the window, simply
183              click any button within the icon.
184
185       Banner Menus:
186              Pressing a mouse button in one of the banner menus (on the right
187              side) will pull down the corresponding menu.
188
189
190

X DEFAULTS

192       The analyzer application uses the appropriate resource specification at
193       startup time to customize the appearance of its window.  The format for
194       a resource specification in the .Xdefaults file is:
195
196                   [name.]resource:  value
197
198       For  the  analyzer,  the  available  names are irsim and analyzer.  The
199       available resources are:
200
201
202       background     Specifies  the  traces  window  background  color.   The
203                      default is black.
204
205       foreground     Specifies   the   text   color,  or  the  background  of
206                      everything else besides the traces window.  The  default
207                      is white.
208
209       geometry       Specifies  the  default geometry (window size and screen
210                      location) of the graphic window.  The default  Xgeometry
211                      is "=1000x300+0+0".
212
213       reverseVideo   Specifies  whether  the foreground and background colors
214                      are to be reversed (on monochrome displays  only).   The
215                      default is off.
216
217       font           Specifies  the  fixed-width font displayed.  The default
218                      is 6x13.
219
220       borderWidth    Specifies the width of  the  border  (in  pixels).   The
221                      default is 2.
222
223       borderColor    Specifies  the border color when the window is selected.
224                      The default is black.
225
226       highlight      Specifies the color used for highlighting.  The  default
227                      is red (color displays only).
228
229       traceColor     Specifies  the color in which the traces are drawn.  The
230                      default is white.
231
232       bannerBg       Specifies the background  color  for  the  banner.   The
233                      default is white.
234
235       bannerFg       Specifies  the  foreground  (text) color for the banner.
236                      The default is black.
237
238

SEE ALSO

240       irsim(1)
241
242
243
244                                                             irsim-analyzer(3)
Impressum