NetNews Usenet Archive 1993 #3/NN_1993_3.iso/spool/alt/sources/3091

Text File | 1993-01-25 | 54.7 KB | 1,563 lines

Path: sparky!uunet!spool.mu.edu!nigel.msen.com!hela.iti.org!cs.widener.edu!dsinc!ub!galileo.cc.rochester.edu!ee.rochester.edu!rbc!al
From: [e-mail] (Al Davis)
Newsgroups: alt.sources
Subject: ACS  circuit simulator  part 06/20
Message-ID: <[e-mail]>
Date: 25 Jan 93 05:22:09 GMT
Sender: [e-mail] (Al Davis)
Organization: Huh?
Lines: 1552

#! /bin/sh
# This is a shell archive, meaning:
# 1. Remove everything above the #! /bin/sh line.
# 2. Save the resulting text in a file.
# 3. Execute the file with /bin/sh (not csh) to create the files:
#    man/Commands/ac.tex
#    man/Commands/alter.tex
#    man/Commands/build.tex
#    man/Commands/chdir.tex
#    man/Commands/clear.tex
#    man/Commands/dc.tex
#    man/Commands/delete.tex
#    man/Commands/disto.tex
#    man/Commands/edit.tex
#    man/Commands/end.tex
#    man/Commands/exit.tex
#    man/Commands/fault.tex
#    man/Commands/fourier.tex
#    man/Commands/generato.tex
#    man/Commands/get.tex
#    man/Commands/help.tex
#    man/Commands/ic.tex
#    man/Commands/insert.tex
#    man/Commands/list.tex
#    man/Commands/log.tex
#    man/Commands/mark.tex
#    man/Commands/merge.tex
#    man/Commands/modify.tex
# This archive created: Mon Jan 25 00:17:43 1993
export PATH; PATH=/bin:$PATH
if test -f 'man/Commands/ac.tex'
then
    echo shar: will not over-write existing file "'man/Commands/ac.tex'"
else
cat << \SHAR_EOF > 'man/Commands/ac.tex'
% ac  12/29/92
% man commands ac .
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt AC} command}
\index{AC command}
\index{sine wave analysis}
\index{frequency response}
\index{small signal ac analysis}
%------------------------------------------------------------------------
\subsection{Syntax}
\begin{verse}
{\tt AC} \{{\it options} ...\} {\it start stop stepsize} \{{\it options} ...\}
\end{verse}
%------------------------------------------------------------------------
\subsection{Purpose}

Performs a small signal, steady state, AC analysis.  Sweeps frequency.
%------------------------------------------------------------------------
\subsection{Comments}

Data available are: node voltages, level in dB, phase in degrees, phase delay
in seconds.

The nodes to look at must have been previously selected by the {\tt Print} or
{\tt Plot} command.

\index{nonlinear AC analysis}
It does a linear analysis about an operating point.  {\em It is absolutely
necessary to do an {\tt OP} analysis first on any nonlinear circuit.  Not
doing this is the equivalent of testing it with the power off.}

Three parameters are normally needed for an AC analysis: start frequency,
stop frequency and step size, in this order.  If all of these are omitted,
the values from the most recent AC analysis are used.

If only one frequency is specified, a single point analysis will be done.

If only a new step size is specified, the old start and stop are kept and
only the step size is changed.  This is indicated by a keyword: {\tt By},
{\tt Times}, {\tt Decade} or {\tt Octave}, or a symbol: {\tt +} or {\tt
*}.

If the start frequency is zero, the program will still do an AC analysis.
The actual frequency can be considered to be the limit as the frequency
approaches zero.  It is, therefore, still possible to have a non-zero
phase angle, but delays are not shown because they may be infinite.

The default extension for all files in the {\tt AC} command is {\tt .ac}.
%------------------------------------------------------------------------
\subsection{Options}

\begin{description}

\item[{\tt +} {\it stepsize}] Linear sweep.  Add {\it
stepsize} to get the next step.  Same as {\tt By}.

\item[{\tt *} {\it multiplier}] Log sweep.  Multiply by
{\it multiplier} to get the next step.

%%%\item[{\tt <} {\it file}] Get circuit input from {\it
%%% file}.  Default extension is {\tt .ac}.

\item[{\tt >} {\it file}] Send results of analysis to {\it
file}.  Default extension is {\tt .ac}.

\item[{\tt >>} {\it file}] Append results to {\it file}.
Default extension is {\tt .ac}.

%%%\item[{\tt ACMAx}] Use worst case max values, per last
%%%{\tt AC} analysis.

%%%\item[{\tt ACMIn}] Use worst case min values, per last
%%%{\tt AC} analysis.

\item[{\tt By} {\it stepsize}] Linear sweep.  Add {\it
stepsize} to get the next step.  Same as {\tt +}.

%%%\item[{\tt Compare} {\it file}] Compare simulation results
%%% to {\it file}.  Default extension is {\tt .ac}.

%%%\item[{\tt DCMAx}] Use worst case max values, per last
%%%{\tt DC} or {\tt OP} analysis.

%%%\item[{\tt DCMIn}] Use worst case min values, per last
%%%{\tt DC} or {\tt OP} analysis.

\item[{\tt Decade} {\it steps}] Log sweep.  Use {\it
steps} steps per decade.

\item[{\tt Echo}] Echo disk reads to console, when input
is from a file, or doing compare.

%%%\item[{\tt LAg}] Use worst case values, for lagging phase,
%%% per {\tt AC} analysis.

%%%\item[{\tt LEad}] Use worst case values, for leading
%%% phase, per {\tt AC} analysis.

%%%\item[{\tt MAx}] Use worst case max values, per same type
%%%({\tt AC}) analysis.  (Same as {\tt ACMax}, here.)

%%%\item[{\tt MIn}] Use worst case min values, per same type
%%%({\tt AC}) analysis.  (Same as {\tt ACMin}, here.)

%%%\item[{\tt MCarlo} {\it trials}] Monte-Carlo analysis.
%%% Simulate {\it trials} circuits; compile statistics.  Hide
%%% individual trials.

