General Control Options

Descriptions of the general control options follow. The descriptions are alphabetical by keyword under the sections presented in the table.

Input and Output Options

 

ACCT

Reports job accounting and runtime statistics at the end of the output listing. Simulation efficiency is determined by the ratio of output points to total iterations. Reporting is automatic unless you disable it.

Choices for ACCT are:
0 disables reporting
1 enables reporting
2 enables reporting of MATRIX statistics

ACOUT

AC output calculation method for the difference in values of magnitude, phase and decibels for prints and plots. The default value equals 1.

 

The default value, ACOUT = 1, selects the Star-Hspice method, which calculates the difference of the magnitudes of the values. The SPICE method, ACOUT = 0, calculates the magnitude of the differences.

ALT999, ALT9999

This option generates up to 1000 (ALT999) or 10,000 (ALT9999) unique output files from .ALTER runs. Star-Hspice appends a number from 0-999 (ALT999) or 0-9999 (ALT9999) to the extension of the output file. For example, for a .TRAN analysis with 50 .ALTER statements, the filenames would be filename.tr0, filename.tr1, ..., filename.tr50. Without this option, the files would be overwritten after the 36th .ALTER.

BRIEF, NXX

Stops printback of the data file until an .OPTIONS BRIEF = 0 or the .END statement is encountered. It also resets the options LIST, NODE and OPTS while setting NOMOD. BRIEF = 0 enables printback. NXX is the same as BRIEF.

CO = x

Sets the number of columns for printout: x can be either 80 (for narrow printout) or 132 (for wide carriage printouts). You also can set the output width by using the .WIDTH statement. The default value equals 80.

INGOLD = x

Specifies the printout data format. Use INGOLD = 2 for SPICE compatibility. The default value equals 0.

Numeric output from Star-Hspice can be printed in one of three ways:

 

INGOLD = 0

Engineering format, exponents are expressed as a single character:

1G = 1e9 1X = 1e6 1K = 1e3 1M = 1e-3

1U = 1e-6 1N = 1e-9 1P = 1e-12 1F = 1e-15

 

INGOLD = 1

Combined fixed and exponential format (G Format). Fixed format for numbers between 0.1 and 999. Exponential format for numbers greater than 999 or less than 0.1.

 

INGOLD = 2

Exclusively exponential format (SPICE2G style). Exponential format generates constant number sizes suitable for post-analysis tools.

 

Use .OPTIONS MEASDGT in conjunction with INGOLD to control the output data format of .MEASURE results.

LENNAM = x

Specifies the maximum length of names in the operating point analysis results printout. The default value equals 8. The maximum value of x is 16.

LIST, VERIFY

Produces an element summary listing of the input data to be printed. Calculates effective sizes of elements and the key values. LIST is suppressed by BRIEF. VERIFY is an alias for LIST.

MEASDGT = x

Used for formatting of the .MEASURE statement output in both the listing file and the .MEASURE output files (. ma0 , . mt0 , . ms0 , and so on).

 

The value of x is typically between 1 and 7, although it can be set as high as 10. The default value equals 4.0.

For example, if MEASDGT = 5, numbers displayed by .MEASURE are displayed as:

  • Five decimal digits for numbers in scientific notation
  • Five digits to the right of the decimal for numbers between 0.1 and 999

In the listing (.lis), file, all .MEASURE output values are in scientific notation, so .OPTIONS MEASDGT = 5 results in five decimal digits.

 

Use MEASDGT in conjunction with .OPTIONS INGOLD = x to control the output data format.

NODE

Causes a node cross reference table to be printed. NODE is suppressed by BRIEF. The table lists each node and all the elements connected to it. The terminal of each element is indicated by a code, separated from the element name with a colon (:). The codes are as follows:

+ Diode anode
- Diode cathode
B BJT base
B MOSFET or JFET bulk
C BJT collector
D MOSFET or JFET drain
E BJT emitter

 

G MOSFET or JFET gate
S BJT substrate
S MOSFET or JFET source


For example, part of a cross reference might look like:
1 M1:B D2:+ Q4:B


This line indicates that the bulk of M1, the anode of D2, and the base of Q4 are all connected to node 1.

NOELCK

No element check; bypasses element checking to reduce preprocessing time for very large files.

NOMOD

Suppresses the printout of model parameters

NOPAGE

