Using Netlist Input Files

This section describes how to use standard Star-Hspice netlist input files.

Input Netlist File ( <design>.sp ) Guidelines

Star-Hspice operates on an input netlist file and stores results in either an output listing file or a graph data file. The Star-Hspice input file, with the name <design>.sp (although the filename can be anything, we recommend this form for clarity) , contains the following:

Input netlist and library input files are generated by a schematic netlister or with a text editor.

Statements in the input netlist file can be in any order, except that the first line is a title line, and the last .ALTER submodule must appear at the end of the file before the .END statement.


NOTE: If there is no .END statement at the end of the input netlist file or no carriage return after the .END statement, an error message is issued.

Input Line Format

Names

           !   #   $   %    *    +    -    /    <    >    [   ]   _

Delimiters

Nodes

Instance Names

Hierarchy Paths

Numbers

Parameters and Expressions

Input Netlist File Structure

A Star-Hspice input netlist file should consist of one main program and one or more optional submodules. Use a submodule (preceded by an .ALTER statement) to automatically change an input netlist file and rerun the simulation with different options, netlist, analysis statements, and test vectors.

You can use several high-level call statements to restructure the input netlist file modules. These are the .INCLUDE, .LIB and .DEL LIB statements. These statements can call netlists, model parameters, test vectors, analysis, and option macros into a file from library files or other files. The input netlist file also can call an external data file that contains parameterized data for element sources and models.

Schematic Netlists

Star-Hspice circuits typically are generated from schematics by netlisters. Star-Hspice accepts either hierarchical or flat netlists. The normal SPICE netlisters flatten out all subcircuits and rename all nodes to numbers. Avoid flat netlisters if possible.

The process of creating a schematic involves:

Input Netlist File Sections and Chapter References

Sections

Examples

Ch

Definition

Title

.TITLE

3

The first line is the input netlist file title

Set-up

.OPTIONS

9

Sets conditions for simulation

.IC or .NODESET

10

Initial values in circuit and subcircuit

.PARAM

7

Set parameter values in the netlist

.GLOBAL

7

Set node name globally in netlist

Sources

Sources (I or V) and digital inputs

5

Sets input stimuli

Netlist

Circuit elements

3-4

Circuit for simulation

.SUBKCT, .ENDS

3

Subcircuit definitions

Analysis

.DC, .TRAN, .AC, etc.

10-12

Statements to perform analyses

.SAVE and .LOAD

10

Save and load operating point info

.DATA

3

Create table for data-driven analysis

.TEMP

3

Set analysis temperature

Output

.PRINT, .PLOT, .GRAPH, .PROBE

8

Statements to output variables

.MEASURE

8

Statement to evaluate and report user-defined functions of a circuit

Library, Model and File Inclusion

 

.INCLUDE

3

General include files

.MODEL

3, 8

Element model descriptions

.LIB

3

Library

.<UN>PROTECT

3

Control printback to output listing

Alter blocks

.ALTER

3

Sequence for in-line case analysis

.DELETE LIB

3

Removes previous library selection

End of netlist

.END

3

Required statement to end the netlist

Star-Hspice Manual - Release 2001.2 - June 2001