\item[{\tt NOPlot}] Suppress plotting.

\item[{\tt Octave} {\it steps}] Log sweep.  Use {\it
steps} steps per octave.

\item[{\tt PLot}] Graphic output, when plotting is
normally off.

\item[{\tt Print}] Send results to printer.

\item[{\tt Quiet}] Suppress console output.

%%%\item[{\tt Random} {\it trials}] Simulate {\it trials}
%%% circuits using random values.

%%%\item[{\tt TAble}] Tabular output. Override default plot.

\item[{\tt TEmperature} {\it degrees}] Temperature,
degrees C.

\item[{\tt TImes} {\it multiplier}] Log sweep.  Multiply
by {\it multiplier} to get the next step.

%%%\item[{\tt WOrstcase} {\it probe}] Worst case analysis, at
%%%{\it probe}.

\end{description}
%------------------------------------------------------------------------
\subsection{Examples}

\begin{description}

\item[{\tt AC 10m}] A single point AC analysis at 10 mHz.

\item[{\tt AC 1000 3000 100}] Sweep from 1000 Hz to 3000 Hz in 100 Hz steps.

\item[{\tt AC 1000 3000 Octave}] Sweep from 1000 Hz to 3000 Hz in octave
steps.  Since the sweep cannot end at 3000 Hz, in this case, the last step
will really be 4000 Hz.

\item[{\tt AC BY 250}] Keep the same limits as before, but use 250 Hz
steps.  In this case, it means to sweep from 1000 to 3000 Hz, because that
it what it was the last time.

\item[{\tt AC 5000 1000 -250}] You can sweep downward, if you want.
Remember that the increment would be negative.

\item[{\tt AC 20 20k *2}] Double the frequency to get the next step.

\item[{\tt AC 20k 20 *.5}] You can do a log sweep downward, too.  A
multiplier of less than one moves it down.

\item[{\tt AC}] Do the same AC sweep again.

\item[{\tt AC >afile}] Save the results in the file {\tt afile.ac}.  The
file will look just like the screen.  It will have all probe points.  It
will be a plot, if plotting is enabled.  It will have the numbers in
abbreviated notation.  (10 nanovolts is {\tt 10.n}.)

\end{description}
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/alter.tex'
then
    echo shar: will not over-write existing file "'man/Commands/alter.tex'"
else
cat << \SHAR_EOF > 'man/Commands/alter.tex'
% alter  07/24/89
% man commands alter
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt ALter} command}
\index{alter command}
\index{sweep command}
\index{sweep components}
\index{step components}
%------------------------------------------------------------------------
The Spice {\tt Alter} command is not implemented.  Similar functionality is
available from the {\tt SWeep} command.
%------------------------------------------------------------------------
%------------------------------------------------------------------------
%------------------------------------------------------------------------
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/build.tex'
then
    echo shar: will not over-write existing file "'man/Commands/build.tex'"
else
cat << \SHAR_EOF > 'man/Commands/build.tex'
% build  04/01/90
% man commands build .
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt Build} command}
\index{Build command}
\index{new circuit}
\index{creating new circuit}
\index{add to circuit}
%------------------------------------------------------------------------
\subsection{Syntax}
\begin{verse}
{\tt Build} \{{\it line}\}
\end{verse}
%------------------------------------------------------------------------
\subsection{Purpose}

Builds a new circuit, or replaces lines in an existing one.
%------------------------------------------------------------------------
\subsection{Comments}

Lets you enter the circuit from the keyboard.  The prompt changes to {\tt
>} to show that the program is in the build mode.

At this point, type in the circuit components in standard (Spice type)
netlist format.

Component labels must be unique.  If not, the old one is modified according
to the new data, keeping old values where no new ones were specified.

Ordinarily, components are added to the end of the list.  To insert at a
particular place, specify the label to insert in front of.  Example: {\tt
Build R77} will cause new items to be added before {\tt R77}, instead of at
the end.

In either case, components being changed or replaced do not change their
location in the list.

If it is necessary to start over, {\tt DELete ALL} or {\tt CLEAR} will erase
the entire circuit in memory.

To exit this mode, enter a blank line.
%------------------------------------------------------------------------
\subsection{Examples}

\begin{description}

\item[{\tt Build}] Build a circuit.  Add to the end of the list.  This will
add to the circuit without erasing anything.  It will continue until you
exit or memory fills up.