Suppresses page ejects for title headings

NOTOP

Suppresses topology check resulting in increased speed for preprocessing very large files

NUMDGT = x

Sets the number of significant digits printed for output variable values. The value of x is typically between 1 and 7, although it can be set as high as 10. The default value equals 4.0. This option does not affect the accuracy of the simulation.

NXX

Stops printback of the data file until an .OPTIONS BRIEF = 0 or the .END statement is encountered. It also resets the options LIST, NODE and OPTS while setting NOMOD. BRIEF = 0 enables printback. NXX is the same as BRIEF.

OPTLST = x

Outputs additional optimization information:

0 No information (default)
1 Prints parameter, Broyden update, and
bisection results information
2 Prints gradient, error, Hessian, and iteration
information
3 Prints all of the above and Jacobian

OPTS

Prints the current settings of all control options. If any of the default values of the options have been changed, the OPTS option prints the values actually used for the simulation. Suppressed by the BRIEF option.

PATHNUM

Prints subcircuit path numbers instead of path names.

PLIM = x

Specifies plot size limits for printer plots of current and voltage:

1 Finds a common plot limit and plots all
variables on one graph at the same scale
2 Enables SPICE-type plots, in which a separate
scale and axis are created for each plot variable

This option has no effect on graph data POST processing.

POST_VERSION = x

Sets the post-processing output version with values x = 9601 or 9007. x = 9007 truncates the node name in the post-processor output file to be no longer than 16 characters. x = 9601 sets the node name length for the output file to be consistent with the input restrictions (1024 characters).

POST_VERSION=2001

Sets the post-processing output version with value of 2001. When using this option, the user will see the new output file header which includes the right number of output variables rather than **** when the number exceeds 9999. If .option post_version=2001 post=2 is set in the netlist, then the user will receive more accurate ascii results.

The syntax is:

.option post_version=2001

SEARCH

Sets the search path for libraries and included files. Star-Hspice automatically looks in the directory specified with .OPTIONS SEARCH for libraries referenced in the simulation.

VERIFY

Produces an element summary listing of the input data to be printed. Calculates effective sizes of elements and the key values. LIST is suppressed by BRIEF. VERIFY is an alias for LIST.

CPU Options

CPTIME = x

Sets the maximum CPU time, in seconds, allotted for this job. When the time allowed for the job exceeds CPTIME, the results up to that point are printed or plotted and the job is concluded. Use this option when uncertain about how long the simulation will take, especially when debugging new data files. Also see LIMTIM. The default value equals 1e7 (400 days).

EPSMIN = x

Specifies the smallest number that can be added or subtracted on a computer, a constant value. The default value equals 1e-28.

EXPMAX = x

Specifies the largest exponent you can use for an exponential before overflow occurs. Typical value for an IBM platform is 350.

LIMTIM = x

Sets the amount of CPU time reserved for generating prints and plots in case a CPU time limit (CPTIME = x) causes termination. The default value equals 2 (seconds). This default is normally sufficient time for short printouts and plots.

Interface Options

ARTIST = x

ARTIST = 2 enables the Cadence Analog Artist interface. This option requires a specific license.

CDS, SDA

CDS = 2 produces a Cadence WSF ASCII format post-analysis file for Opus™. This option requires a specific license. SDA is the same as CDS.

CSDF

Selects Common Simulation Data Format (Viewlogic-compatible graph data file format)

MEASOUT

O utputs .MEASURE statement values and sweep parameters into an ASCII file for post-analysis processing by AvanWaves or other analysis tools. The output file is named <design>.mt#, where # is incremented for each .TEMP or .ALTER block. For example, for a parameter sweep of an output load, measuring the delay, the .mt# file contains data for a delay versus fanout plot. The default value equals 1. You can set this option to 0 (off) in the hspice.ini file.

MENTOR = x

MENTOR = 2 enables the Mentor MSPICE-compatible ASCII interface. Requires a specific license.

POST = x

Enables storing of simulation results for analysis using the AvanWaves graphical interface or other methods.POST = 1 saves the results in binary. POST = 2 saves the results in ASCII format. POST = 3 saves the results in New Wave binary format. Set the POST option, and use the .PROBE statement to specify which data you want saved. The default value equals 1.

PROBE

