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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
.\" This -*- nroff -*- file has been generated from
.\" DocBook SGML with docbook-to-man on Debian GNU/Linux.
...\"
...\" transcript compatibility for postscript use.
...\"
...\" synopsis: .P! <file.ps>
...\"
.de P!
\\&.
.fl \" force out current output buffer
\\!%PB
\\!/showpage{}def
...\" the following is from Ken Flowers -- it prevents dictionary overflows
\\!/tempdict 200 dict def tempdict begin
.fl \" prolog
.sy cat \\$1\" bring in postscript file
...\" the following line matches the tempdict above
\\!end % tempdict %
\\!PE
\\!.
.sp \\$2u \" move below the image
..
.de pF
.ie ^G\\*(f1^G^G .ds f1 \\n(.f
.el .ie ^G\\*(f2^G^G .ds f2 \\n(.f
.el .ie ^G\\*(f3^G^G .ds f3 \\n(.f
.el .ie ^G\\*(f4^G^G .ds f4 \\n(.f
.el .tm ? font overflow
.ft \\$1
..
.de fP
.ie !^G\\*(f4^G^G \{\
. ft \\*(f4
. ds f4\"
' br \}
.el .ie !^G\\*(f3^G^G \{\
. ft \\*(f3
. ds f3\"
' br \}
.el .ie !^G\\*(f2^G^G \{\
. ft \\*(f2
. ds f2\"
' br \}
.el .ie !^G\\*(f1^G^G \{\
. ft \\*(f1
. ds f1\"
' br \}
.el .tm ? font underflow
..
.ds f1\"
.ds f2\"
.ds f3\"
.ds f4\"
'\" t
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n
.TH "sp2sp" "1"
.SH "NAME"
sp2sp \(em translate from one spice-type analog waveform file format to another
.iX "spice" "file"
.iX "waveform"
.SH "SYNOPSIS"
.PP
\fBsp2sp\fP [-c \fIoutput-format\fP] [-f \fIfieldnamelist\fP] [-n \fIfieldnumberlist\fP] [-t \fIinput-format\fP] [-v] \fIfilename\fP
.SH "Description"
.PP
\fBsp2sp\fPtranslates analog waveform data, such as that
produced by \fBspice\fP, from one format to another.
Several input and output formats are supported. In addition,
a subset of the variables in the input file can be selected to appear
in the output.
.PP
If no \fIfilename\fP is specified, \fBsp2sp\fP reads from the standard input.
Translated results are always sent to standard output.
.PP
\fBsp2sp\fP accepts the following options:
.IP "-c \fIoutput-format\fP" 10
Sets the format for the output file. Available formats include
ascii, nohead, and cazm.
.IP "-f \fIfieldnamelist\fP" 10
A list of field names, seperated by commas. Only the fields matching the specified
names are included in the output. Field names comparisons are case-insensitive.
If a field name does not match exactly, sp2sp also looks for the field name with "v("
prepended, to allow for the tendancy of \fBHSpice\fP to list voltages
this way in transient simulation output.
.IP "-n \fIfieldnumberlist\fP" 10
A list of field numbers, seperated by commas. The independent variable, for example
the time axis of a transient simulation, is field number zero.
.IP "-t \fIinput-format\fP" 10
Sets the expected format for input file or standard input. Input formats
supported include: cazm and hspice.
.IP "-v" 10
Turns on verbose mode to print detailed information about the input file.
.SH "FILE FORMATS SUPPORTED"
.PP
A number of file formats are supported by \fBsp2sp\fP,
with more to be added in the future. Note that some formats are
only supported for input or output; this asymetry should also be corrected
where possible.
.IP "ascii" 10
A simple tabular ascii format, with column headings. Note that files
in this format may have very long lines. Available for output only.
.IP "nohead" 10
Supported for output only, this format is similar to the
ascii format, except that there are no column headings.
This format is most useful for feeding into other unix
utilities, such as awk, for specialized postprocessing.
.IP "cazm" 10
This format, generated by the CAzM simulator, is accepted for
input and output. It is essentialy the same as "ascii" except for its header.
.IP "hspice" 10
The formats produced by \fBHSpice\fP, from
transient, sweep, and AC analyses are supprorted for input only.
Both the ascii and binary subformats are supported for reading and
are automaticly detected.
.SH "EXAMPLES"
.PP
.SH "BUGS"
.PP
For input file formats that support multiple sets of waveforms in the same file,
only the first one is recognized and translated.
...\" created by instant / docbook-to-man, Fri 01 Sep 2000, 00:10
|