\item[{\tt B}] This is the same as the previous example.  Only the first
letter of the `Build' is necessary.

\item[{\tt Build R33}]    Insert new items in front of R33.

\end{description}
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/chdir.tex'
then
    echo shar: will not over-write existing file "'man/Commands/chdir.tex'"
else
cat << \SHAR_EOF > 'man/Commands/chdir.tex'
% chdir  03/20/90
% man commands chdir .
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt ChDir} command}
\index{chdir command}
\index{cd command}
\index{change directory}
\index{directory: change}
%------------------------------------------------------------------------
\subsection{Syntax}
\begin{verse}
{\tt ChDir} \{{\it path}\}\\
{\tt CD} \{{\it path}\}
\end{verse}
%------------------------------------------------------------------------
\subsection{Purpose}

Changes or displays the current directory name.
%------------------------------------------------------------------------
\subsection{Comments}

Change the current directory to that specified by {\it path}.  See your
system manual for complete syntax.

If no argument is given the current directory is displayed.
%------------------------------------------------------------------------
\subsection{Examples}

\begin{description}

\item[{\tt CD ../ckt}] Change the current working directory to {\tt ../ckt}.

\item[{\tt CD}] Show the current working directory name.

\end{description}
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/clear.tex'
then
    echo shar: will not over-write existing file "'man/Commands/clear.tex'"
else
cat << \SHAR_EOF > 'man/Commands/clear.tex'
% clear  07/24/89
% man commands clear
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt CLEAR} command}
\index{CLEAR command}
\index{clear circuit}
\index{erase}
\index{title: clear}
%------------------------------------------------------------------------
\subsection{Syntax}
\begin{verse}
{\tt CLEAR}
\end{verse}
%------------------------------------------------------------------------
\subsection{Purpose}

Deletes the entire circuit, and blanks the title.
%------------------------------------------------------------------------
\subsection{Comments}

The entire word {\tt CLEAR} is required.

{\tt CLEAR} is similar to, but a little more drastic than {\tt DELete ALL}.

After deleting anything, there is no way to get it back.

See also: {\tt DELete} command.
%------------------------------------------------------------------------
\subsection{Examples}

\begin{description}

\item[{\tt CLEAR}] Delete the entire circuit.

\end{description}
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/dc.tex'
then
    echo shar: will not over-write existing file "'man/Commands/dc.tex'"
else
cat << \SHAR_EOF > 'man/Commands/dc.tex'
% dc  12/29/92
% man commands dc .
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt DC} command}
\index{dc command}
\index{transfer characteristics}
\index{nonlinear transfer analysis}
%------------------------------------------------------------------------
\subsection{Syntax}
\begin{verse}
{\tt DC} {\it start stop stepsize} \{{\it options} ...\}\\
{\tt DC} {\it label start stop stepsize} \{{\it options} ...\}
\end{verse}
%------------------------------------------------------------------------
\subsection{Purpose}

Performs a nonlinear DC steady state analysis, and sweeps the signal input,
or a component value.
%------------------------------------------------------------------------
\subsection{Status}

Nesting of sweeps is not supported.  (SPICE supports two
levels of nesting.)
%------------------------------------------------------------------------
\subsection{Comments}

The nodes to look at must have been previously selected by the {\tt Print} or
{\tt Plot} command.

If there are numeric arguments, without a part label, they represent a ramp
from the {\tt generator} function.  They are the start value, stop value
and step size, in order.  They are saved between commands, so no arguments
will repeat the previous sweep.

A single parameter represents a single input voltage.  Two parameters
instruct the computer to analyze for those two points only.

In some cases, you will get one more step outside the specified range of
inputs due to internal rounding errors.  The last input may be beyond the end
point.

This command also sets up a movable operating point for subsequent {\tt AC}
analysis, which can be helpful in distortion analysis.

The program will sweep any simple component, including resistors,
capacitors, and controlled sources.  SPICE sweeps only fixed sources (types
{\tt V} and {\tt I}).
%------------------------------------------------------------------------
\subsection{Options}

\begin{description}

\item[{\tt *} {\it multiplier}] Log sweep.  Multiply the
input by {\it multiplier} to get the next step.  Do not
pass zero volts!!

\item[{\tt >} {\it file}] Send results of analysis to {\it
file}.  Default extension is {\tt .dc}.

\item[{\tt >>} {\it file}] Append results to {\it file}.
Default extension is {\tt .dc}.

%%%\item[{\tt ACMAx}] Use worst case max values, per last
%%%{\tt AC} analysis.

%%%\item[{\tt ACMIn}] Use worst case min values, per last
%%%{\tt AC} analysis.

\item[{\tt BY} {\it stepsize}] Linear sweep.  Add {\it
stepsize} to get the next step.

\item[{\tt Continue}] Use the last step of a {\tt OP},
{\tt DC} or {\tt Transient} analysis as the first guess.

%%%\item[{\tt DCMAx}] Use worst case max values, per last
%%%{\tt DC} or {\tt OP} analysis.

%%%\item[{\tt DCMIn}] Use worst case min values, per last
%%%{\tt DC} or {\tt OP} analysis.

\item[{\tt Decade} {\it steps}] Log sweep.  Use {\it
steps} steps per decade.

\item[{\tt Input} {\it volts}] Apply {\it volts} input to
the circuit, instead of the sweep.  It will not forget the
old sweep parameters.

%%%\item[{\tt LAg}] Use worst case values, for lagging phase,
%%% per {\tt AC} analysis.

%%%\item[{\tt LEad}] Use worst case values, for leading
%%% phase, per {\tt AC} analysis.

\item[{\tt LOop}] Repeat the sweep, backwards.

%%%\item[{\tt MAx}] Use worst case max values, per same type
%%%({\tt OP} or {\tt DC}) analysis.  (Same as {\tt DCMAx},
%%% here.)

%%%\item[{\tt MIn}] Use worst case min values, per same type
%%%({\tt OP} or {\tt DC}) analysis.  (Same as {\tt DCMIn},
%%% here.)

%%%\item[{\tt MCarlo} {\it trials}] Monte-Carlo analysis.
%%% Simulate {\it trials} circuits; compile statistics.  Hide
%%% individual trials.

\item[{\tt NOPlot}] Suppress plotting.

\item[{\tt PLot}] Graphic output, when plotting is
normally off.

\item[{\tt Print}] Send results to printer.

\item[{\tt Quiet}] Suppress console output.

%%%\item[{\tt Random} {\it trials}] Simulate {\it trials}
%%% circuits using random values.

\item[{\tt REverse}] Sweep in the opposite direction.

%%%\item[{\tt TAble}] Tabular output. Override default plot.

\item[{\tt TEmperature} {\it degrees}] Temperature,
degrees C.

\item[{\tt Times} {\it multiplier}] Log sweep.  Multiply
the input by {\it multiplier} to get the next step.  Do
not pass zero volts!!

\item[{\tt WAtch}] Watch the convergence process, every
iteration.

%%%\item[{\tt WOrstcase} {\it probe}] Worst case analysis, at
%%%{\it probe}.

\end{description}
%------------------------------------------------------------------------
\subsection{Examples}

\begin{description}

\item[{\tt DC 1}] Do a single point DC signal simulation, with {`1 volt'}
input.

\item[{\tt DC -10 15 1}] Sweep the circuit input from -10 to +15 in steps of
1.  (usually volts.)  Do a DC transfer simulation at each step.

\item[{\tt DC}] With no parameters, it uses the same ones as the last time.
In this case, from -10 to 15 in 1\ volt steps.

\item[{\tt DC 20 0 -2}] You can sweep downward, by asking for a negative
increment.  Sometimes, this will result in better convergence, or even
different results!  (For example, in the case of a bi-stable circuit.)

