PUTSPICE(1ICD)

NAME
putspice - put a SPICE network description into the database

SYNOPSIS
putspice [-psw] networkfile ...

OPTIONS
The following options can be specified:

-p  Run the C preprocessor before parsing the input file.

-s  The silent mode suppresses messages about the actions taken by the program which are usually printed on the screen.

-w  Do not print warnings.

DESCRIPTION
Putspice is a program that generates from a spice network description a circuit description in database format. The database format can serve as input to several application programs, e.g. the circuit simulator spice, the switch-level simulator sls, and the network comparison program match. A description of the spice language can be found in the SPICE User's Guide. The spice description that can be used as input for putspice extends the normal spice network description in that numbers as well as identifiers may be used for node and terminal specifications.

A network description can be hierarchical and may reside in several files. However, when one particular network is added to the database, network descriptions of the networks that are called in the network must have been added to the database before.

In the file 'global_nets' one may optionally specify names of nets (terminals) that are global. Each node or terminal that has a name equal to the name of a global net, will be connected to other nodes and terminals that have the same name, among other things by possibly defining extra terminals for each network. First, putspice will try to find a file 'global_nets' in the current working directory. Second, if the above attempt fails, putspice will try to open a file 'global_nets' in the corresponding process directory.

CONFIGURATION FILE
At start-up of the program, putspice will read some information from a configuration file called ".putspicerc". First, it tries to find this file in the current directory. Second, it tries to open this file in the home directory of the user. Thirdly, it looks for this file in process directory. The configuration file may contain the following keywords, followed by a specification on the same line if the keyword ends with ':';

FORBID_FIRST_CAPITAL_ON
    Generate an error message if the name of a network that is defined starts with a capital.

RUN_CPP_ON
    Run the C preprocessor before parsing the input file.

CPP_OPTIONS:
    Options for running the C preprocessor.

DEFAULT_INCLUDE:
    Specifies a file that is automatically included at the top of the input file if the C preprocessor is run.

EXAMPLES
$ putspice latch.spc

AUTHORS
A.C. de Graaf, A.J. van Genderen

FILES
.putspicerc   (default) configuration file
HOME/.putspicerc        (altern.) configuration file
ICDPATH/lib/process/process/.putspicerc
	(altern.) configuration file
global_nets	(default) file to specify global nets
ICDPATH/lib/process/process/global_nets
	(altern.) file to specify global nets
/usr/tmp/x*	temporary files

SEE ALSO
"SPICE 3B1 User's Guide", Department of Electrical Engineering and Computer Sciences, University of California, Berkeley.
sls_mkdb(1ICD), sls(1ICD), nspice(1ICD), xspice(1ICD).