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
|
...\" $Header: /usr/src/docbook-to-man/cmd/RCS/docbook-to-man.sh,v 1.3 1996/06/17 03:36:49 fld Exp $
...\"
...\" 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 \\*(f1 .ds f1 \\n(.f
.el .ie \\*(f2 .ds f2 \\n(.f
.el .ie \\*(f3 .ds f3 \\n(.f
.el .ie \\*(f4 .ds f4 \\n(.f
.el .tm ? font overflow
.ft \\$1
..
.de fP
.ie !\\*(f4 \{\
. ft \\*(f4
. ds f4\"
' br \}
.el .ie !\\*(f3 \{\
. ft \\*(f3
. ds f3\"
' br \}
.el .ie !\\*(f2 \{\
. ft \\*(f2
. ds f2\"
' br \}
.el .ie !\\*(f1 \{\
. ft \\*(f1
. ds f1\"
' br \}
.el .tm ? font underflow
..
.ds f1\"
.ds f2\"
.ds f3\"
.ds f4\"
.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, Thu 10 Aug 2000, 00:00
|