\item[{\tt DC Input 2.3}] Apply an input to the circuit of 2.3 volts.  This
overrides the sweep, for now.  It isn't remembered for next time.  Also,
since it is a single point, you will get a table, rather than a plot.

\item[{\tt DC}] Since the last time used the {\tt Input} option, go back one
more to find what the sweep parameters were.  In this case, downward from 20
to 0 in steps of 2.  (Because we did it 2 commands ago.)

\item[{\tt DC -2 2 .1 LOop}] After the sweep, do it again in the opposite
direction.  In this case, the sweep is -2 to +2 in steps of .1.  After it
gets to +2, it will go back, and sweep from +2 to -2 in steps of -.1.  The
plot will be superimposed on the up sweep.  This way, you can see hysteresis
in the circuit.

\item[{\tt DC TEmperature 75}] Simulate at 75 degrees, this time.  Since we
didn't specify new sweep parameters, do the same as last time.  (Without the
loop.)

%%%\item[{\tt DC 1 WOrstcase v r12}] A worst case analysis
%%% for voltage across the resistor {\tt R12}, with input of 1.

\end{description}
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/delete.tex'
then
    echo shar: will not over-write existing file "'man/Commands/delete.tex'"
else
cat << \SHAR_EOF > 'man/Commands/delete.tex'
% delete  04/01/90
% man commands delete .
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt DELete} command}
\index{DELete command}
\index{clear circuit}
\index{erase}
\index{remove parts}
%------------------------------------------------------------------------
\subsection{Syntax}
\begin{verse}
{\tt DELete} {\it label} ...\\
{\tt DELete ALL}
\end{verse}
%------------------------------------------------------------------------
\subsection{Purpose}

Remove a line, or a group of lines, from the circuit description.
%------------------------------------------------------------------------
\subsection{Comments}

To delete a part, by label, enter the label.  (Example `DEL R15'.)
Wildcards `{\tt *}' and `{\tt ?}' are allowed, in which case, all that match
are deleted.

To delete the entire circuit, the entire word {\tt ALL} must be entered.
(Example `DEL ALL'.)

After deleting anything, there is usually no way to get it back, but if a
fault had been applied (see {\tt FAult} command) {\tt Restore} may have
surprising results.
%------------------------------------------------------------------------
\subsection{Examples}

\begin{description}
\item[{\tt DELete ALL}] Delete the entire circuit, but save the title.

\item[{\tt DEL R12}] Delete {\tt R12}.

\item[{\tt DEL R12 C3}] Delete {\tt R12} and {\tt C3}.

\item[{\tt DEL R*}] Delete all resistors.  (Also, any models and subcircuits
starting with {\tt R}.)

\end{description}
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/disto.tex'
then
    echo shar: will not over-write existing file "'man/Commands/disto.tex'"
else
cat << \SHAR_EOF > 'man/Commands/disto.tex'
% disto  02/26/90
% man commands disto
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt DIsto} command}
\index{disto command}
\index{distortion}
%------------------------------------------------------------------------
The Spice {\tt DIsto} command is not implemented.  Similar functionality is
not available.
%------------------------------------------------------------------------
%------------------------------------------------------------------------
%------------------------------------------------------------------------
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/edit.tex'
then
    echo shar: will not over-write existing file "'man/Commands/edit.tex'"
else
cat << \SHAR_EOF > 'man/Commands/edit.tex'

SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/end.tex'
then
    echo shar: will not over-write existing file "'man/Commands/end.tex'"
else
cat << \SHAR_EOF > 'man/Commands/end.tex'
% end  02/26/90
% man commands end .
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt END} command}
\index{end command}
%------------------------------------------------------------------------
The Spice {\tt END} command is implemented incorrectly.  It behaves like
{\tt Quit} in batch files, or interactive mode and is ignored otherwise.
%------------------------------------------------------------------------
%------------------------------------------------------------------------
%------------------------------------------------------------------------
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/exit.tex'
then
    echo shar: will not over-write existing file "'man/Commands/exit.tex'"
else
cat << \SHAR_EOF > 'man/Commands/exit.tex'
% exit  10/24/90
% man commands exit .
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt EXIt} command}
\index{quit command}
\index{exit command}
%------------------------------------------------------------------------
\subsection{Syntax}
\begin{verse}
{\tt EXIt}
\end{verse}
%------------------------------------------------------------------------
\subsection{Purpose}

Terminates the program.
%------------------------------------------------------------------------
\subsection{Comments}

`{\tt Quit}' also works.

Be sure you have saved everything you want to!
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/fault.tex'
then
    echo shar: will not over-write existing file "'man/Commands/fault.tex'"
else
cat << \SHAR_EOF > 'man/Commands/fault.tex'
% fault  10/02/89
% man commands fault .
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt FAult} command}
\index{fault command}
\index{change values: temporary}
%------------------------------------------------------------------------
\subsection{Syntax}
\begin{verse}
{\tt FAult} {\it partlabel}={\it value} ...
\end{verse}
%------------------------------------------------------------------------
\subsection{Purpose}

Temporarily change a component value.
%------------------------------------------------------------------------
\subsection{Comments}

This command quickly changes the value of a component, usually with the
intention that you will not want to save it.

If you apply this command to a nonlinear or otherwise strange part, it becomes
ordinary and linear until the fault is removed.

It is an error to {\tt fault} a model call.

If several components have the same label, the fault value applies to all of
them.  (They will all have the same value.)

The {\tt UNFault} command restores the old values.
%------------------------------------------------------------------------
\subsection{Example}

\begin{description}

\item[{\tt FAult R66=1k}] R66 now has a value of 1k, regardless of what it
was before.

\item[{\tt FAult C12=220p L1=1u}] C12 is 220 pf and L1 is 1 uH, for now.

\item[{\tt UNFault}] Clears all faults.  It is back to what it was before.

\end{description}
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/fourier.tex'
then
    echo shar: will not over-write existing file "'man/Commands/fourier.tex'"
