This is an old revision of the document!
Table of Contents
Oscopy User manual
<columns 100% 70% - > The user manual is available in the doc/ioscopy directory and also as PDF file.
Inside a Graph
- Toggle cursors: keys 1,2,3,4
- Right-click to popup menu with all available options for figure, graph, signals and more!
- Zoom/unzoom (experimental only): keys
zandZrespectively, or the mouse wheel
<newcolumn>
</columns>
Command description
Oscopy-specific commands are prefixed with the letter o.
In addition to these commands,
numpy.ufuncs and numpy.fft functions support operations with Signals.
| Command | Arguments | Description |
|---|---|---|
| oadd | SIG [, SIG [, SIG]…] | Add a graph to the current figure |
| ocontext | Return the Context object used within ioscopy. Use it only if you want to have direct access to internal ioscopy objects. | |
| ocreate | [SIG [, SIG [, SIG]…] ] | Create a new figure, set it as current, add the signals |
| odelete | GRAPH# | Delete a graph from the current figure |
| odestroy | FIG# | Destroy a figure |
| oexec | FILENAME | execute commands from file |
| ofactors | X, Y | set the scaling factor of the graph (in power of ten) use 'auto' for automatic scaling factor e.g. factor -3, 6 set the scale factor at 1e-3 and 10e6 |
| ofiglist | Print the list of figures | |
| ofreeze | SIG [, SIG [, SIG]…] | Do not consider signal for subsequent updates |
| ogui | Show the GUI | |
| oimport | SIG [, SIG [, SIG]…] | Import a list of signals into oscopy to handle dependencies during updates |
| oinsert | SIG [, SIG [, SIG]…] | Insert a list of signals into the current graph |
| olayout | horiz|vert|quad | Define the layout of the current figure |
| omode | MODE | Set the type of the current graph of the current figure |
| Available modes : | ||
| * lin Linear graph | ||
| orange | [x|y min max]|[xmin xmax ymin ymax] | Set the axis range of the current graph of the current figure |
| oread | DATAFILE | read signal file |
| orefresh | FIG#|on|off|current|all | Force/toggle autorefresh of current/#/all figures on update |
| oremove | SIG [, SIG [, SIG]…] | Delete a list of signals into from current graph |
| oscale | [lin|logx|logy|loglog] | Set the axis scale |
| oselect | FIG#-GRAPH# | Select the current figure and the current graph |
| osiglist | List loaded signals | |
| ounfreeze | SIG [, SIG [, SIG]…] | Consider signal for subsequent updates |
| ounit | [XUNIT,] YUNIT | Set the unit to be displayed on graph axis |
| oupdate | Reread data files | |
| owrite | format [(OPTIONS)] FILE SIG [, SIG [, SIG]…] | Write signals to file |
Windows description
The Graphical User Interface of oscopy is composed of several windows:
- The command line terminal
- The main window
- The (many) figures windows
Main Window
<columns 100% 80% → This is the first window that you will see when starting ioscopy. At anytime, it can be shown again by calling the command ogui from the terminal if closed.
It contains the list of Readers and their Signals currently handled by ioscopy. Double-clicking on a Signal insert it in a new Figure.
Each Signal 'freeze' status can be toggled using the checkbox located in the right column. Toggling the checkbox for a Reader set the status for all the signals contained in the Reader.
The 'File' menu:
| Option | Description |
|---|---|
| Add file(s)… | To read Signals from file(s) |
| Update | To read Signals from file(s) again |
| Execute script… | To read ioscopy commands from file |
| New Math Signal | To compute a new Signal from existing ones |
| Run netlister and simulate | To generate the netlist, run the simulator and eventually update the Signals |
| Quit | Exit ioscopy |
The 'Windows' menu contains the list of the windows, and select one to show it.
<newcolumn>
</columns>
Figure window
<columns 100% 70% →
Each Figure window is composed of two parts:
- On the top part, a zone containing up to 4 graphs
- On the bottom part, the Matplotlib toolbar
A contextual menu is available for each graph, raised by a right-click on the mouse button. Access to most of the ioscopy functionality is possible through this menu:
- Add/delete graph
- Layout
- Range settings
- Unit settings
- Scale
- Insert Signal
- Remove Signal
For each Graph, cursors are available through keys:
- '1' for first vertical cursor
- '2' for second vertical cursor
- '3' for first horizontal cursor
- '4' for second horizontal cursor
The value of each cursor is displayed on the bottom part of the graph, and the difference when both cursors are activated.
<newcolumn>
</columns>