Click on the dotted line at the top of a menu to "tear it off": a separate window containing the menu is created.
| New Profile Browser | Create a new browser window with the same file as the one opened in the current window. |
|---|---|
| Open Profile | Open a profile data file in the current window. Data files can be created withStat.dump. |
| Close Window | Close the current window (exits from Tk if it was the last browser window). |
| Clear Cache |
Clear the sample cache, releasing its memory. The cache will
be automatically filled again when needed.
This command is a kind of temporary / experimental feature. I think
the cache handling should be made automatic and less memory consuming. |
| Show Control Panel | Show the control panel pane. |
|---|---|
| Show Graph | Show the graph pane. |
| Show Table | Show the table pane. |
| Bars / Lines | Choose whether the graph should be displayed using bars or lines.
When using bars, the sample value (size or count) for different kinds of
objects will be stacked on top of each other so the total
height represents the total value of a sample. When using
lines, each line represents the value for a single kind of object.
The 10 largest values are shown in each sample point. Each kind
has a particular color, choosen arbitrary but it is always the same
color for the same kind.
The remaing kinds, if any, are shown in black. |
|---|---|
| Size / Count |
Choose whether the graph should display the size of objects
of a particular kind or the number of objects of that kind.
(Note that this affects only the graph, the table will still choose size or
kind as it were choosen in the table menu.) |
| A / B | Use the sample at the A or B marker in the graph.
The kinds of objects shown in the table under this column
are taken from the 10 largest sample values at that point, in the same
order as they are shown in the graph. The ordering in the graph
depends on the choice of count or size in the graph menu. However,
the table may show count or size independent from the choice in the
graph. |
|---|---|
| Size / Count | Show the size or count of the kinds of objects in each row, taken from those choosen in the A / B column. |
| %A:Tot / %B:Tot | Show percentage of the Size / Count column, relative to the total (size or count) at either the A or B sample point. |
|
Cumul /
A-B / B-A |
Show either a cumulative sum of the Size / Count
column, or the difference A-B or B-A.
The cumulative sum is taken by summing from the first table
row down to the last row. |
| %A:Tot / %B:Tot | Show percentage of the previous field, relative to either the A or B total. |
| Kind | Shows the kind of objects. This is currently the only alternative for this column. The kind shown corresponds to the color shown in the A / B column. A special kind is <Other> which summarizes the remaining data if there were more than 10 different kinds in the sample. |
| Auto / On / Off | Choose a scrollbar mode. The usual setting is Auto which shows the scrollbar only when needed. |
|---|
| About | Version, author, email, copyright. |
|---|---|
| Help | Open this help window. |
There are 3 panes in the main window shown by default. At the top is the Control Panel, at the bottom left the Graph and at the bottom right the Table.
This contains controls for the graph and the markers. It also has a quick-exit button and a collect button.
| X / Y Button | Brings up a menu, currently containing some buttons that can also be accessed directly in the panel. |
|---|---|
| Grid button | Select if the graph should show grid lines. |
| Range buttons
- / + |
Change the range that is shown in the displayed portion of the graph. For each time + or - is pressed the range will be stepped up or down in the sequence (1, 2, 5) and multiples thereoff. |
| Range field | The current range is shown here, and a new range can be entered by writing to this field and pressing Enter. The format is an integer that may be followed by a multiplier, K, M, G, or T, meaning that the value is multipled by 1000, 1E6, 1E9, or 1E12 respectively. The maximum range is 1T. |
| - / + | Step the marker one step to the left (-) or to the right (+).
The table will be updated to show new data if it was set to show
such data that were dependent on the marker moved.
The graph will show the new marker position. If the marker was outside
of the displayed portion of the graph, the graph will scroll so the
marker becomes visible. |
|---|---|
| Track button |
Press to set the marker to the last sample in the file and stay at the
end as new samples are added. (New samples are periodically read from
the end of the file when auto-collect is selected via the Collect
button.)
Tracking is turned off when the marker is manually moved. |
How to move the markers is hopefully quite self evident when tried out but I wrote up some details about it anyway.
Holding down the mouse button and moving the mouse moves the underlying marker. Klicking the mouse button over a marker without moving the mouse, selects the marker. While it is selected any movement of the mouse within the graph will move the marker with it. Klicking again anywhere in the graph will deselect the marker. If the marker can be moved, the cursor will be an arrow indicating the direction it can be moved, left or right or both. If the marker can not be moved in any direction, the cursor will show a circle or disc. The marker can not move outside the available samples. Moving the mouse outside of the graph also restricts the movement of the mouse, even if the mouse button is pressed. This is intentional so that the marker can be moved longer distances than the mouse can move. Moving the mouse to the right of the graph, the marker can only be moved to the right - moving back the mouse will not move the marker back until the mouse enters the graph area again. Similarly for the left side. Above or below the graph, the mouse will not move the marker at all but will show a circle to indicate that the mouse may be 'recirculated' to move back into the graph.