else
cat << \SHAR_EOF > 'man/Commands/fourier.tex'
% fourier  01/11/93
% man commands fourier .
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt Fourier} command}
\index{fourier command}
\index{spectrum analysis}
\index{frequency domain: nonlinear}
\index{nonlinear analysis: frequency domain}
%------------------------------------------------------------------------
\subsection{Syntax}
\begin{verse}
{\tt Fourier} {\it start stop stepsize} \{{\it options} ...\}
\end{verse}
%------------------------------------------------------------------------
\subsection{Purpose}

Performs a nonlinear time domain (transient) analysis, but displays the
results in the frequency domain.

{\it Start}, {\it stop}, and {\it stepsize} are frequencies.
%------------------------------------------------------------------------
\subsection{Status}

This command is different from the SPICE command of the
same name.  It is completely broken in version 0.05.
%------------------------------------------------------------------------
\subsection{Comments}

The nodes to look at must have been previously selected by the {\tt Print} or
{\tt Plot} command.

Three parameters are normally needed for a Fourier analysis: start frequency,
stop frequency and step size, in this order.  They are interpreted similarly
to the AC analysis.

Actually, this command does a nonlinear time domain analysis, then performs a
Fourier transform on the data to get the frequency data.  The transient
analysis parameters (start, stop, step) are determined by the program as
necessary to produce the desired AC results.

Input files are in transient analysis format; output files are in AC analysis
format.

{\tt Print Input} (see print command) will show the Fourier transform of the
input.

See also: {\tt Transient} command.
%------------------------------------------------------------------------
\subsection{Options}

\begin{description}

%%%\item[{\tt <} {\it file}] Get circuit input from {\it
%%% file}.  Default extension is {\tt .tr}.

\item[{\tt >} {\it file}] Send results of analysis to {\it
file}.  Default extension is {\tt .fo}.

\item[{\tt >>} {\it file}] Append results to {\it file}.
Default extension is {\tt .fo}.

%%%\item[{\tt ACMAx}] Use worst case max values, per last
%%%{\tt AC} analysis.

%%%\item[{\tt ACMIn}] Use worst case min values, per last
%%%{\tt AC} analysis.

\item[{\tt Cold}] Zero initial conditions.  Cold start.

%%%\item[{\tt DCMAx}] Use worst case max values, per last
%%%{\tt DC} or {\tt OP} analysis.

%%%\item[{\tt DCMIn}] Use worst case min values, per last
%%%{\tt DC} or {\tt OP} analysis.

\item[{\tt Echo}] Echo disk reads to console, when input
is from a file.

%%%\item[{\tt LAg}] Use worst case values, for lagging phase,
%%% per {\tt AC} analysis.

%%%\item[{\tt LEad}] Use worst case values, for leading
%%% phase, per {\tt AC} analysis.

\item[{\tt PLot}] Graphic output, if not otherwise enabled.

\item[{\tt Print}] Send results to printer.

\item[{\tt Quiet}] Suppress console output.

\item[{\tt SKip} {\it count}] Force {\it count} internal
time steps for each one used.  Override internal step size
control.

\item[{\tt STiff}] Use a different integration method,
that will suppress overshoot when the step size is too
small.

\item[{\tt Table}] Tabular output. Override default plot.

\item[{\tt TEmperature} {\it degrees}] Temperature,
degrees C.

\item[{\tt WAtch}] Show the transient analysis, before
doing the transform.

\end{description}
%------------------------------------------------------------------------
\subsection{Examples}

\begin{description}

\item[{\tt Fourier 40 20k 20}] Analyze the spectrum from 40 Hz to 20 kHz in
20 Hz steps.  This will result in a transient analysis with 25 micro-second
steps.  (1 / 40k).  It will run for .05 second.  (1 / 20).

\item[{\tt Fourier 0 20k 20}] Similar to the previous example, but show the
DC and 20 Hz terms, also.

\item[{\tt Fourier}] No parameters mean use the same ones as the last time.
In this case: from 0 to 20 kHz, in 20 Hz steps.

\item[{\tt Fourier Skip 10}] Do 10 transient steps internally for every step
that is used.  In this case it means to internally step at 2.5 micro-second,
or 10 steps for every one actually used.

\item[{\tt Fourier Cold}] Zero initial conditions.  This will show the
spectrum of the power-on transient.

%%%\item[{\tt Fourier >arun}] Save the results of this run in the file {\tt
%%% arun.fo}.  You could use it as an input for AC analysis

%%%\item[{\tt Fourier <aninput}] Use the file {\tt aninput.tr} as a user
%%% defined input.  It substitutes for the signal generator.  Note that it is a
%%%{\bf transient} file.

\end{description}
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/generato.tex'
then
    echo shar: will not over-write existing file "'man/Commands/generato.tex'"
else
cat << \SHAR_EOF > 'man/Commands/generato.tex'
% generato  04/13/92
% man  commands  generato  .
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt Generator} command}
\index{Generator command}
\index{user defined transient input}
\index{user source}
\index{transient input}
\index{input: transient analysis}
\index{function generator}
%------------------------------------------------------------------------
\subsection{Syntax}
\begin{verse}
{\tt Generator} \{{\it option-name}={\it value} ...\}
\end{verse}
%------------------------------------------------------------------------
\subsection{Purpose}

Sets up the input waveform for {\tt transient} and {\tt Fourier} analysis.
Emulates a laboratory type function generator.
%------------------------------------------------------------------------
\subsection{Comments}

The parameters available are designed to emulate the controls on a function
generator.  There are actually two generators here: sine wave and pulse.  If
both are on (by setting non-zero parameters) the sine wave is modulated by
the pulse, but either can be used alone.

Unless you change it, it is a unit-step function at time 0.  The purpose of
the command is to change it.

This command does not affect {\tt AC} or {\tt DC} analysis in any way.  It
is only for {\tt transient} and {\tt Fourier} analysis.  In {\tt AC}
analysis, the input signal is always a sine wave at the analysis frequency.

All sources with input nodes both zero have their input connected to this
generator.

