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

Text File | 1993-01-25 | 10.5 KB | 338 lines

Path: sparky!uunet!zaphod.mps.ohio-state.edu!rpi!usc!cs.utexas.edu!qt.cs.utexas.edu!yale.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 05/20
Message-ID: <[e-mail]>
Date: 25 Jan 93 05:21:37 GMT
Sender: [e-mail] (Al Davis)
Organization: Huh?
Lines: 327

#! /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/0summary.tex
#    man/Commands/1shell.tex
#    man/Commands/2batch.tex
#    man/Commands/3outfile.tex
# This archive created: Mon Jan 25 00:17:43 1993
export PATH; PATH=/bin:$PATH
if test -f 'man/Commands/0summary.tex'
then
    echo shar: will not over-write existing file "'man/Commands/0summary.tex'"
else
cat << \SHAR_EOF > 'man/Commands/0summary.tex'
% summary  01/11/93
% man commands summary .
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\index{command descriptions}
\index{command summary}

\begin{description}

\item[{\tt *}] Comment line.
\index{comment line}

\item[{\tt !}] Pass a command to the operating system.

\item[{\tt <}] Batch mode.

\item[{\tt >}] Direct the ``standard output'' to a file.

\item[{\tt Ac}] Performs a small signal AC (frequency domain) analysis.
Sweeps frequency.

\item[{\tt ALter}] Perform analyses in queue.  Changes follow.  (Not
implemented.)

\item[{\tt Build}] Build a new circuit or change an existing one.

\item[{\tt ChDir}] Change current directory.

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

\item[{\tt DC}] Performs a nonlinear DC analysis, for determining transfer
characteristics.  Sweeps DC input or component values.

\item[{\tt DELete}] Delete a part, or group of parts.

\item[{\tt DIsto}] SPICE command not implemented.

\item[{\tt EDit}] Edit the circuit description using your editor.

\item[{\tt ENd}] Perform analyses in queue.  New circuit follows.
(Implemented incorrectly.)

\item[{\tt EXIt}] Exits the program.  (Same as quit)

\item[{\tt FAult}] Temporarily change a component.

%%%\item[{\tt Fourier}] Transient analysis, with results in
%%%frequency domain.  (Different from SPICE.)

\item[{\tt Generator}] View and set the transient analysis function
generator.

\item[{\tt GET}] Get a circuit from a disk file.  Deletes old one first.

\item[{\tt Help}] Requests advice on error messages, options, command
syntax.

\item[{\tt IC}] Set transient analysis initial conditions.
(Not implemented.)

\item[{\tt INsert}] Insert a node number.  (Make a gap.)

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

\item[{\tt LOg}] Save a record of commands.

\item[{\tt MArk}] Mark this time point, so transient analysis will restart
here.

\item[{\tt MErge}] Get a circuit from disk.  Add it the what is already in
memory.

\item[{\tt Modify}] Change a value, node, etc.  For very simple changes.

\item[{\tt Network}] List by node number, the branches that connect to each
node.

\item[{\tt NODeset}] Preset node voltages, to assist convergence.  (Not
implemented.)

\item[{\tt NOIse}] SPICE command not implemented.

\item[{\tt OP}] Performs a nonlinear DC analysis, for determining quiescent
operating conditions.  Sweeps temperature.

\item[{\tt OPTions}] View and set system options.  (Same as set.)

\item[{\tt PAuse}] Wait for key hit, while in batch mode.

\item[{\tt PLot}] Select points in circuit (and their range) to plot.

\item[{\tt Print}] Select which points in the circuit to print as table.

\item[{\tt Quit}] Exits the program.  (Same as exit.)

\item[{\tt SAve}] Save the circuit in a file.

\item[{\tt SENs}] SPICE command not implemented.

\item[{\tt SEt}] View and set system options.  (Same as options.)

\item[{\tt Status}] Display resource usage, etc.

\item[{\tt SWeep}] Sweep a component.  (Loop function.)

\item[{\tt TEmp}] SPICE command not implemented.

\item[{\tt TF}] SPICE command not implemented.

\item[{\tt TItle}] View and create the heading line for printouts and files.

\item[{\tt Transient}] Performs a nonlinear transient (time domain)
analysis.  Sweeps time.

\item[{\tt UNFault}] Undo faults.

\item[{\tt UNMark}] Undo mark.  Release transient start point.

\item[{\tt Width}] Set output width.

\end{description}
%------------------------------------------------------------------------
%------------------------------------------------------------------------
SHAR_EOF
fi # end of overwriting check
if test -f 'man/Commands/1shell.tex'
then
    echo shar: will not over-write existing file "'man/Commands/1shell.tex'"
else
cat << \SHAR_EOF > 'man/Commands/1shell.tex'
% shell  04/06/89
% man commands shell .
% Copyright 1983-1992   Albert Davis
%------------------------------------------------------------------------
\section{{\tt !} command}
\index{! command}
\index{operating system commands}
%------------------------------------------------------------------------
\subsection{Syntax}
\begin{verse}
{\tt !} {{\it command}}
\end{verse}
%------------------------------------------------------------------------
\subsection{Purpose}

Run a program, or escape to a shell.
%------------------------------------------------------------------------
\subsection{Comments}

Any {\it command} typed here will be passed to the system for it to execute.

The bare command {\tt !} will spawn an interactive shell.  Exiting the shell
will return.
%------------------------------------------------------------------------
\subsection{Examples}

\begin{description}

\item[{\tt ! ls *.ckt}] Run the command {\tt ls *.ckt} as if it were a shell
command.

\item[{\tt !}] No arguments mean to spawn an interactive shell.

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

Run a simulation in batch mode.  Gets the commands and circuit from a disk
file.  {\tt <<} clears the old circuit, first.
%------------------------------------------------------------------------
\subsection{Comments}

The default extension is {\tt .ckt}.

You can invoke the batch mode directly from the command that starts the
program.  The first command line argument is considered to be an argument
for this command.

The file format is almost as you would type it on the keyboard.  Commands
must be prefixed with a dot, and circuit elements can be entered directly,
as if in {\em build} mode.  This is compatible with Spice.  The {\tt log}
command can make this file, as you work the program, or you can make it with
any editor.

Any line that starts with {\tt *} a comment line.

Any line that starts with {\tt .} (dot) is a command.

Any line that starts with a letter is a component to be added or changed.

A {\tt <} command in the file transfers control to a new file.  Files can be
nested.

A bare {\tt <} in the file (or the end of the file) gives it back to the
console.

Unlike SPICE, commands are executed in order.  This can result in some
surprises when using some SPICE files.  SPICE queues up commands, then
executes them in a predetermined order.
%------------------------------------------------------------------------
\subsection{Examples}

\begin{description}

\item[{\tt < thisone}] Activates batch mode, from the file {\tt
thisone.ckt}, in the current directory.

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

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


From the shell: on start up:

\item[{\tt eca afile}] Start up the program.  Start using the file {\tt
afile.ckt} in batch mode, as if you entered {\tt < afile} as the first
command.

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

Saves a copy of all program output (except help) in a file.
%------------------------------------------------------------------------
\subsection{Comments}

{\tt >} creates a new file for this output.  If the file already exists, the
old one is lost, and replaced by the new one.

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

A bare {\tt >} closes the file.

There is no default extension.
%------------------------------------------------------------------------
\subsection{Examples}

\begin{description}

\item[{\tt > run1}] Save everything in a file {\tt run1} in the current
directory.  If {\tt run1} already exists, the old one is gone.

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

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

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