.TH sw2asc 1 "September 25th, 2013" "gEDA Project" 1.8.2.20130925

.SH NAME
.B sw2asc
\- converts a SWITCAP2 output file into ASCII data files that other tools can read

.SH SYNOPSIS
.B sw2asc \-c\||\-\-copyright

.B sw2asc \-h\||\-\-help

.B sw2asc \-V\||\-\-version

.B sw2asc
.I switcap.out

.SH DESCRIPTION

The
.I sw2asc
program reads the switcap.out output file produced by SWITCAP2 and produces
a set of ASCII datafiles which can be more easily loaded into various waveform
plotting programs. 

Data generated by SWITCAP2 "PRINT" statements is;
extracted and written to an output file in an ASCII format which can be
directly loaded by the 
.I gwave
waveform viewer or more easily loaded into
a tool such as 
.I scilab
,
.I octave
,
.I grace,
, or 
.I matlab
.

If multiple analyses are in the SWITCAP2 output file, then they are written
to individual files.  The output file names are derived from the input
file name by appending ".{SSS,TRAN}.#.asc"" to the name of the input file.
SSS is used for Sinusoidal Steady State analysis output and TRAN is used for.
TRANsient analysis output.  # corresponds to the analysis number (ie if you
have 3 SSS analyses in your file, you will end up with .SSS.1.asc, .SSS.2.asc,
and .SSS.3.asc.

.SH OPTIONS
.TP
\-c, \-\-copyright
prints copyright information and exits
.TP
\-h, \-\-help
prints help message and exits
.TP
\-V, \-\-version
prints version information and exits

.SH EXIT STATUS
.I sw2asc
will return 0 on success and non-zero
if the command did not complete successfully.

.SH SEE ALSO
SWITCAP2 users manual