Typical usage is the name of the control followed by its value, or just plain
{\tt Generator} to display the present values.

The actual time when switching takes place is ambiguous by one time step.  If
precise time switching is necessary, use the {\tt Skip} option on the
transient analysis command, to force more resolution.  This ambiguity can
usually be avoided by specifying finite rise and fall times.
\index{ambiguous time}
\index{switch time errors}
%------------------------------------------------------------------------
\subsection{Parameters}

\begin{description}

\item[{\tt Freq}] The frequency of the sine wave generator for a transient
analysis.  The sine wave is modulated by the pulse generator.  A frequency
of zero puts the pulse generator on line directly.

\item[{\tt Ampl}] The overall amplitude of the pulse and sine wave.  A
scale factor.  It applies to everything except the {\it offset} and {\it
init} values.

\item[{\tt Phase}] The phase of the sine wave, at the instant it is first
turned on.

\item[{\tt MAx}] The amplitude of the pulse, when it is `on'.  (During the
{\it width} time) If the sine wave is on (frequency not zero) this is the
amplitude of the sine wave during the first part of the period.  The {\it
max} is scaled by {\it ampl}.

\item[{\tt MIn}] The amplitude of the pulse, when it is `off'.  (After it
falls, but before the next period begins.)  Although we have called these
{\it min} and {\it max}, there is no requirement that {\it max} be larger
than {\it min}.  If the sine wave is on, this is its amplitude during the
second part of the period.  The {\it min} is scaled by {\it ampl}.

\item[{\tt Offset}] The DC offset applied to the entire signal, at all times
after the initial delay.  The {\it offset} is {\bf not} scaled by {\it ampl}.

\item[{\tt Init}] The initial value of the pulse generator output.  It will
have this value starting at time 0, until {\it Delay} time has elapsed.  It
will never return to this value, unless you restart at time 0.

\item[{\tt Rise}] The rise time, or the time it takes to go from {\it MIn}
to {\it MAx}, or for the first rise, {\it Init} to {\it MAx}.  The rise is
linear.

\item[{\tt Fall}] The fall time.  (The time required to go from {\it MAx}
back to {\it MIn}.)

\item[{\tt Delay}] The waiting time before the first rise.

\item[{\tt Width}] The length of time the output of the generator has the
value {\it Max}.  A width of zero means that the output remains high for the
remainder of the period.  If you really want a width of zero, use a very
small number, less than the step size.

\item[{\tt Period}] The time for repetition of the pulse.  It must be
greater than the sum of rise + fall + width.  A period of zero means that
the signal is not periodic and so will not repeat.

\end{description}
%------------------------------------------------------------------------
\subsection{Examples}

\begin{description}

\item[{\tt Gen}] Display the present settings.

\item[{\tt Gen Freq=1k}] Sets the sine wave to 1 kHz.  All other parameters
are as they were before.

\item[{\tt Gen Freq=0}] Turns off the sine wave, leaving only the pulse.

\item[{\tt Gen Ampl=0}] Sets the amplitude to zero, which means the circuit
has no input, except for possibly a DC offset.

\item[{\tt Gen Ampl=5 MAx=2 MIn=-.5 Offset=0 Init=0 Rise=10u Fall=10u
Delay=1 Width=100u Period=.001}] Sets all the parameters, except {\tt freq}
and {\tt phase}.  You will get a 10 volt (ampl=5, max=2, 2*5=10) 100
microsecond pulse every .001 seconds.  Between pulses, the level will be
-2.5 volts.  (ampl=5, min=-.5, -.5*5=2.5) For the first second (delay=1)
there will be no output. (init=0)

\item[{\tt Gen Period=.001 Freq=1m}] Sets the period back to 1 millisecond.
Applies 1 mHz modulation to the pulse, resulting in a pulsed sine wave.  In
this case, a 100 microsecond 10 volt burst, repeating every millisecond.
Between bursts, you will get 2.5 volts, with reversed phase.  The old
values, in this case from 2 lines back (above) are kept.  ({\tt Ampl 5 Rise
10u Fall 10u} ...)

\item[{\tt Gen Freq=60 Phase=90 Delay=.1}] The sine wave frequency is 60
Hertz.  Its phase is 90 degrees when it turns on, at time .1 seconds.  It
turns on sharply at the peak.

\end{description}
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/get.tex'
then
    echo shar: will not over-write existing file "'man/Commands/get.tex'"
else
cat << \SHAR_EOF > 'man/Commands/get.tex'
% get  04/03/90
% man commands get .
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt GET} command}
\index{GET command}
\index{load circuit from file}
\index{read circuit from file}
\index{retrieve circuit from file}
\index{file: get}
\index{file: read}
%------------------------------------------------------------------------
\subsection{Syntax}
\begin{verse}
{\tt GET} {\it filename}
\end{verse}
%------------------------------------------------------------------------
\subsection{Purpose}

Gets an existing circuit file, after clearing memory.
%------------------------------------------------------------------------
\subsection{Comments}

The default file extension is {\tt .ckt}.

The first comment line of the file being read is taken as the `title'.  See
the {\tt TItle} command.

Comments in the circuit file are stored, unless they start with {\tt *+} in
which case they are thrown away.

`Dot cards' are set up, but not executed.  This means that variables and
options are changed, but simulation commands are not actually done.  As
an example, the {\tt options} command is actually performed, since it only
sets up variables.  The {\tt ac} card is not performed, but its parameters
are stored, so that a plain {\tt ac} command will perform the analysis
specified in the file.

Any circuit already in memory will be erased before loading the new circuit.
%------------------------------------------------------------------------
\subsection{Examples}

\begin{description}

\item[{\tt GET amp}] Get the circuit file {\tt amp.ckt} from the current
directory.

\item[{\tt GET /usr/foo/ckt/amp}] Get the file {\tt amp.ckt} from the {\tt
/usr/foo/ckt} directory.

\item[{\tt GET npn.mod}] Get the file {\tt npn.mod}.  Override the default
extension {\tt .ckt}.

