File: README

package info (click to toggle)
gwave 19990927-1
  • links: PTS
  • area: main
  • in suites: potato
  • size: 1,416 kB
  • ctags: 401
  • sloc: ansic: 3,973; sh: 334; makefile: 77
file content (98 lines) | stat: -rw-r--r-- 4,040 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

gwave - a  viewer for the output of spice-like simulators
and other viewing of analog data.

by:

Steve Tell 
Microelectronic Systems Laboratory
University of North Carolina at Chapel Hill
CB 3175 Sitterson Hall
Chapel Hill, NC 27599-3175
tell@cs.unc.edu

Installation:
	./configure   (see file INSTALL or run configure --help for more info)
	gmake
	test gwave on some files in the examples directory
	gmake install

Usage:
gwave [-t filetype] your-waveform-file

Gwave can read several file formats.  It attempts to guess file formats
based on filename, and then tries all file formats until one succedes.
These file formats are known:

CAzM transient output (*.[BNW])
HSPICE binary and ascii formats (*.tr0, *.sw0, *.ac0)
Spice2 and Spice3 "raw" output  (*.raw)
An ascii format with whitespace-seperated columns and column headings,
such as that produced by ACS (Al's circuit simulator). (*.acs, *.asc, *.ascii)

Use the View->Variable List menu to see a list of a list of signals in
your simulation files, then drag-and-drop signals into the desired waveform
panels.    Additional signals can be added to the same waveform panel
simply by double-clicking them.

To delete waves, select one or more of them using the buttons down the
left side of the main window, and then press the "delete" button.

Click on the waveform panels with the left and center mouse buttons to set two
cursors for measuring.  Hold down these mouse buttons to drag the cursors.

Pressing and holding the right mouse button while the cursor is in a
waveform panel pops up a menu.  From this menu you can insert
and delete waveform panels.  Some of the zoom commands are also
replicated on this menu.

The "Export Postscript" and "Export PNM" options on the main File menu
provide the rudiments of output for inclusion in other
documentation. They require the graph program from GNU Plotutils to be
installed and found in your $PATH at configure time, and simply write
out files called gwave_out.ps and gwave_out.pnm into the current
directory.  In the future, a dialog box will allow configuring the
print and export output.
For more info on GNU plotutils, see 
http://www.gnu.ai.mit.edu/software/plotutils/plotutils.html

Known problems: - HSPICE data files generated without ".options probe"
may not be read correctly. workaround: try using ".options probe".
This mostly happens with AC sweeps.  (I think this has been fixed -
feedback to the contrary is welcome)

Independent variables must be increasing in value.  This isn't a
problem for transient and AC analyses, but for DC sweeps it is
possible to make them go backwards.  Old versions of gwave would draw
bogus waveforms for these; Gwave 19990927 and later refuse to read
these files.

This tool is far from complete. Partial contents of the To Do list:

- Send feedback and error messages from loading of files to a popup window
  or status line instead of to stdout.
- Drag-and-drop to move waveform from one panel to another
- Logarithmic X and Y axes
- Speed up redraws and minimize flashing, especialy flashing 
  of waveform name/value labels when moving cursors.
- Override of wave and panel parameters, like min/max Y value, color, etc.
- Improved measurement functions.  
    ability to turn cursors on and off.
    horizontal cursor(s)  (1 or 2 per panel? where do their labels go?)
    snap cursor to nearest intersection of orthagonal cursor and wave
- Saving and restoring waveform/panel configuration 
- Drawing a labeled graticule in the waveform area
- Seperate lists for selecting voltage/current/etc. types of variables
- Clean up reader code by collecting some idioms that appear again and again
  into common subroutines.  This will make writing new readers a little easier.
- add an extension language for configuring the GUI and creating custom
    analysis commands.


Planned next: Starting on the extension language.  Future versions of
gwave will require guile (http://www.gnu.ai.mit.edu/software/guile/guile.html)
in order to build.



Feedback is welcome - tell@cs.unc.edu