Limits the post-analysis output to just the variables designated in .PROBE, .PRINT, .PLOT, and .GRAPH statements. By default, Star-Hspice outputs all voltages and power supply currents in addition to variables listed in .PROBE/.PRINT/.PLOT/.GRAPH statements. Use of PROBE significantly decreases the size of simulation output files.

PSF = x

Specifies whether Star-Hspice outputs binary or ASCII when Star-Hspice is run from Cadence Analog Artist. The value of x can be 1 or 2. If x is 2, Star-Hspice produces ASCII output. If .OPTIONS ARTIST PSF = 1, Star-Hspice produces binary output.

SDA

CDS = 2 produces a Cadence WSF ASCII format post-analysis file for Opus. This option requires a specific license. SDA is the same as CDS.

ZUKEN = x

If x is 2, enables the Zuken interactive interface. If x is 1, disables it. The default value equals 1.

Analysis Options

ASPEC

Sets Star-Hspice into ASPEC compatibility mode. With this option set, Star-Hspice can read ASPEC models and netlists and the results are compatible. The default value equals 0 (Star-Hspice mode).

 

Note: When the ASPEC option is set, the following model parameters default to ASPEC values:

ACM = 1: Default values for CJ, IS, NSUB,
TOX, U0, UTRA are changed.
Diode Model:
TLEV = 1 affects temperature compensation
of PB.
MOSFET Model:
TLEV = 1 affects PB, PHB, VTO, and PHI.

SCALM, SCALE:
Sets model scale factor to microns for
length dimensions.
WL: Reverses implicit order on MOSFET
element of width and length.

LIMPTS = x

Sets the total number of points that you can print or plot in AC analysis. It is not necessary to set LIMPTS for DC or transient analysis, as Star-Hspice spools the output file to disk. The default value equals 2001.

PARHIER

Selects the parameter passing rules that control the evaluation order of subcircuit parameters. They only apply to parameters with the same name at different levels of subcircuit hierarchy. The options are:

LOCAL During analysis of a subcircuit, a
parameter name specified in the subcircuit
prevails over the same parameter name
specified at a higher hierarchical level.

GLOBAL A parameter name specified at a higher
hierarchical level prevails over the same
parameter name specified at a lower level.

SPICE

Makes Star-Hspice compatible with Berkeley SPICE. When the option SPICE is set, the following options and model parameters are used:

		Example of general parameters used with .OPTIONS SPICE:
		TNOM = 27 DEFNRD = 1 DEFNRS = 1 INGOLD = 2
		ACOUT = 0 DC
		PIVOT PIVTOL = IE-13 PIVREL = 1E-3 RELTOL = 1E-3 
		ITL1 = 100
		ABSMOS = 1E-6 RELMOS = 1E-3 ABSTOL = 1E-12
		VNTOL = 1E-6
		ABSVDC = 1E-6 RELVDC = 1E-3 RELI = 1E-3
		Example of transient parameters used with .OPTIONS SPICE:
		DCAP = 1 RELQ = 1E-3 CHGTOL-1E-14 ITL3 = 4 ITL4 = 10
		ITL5 = 5000
		FS = 0.125 FT = 0.125
		Example of model parameters used with .OPTIONS SPICE:
		For BJT: MJS = 0
		For MOSFET, CAPOP = 0
		LD = 0 if not user-specified
		UTRA = 0 not used by SPICE for LEVEL = 2
		NSUB must be specified
		NLEV = 0 for SPICE noise equation

SEED

User-specified random number generator starting seed for Monte Carlo analysis. The minimum value is 1 and maximum value is 259200.

Error Options

BADCHR

Generates a warning when a nonprintable character is found in an input file.

DIAGNOSTIC

L ogs the occurrence of negative model conductances.

NOWARN

Suppresses all warning messages except those generated from statements in .ALTER blocks.

WARNLIMIT = x

Limits the number of times that certain warnings appear in the output listing, thus reducing output listing file size. The value of x is the total number of warnings allowed for each warning type. The types of warning messages this limit applies to are:

  • MOSFET has negative conductance
  • Node conductance is zero
  • Saturation current is too small
  • Inductance or capacitance is too large

The default value equals 1.

Version Options

H9007

Sets general control option default values to correspond to the values for Star-Hspice Release H9007D. The EXPLI model parameter is not used when this option is set.

Star-Hspice Manual - Release 2001.2 - June 2001