\end{description}
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/help.tex'
then
    echo shar: will not over-write existing file "'man/Commands/help.tex'"
else
cat << \SHAR_EOF > 'man/Commands/help.tex'
% help  04/02/90
% man commands help .
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt Help} command}
\index{help}
\index{on-line documentation}
%------------------------------------------------------------------------
\subsection{Syntax}
\begin{verse}
{\tt Help} \{{\it subject}\}
\end{verse}
%------------------------------------------------------------------------
\subsection{Purpose}

Provides on line documentation.
%------------------------------------------------------------------------
\subsection{Comments}

{\tt Help} lists the commands.

{\tt Help Help} lists the other subjects on which help is available.

{\tt Help ERrors} lists the error messages.  The word in the error message
that is partially capitalized is a keyword.  {\tt Help} followed by this
word will tell you more about that message.

Types of subjects available include commands, command options, error
messages, and circuit description.
%------------------------------------------------------------------------
\subsection{Examples}

\begin{description}

\item[{\tt Help BUild}] Tells you about the `{\tt Build}' command.

\item[{\tt Help MOSfet}] Tells you about the MOSFET model usage.

\item[{\tt Help ERrors}] Lists the error messages.  Strange looking
capitalization identifies keywords that will tell you how to get more about
a particular error message.

\item[{\tt Help CONVerge}] Gives details about the `{\tt did not converge}'
error message.

\end{description}
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/ic.tex'
then
    echo shar: will not over-write existing file "'man/Commands/ic.tex'"
else
cat << \SHAR_EOF > 'man/Commands/ic.tex'
% ic  04/05/90
% man commands ic .
%------------------------------------------------------------------------
\section{{\tt IC} command}
\index{ic command}
\index{initial conditions}
%------------------------------------------------------------------------
The Spice {\tt IC} command is not implemented.  Similar functionality is
not available.
%------------------------------------------------------------------------
%------------------------------------------------------------------------
%------------------------------------------------------------------------
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/insert.tex'
then
    echo shar: will not over-write existing file "'man/Commands/insert.tex'"
else
cat << \SHAR_EOF > 'man/Commands/insert.tex'
% insert  04/04/90
% man commands insert .
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt INsert} command}
\index{Insert command}
\index{nodes: insert}
%------------------------------------------------------------------------
\subsection{Syntax}
\begin{verse}
{\tt INsert} {\it node}\\
{\tt INsert} {\it node, count}
\end{verse}
%------------------------------------------------------------------------
\subsection{Purpose}

Open up node numbers inside a circuit.
%------------------------------------------------------------------------
\subsection{Comments}

To open up an internal node, enter {\tt Insert} followed by the number and
how many.  All node numbers higher than the first number will be raised by
the second.  The second (how many) is optional.  If omitted, 1 will be
assumed.
%------------------------------------------------------------------------
\subsection{Examples}

\begin{description}

\item[{\tt Insert 8 3}] Insert 3 nodes before node 8.  Adds 3 nodes (8,9,10)
with no connections.  Old node numbers 8 and higher have 3 added to them to
make room.  Old node 8 is now 11, 9 is now 12, 10 is now 13, 11 is 14, etc.

\item[{\tt Insert 6}] Insert one node at 6.  Old nodes 6 and higher are
incremented by 1.  Old node 6 is now 7, 7 is 8, etc.

\end{description}
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/list.tex'
then
    echo shar: will not over-write existing file "'man/Commands/list.tex'"
else
cat << \SHAR_EOF > 'man/Commands/list.tex'
% list  04/09/91
% man commands list .
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt List} command}
\index{List command}
\index{view circuit}
\index{connection list}
\index{parts list}
\index{list by branch}
%------------------------------------------------------------------------
\subsection{Syntax}
\begin{verse}
{\tt List} \{{\it label ...}\} \{{\it options} ...\}\\
{\tt List} \{{\it label} - {\it label}\} \{{\it options} ...\}
\end{verse}
%------------------------------------------------------------------------
\subsection{Purpose}

Lists the circuit in memory.
%------------------------------------------------------------------------
\subsection{Comments}

Plain {\tt List} will list the whole circuit on the console.

{\tt List} with a component label asks for that one only.  Wildcards are
supported: {\tt ?} matches any character, once.  {\tt *} matches zero or
more of any character.

For several components, list them.

For a range, specify two labels separated by a dash.
%------------------------------------------------------------------------
\subsection{Examples}

\begin{description}

\item[{\tt List}] List the entire circuit to the console.

\item[{\tt List R11}] Show the component {\tt R11}.

\item[{\tt List D12 - C5}] List the part of the netlist from {\tt M12} to
{\tt C5}, inclusive.  {\tt D12} must be before {\tt C5} in the list.

\item[{\tt List D* C*}] List all diodes and capacitors.

\end{description}
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/log.tex'
then
    echo shar: will not over-write existing file "'man/Commands/log.tex'"
else
cat << \SHAR_EOF > 'man/Commands/log.tex'
% log  04/03/90
% man commands log .
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt LOg} command}
\index{log command}
\index{batch mode}
\index{files}
\index{disk files}
\index{command record}
\index{record of commands}
\index{i-o redirection}
\index{redirection: i-o}
%------------------------------------------------------------------------
\subsection{Syntax}
\begin{verse}
{\tt LOg} {\it file}\\
{\tt LOg >>} {\it file}\\
{\tt LOg}
\end{verse}
%------------------------------------------------------------------------
\subsection{Purpose}

Saves a copy of your keyboard entries in a disk file, which may be used as
input for the `{\tt <}' command, or to run in batch mode.
%------------------------------------------------------------------------
\subsection{Comments}

{\tt LOg} {\it file} creates a new file, with default extension {\tt .eca}.
If the file already exists, the old one is lost, and replaced by the new
one.  There is no warning.

The `{\tt >>}' option appends to an existing file, if it exists, otherwise it
creates one.

Files can be nested.  If you open one while another is already open, both
will contain all the information.

A bare {\tt LOg} closes the file.  Because of this, the last line of this
file is always {\tt LOg}.  Ordinarily, this will not be of any consequence,
but if a log file is open when you use this file as command input, this will
close it.  If more than one {\tt LOg} file is open, they will be closed in
the reverse of the order in which they were opened, maintaining nesting.

On MS-DOS systems, {\bf do not change disks when this file is open.}
Changing disks may cause a total non-recoverable loss of all information on
the disk.  This is characteristic of MS-DOS, and there is nothing this or
any application program can do about it.

See also: `{\tt >}' and `{\tt <}' commands.
%------------------------------------------------------------------------
\subsection{Examples}

\begin{description}

\item[{\tt LOg today}] Save the commands in a file {\tt today.eca} in the
current directory.  If {\tt today.eca} already exists, the old one is gone.

\item[{\tt LOg >> doit}] Save the commands in a file {\tt doit.eca}.  If
{\tt doit.eca} already exists, it is kept, and the new data is added to the
end.

\item[{\tt LOg runit.bat}] Use the file {\tt runit.bat}.  You can override
the default {\tt .eca} extension.

\item[{\tt LOg thatone.}] Use the file {\tt thatone} in the current
directory.  Ending the file name with a dot overrides the default, and
assigns none.

\item[{\tt LOg}] Close the file.  Stop saving.

\end{description}
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/mark.tex'
then
    echo shar: will not over-write existing file "'man/Commands/mark.tex'"
else
cat << \SHAR_EOF > 'man/Commands/mark.tex'
% mark  01/20/93
% man commands mark .
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt MArk} command}
\index{mark command}
\index{transient reruns}
%------------------------------------------------------------------------
\subsection{Syntax}
\begin{verse}
{\tt MArk}
\end{verse}
%------------------------------------------------------------------------
\subsection{Purpose}

Remember circuit voltages and currents.
%------------------------------------------------------------------------
\subsection{Comments}

After the {\tt MArk} command, the {\tt Transient} and {\tt Fourier} analysis
will continue from the values that were kept by the {\tt MArk} command,
instead of progressing every time.

This allows reruns from the same starting point, which may be at any time,
not necessarily 0.
%------------------------------------------------------------------------
\subsection{Examples}

\begin{description}
\item[{\tt Transient 0 1 .01}] A transient analysis starting at zero,
running until 1 second, with step size .01 seconds.  After this run, the
clock is at 1 second.

\item[{\tt MArk}] Remember the time, voltages, currents, etc.

\item[{\tt Transient}] Another transient analysis.  It continues from 1
second, to 2 seconds.  (It spans 1 second, as before.)  This command was not
affected by the {\tt mark} command.

\item[{\tt Transient}] This will do exactly the same as the last one.  From
1 second to 2 seconds.  If it were not for {\tt mark}, it would have started
from 2 seconds.

\item[{\tt Transient 1.5 .001}] Try again with smaller steps.  Again, it
starts at 1 second.

\item[{\tt UNMark}] Release the effect of {\tt mark}.

\item[{\tt Transient}] Exactly the same as the last time, as if we didn't
{\tt UNmark}.  (1 to 1.5 seconds.)

\item[{\tt Transient}] This one continues from where the last one left off:
at 1.5 seconds.  From now on, time will move forward.

\end{description}
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/merge.tex'
then
    echo shar: will not over-write existing file "'man/Commands/merge.tex'"
else
cat << \SHAR_EOF > 'man/Commands/merge.tex'
% merge  04/03/90
% man commands merge .
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt MErge} command}
\index{MErge command}
\index{load circuit from file}
\index{read circuit from file}
\index{retrieve circuit from file}
\index{file: get}
\index{file: merge}
\index{file: read}
%------------------------------------------------------------------------
\subsection{Syntax}
\begin{verse}
{\tt MErge} {\it filename}
\end{verse}
%------------------------------------------------------------------------
\subsection{Purpose}

Gets an existing circuit file, without clearing memory.
%------------------------------------------------------------------------
\subsection{Comments}

The default file extension is {\tt .ckt}.

The first comment line of the file being read is the new title, and replaces
the existing title.

Comments in the circuit file are stored, unless they start with {\tt *+} in
which case they are thrown away.

`Dot cards' are set up, but not executed.  This means that variables and
options are changed, but simulation commands are not actually done.  As
an example, the {\tt options} command is actually performed, since it only
sets up variables.  The {\tt ac} card is not performed, but its parameters
are stored, so that a plain {\tt ac} command will perform the analysis
specified in the file.

Any circuit already in memory is kept.  New elements with duplicate labels
replace the old ones.  New elements that are not duplicates are added to the
end of the list, as if the files were appended.
%------------------------------------------------------------------------
\subsection{Examples}

\begin{description}

\item[{\tt MErge amp}] Get the circuit file {\tt amp.ckt} from the current
directory.  Use it to change the circuit in memory.

\item[{\tt MErge npn.mod}] Include the file {\tt npn.mod}.  Override the
default extension {\tt .ckt}.

\end{description}
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/modify.tex'
then
    echo shar: will not over-write existing file "'man/Commands/modify.tex'"
else
cat << \SHAR_EOF > 'man/Commands/modify.tex'
% modify  01/23/93
% man commands modify .
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt MOdify} command}
\index{modify command}
%------------------------------------------------------------------------
\subsection{Syntax}
\begin{verse}
{\tt MOdify} {\it partlabel}={\it value} ...
\end{verse}
%------------------------------------------------------------------------
\subsection{Purpose}

Quickly change a component value.
%------------------------------------------------------------------------
\subsection{Comments}

This command quickly changes the value of a component.  It is restricted to
simply changing the value.

If several components have the same label or if wildcard characters are
used, all are changed.
%------------------------------------------------------------------------
\subsection{Example}

\begin{description}

\item[{\tt MOdify R66=1k}] R66 now has a value of 1k, regardless of what it
was before.

\item[{\tt MOdify C12=220p L1=1u}] C12 is 220 pf and L1 is 1 uH.

\item[{\tt mod R*=22k}] All resistors are now 22k.

\end{description}
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
#    End of shell archive
exit 0