.OPTions Record

The .OPTion record is used to set certain operational aspects of CCICAP (see below) and to request information about the equation formulation used by CCICAP. The .OPTion record is parsed from left to right so that in the event of conflicting requests, the last request will dominate. Options may be placed in any order on the .OPTions record.

The following options and their actions are supported:

• TAB: Causes CCICAP to print out the variable headings for .AC, .DC, .VARY, and .TRAN analyses along with the generated tabular data to the ASCII output file. This is the default mode.
• NTAB: Causes CCICAP to print out the variable headings for .AC, .DC, .VARY, and .TRANsient analyses but to not print out the tabular data in the ASCII output file. This option might be used to suppress tabular data and reduce the size of the output file when high resolution plots are going to be produced and used as the primary output. It can also be used when the output is directed to the screen (using 'con' as the output file) and the user doesn't want to see the tabular data scroll by.
• HUSH: Suppresses informative messages to the console during the run.
• NHUSH: Enables informative messages to the console during the run. This is the default mode.
• FILE: Activates automatic creation of binary output data files. A .PLOT request will also activate the creation of binary data files. The data files will be created in the default directory and will have names given by
  • DATAmmnn.AC and/or DATAmmnn.TR and/or VARYmmnn.AC
  • where mm refers to the current circuit description and nn refers to the alteration number for the current circuit. The first analysis of a run generates files named DATA0000 and/or VARY0000. The first alteration of this circuit (see ALTEL and ALTGO records below) generates files named DATA0001 and/or VARY0001. The second circuit, defined after a .NEXT record, generates files named DATA01nn and/or VARY01nn. The data calculated during the AC analysis will be placed in DATAmmnn.AC and/or VARYmmnn.AC and the data produced during the TRANsient analysis will be placed in DATAmmnn.TR.
  • If a .FILE option or a .PLOT record is included in an input file, the title is saved to a file named as
  • TITLmmnn.TXT
  • where the mm and nn fields are incremented as described for the DATAmmnn files.
  • If no FILE option or .PLOT record is included in a circuit description, the binary data files are not produced. Data files from the individual analyses within a multiple analysis run can be controlled by the use of the FILE option. Binary data files are always produced if one or more .PLOT requests are made, as they are used after the analysis to produce the plots. The binary output data files can be used by post processors.
• NFILE: turns off the FILE option described above.
• DB: CCICAP will produce output from a requested AC analysis in dB and phase format. This is the default format.
• MAG: CCICAP will produce output from a requested AC analysis in magnitude and phase format.
• R&I: CCICAP will produce output from a requested AC analysis in real and imaginary format.
• HZ: CCICAP will use Hertz and degrees as the units of frequency and phase for AC analyses. These are the default units.
• RPS: CCICAP will use radians per second and radians as the units of frequency and phase for AC analyses.
• STEP: CCICAP will generate the step response for any requested TRansient analyses. This is the default.
• IMP: CCICAP will generate the impulse response for any requested TRansient analyses.
• SIZE: CCICAP will print out the following information about the circuit and the circuit description matrix:
  • #outs: number of requested outputs.
  • #ins: number of specified inputs.
  • #elem: number of elements in the circuit description.
  • nodes: number of user specified nodes in the circuit (does not include the ground node).
  • szmat: size of the circuit description matrix (number of equations).
  • order: order of the circuit.
• NSIZE: turns off the SIZE option described above.
• MAT: CCICAP will print out the circuit description matrices and the source vector. This option can produce copious amounts of output for large circuits and should be used accordingly.
• NMAT: turns off the MAT option described above.
• TXT: CCICAP will generate an ASCII data file for any requested analyses. The data files will be created in the default directory and will have names given by:
  • TEXTmmnn.AC and/or TEXTmmnn.TR and / or TEXTmmnn.NT
  • Where the mm and nn fields are as described under the FILE option. The file format is as follows:
  • Independent variable 1 [SP] data1 [SP] data2 [SP] ...[SP] dataN2.
  • Independent variable 2 [SP] data1 [SP] data2 [SP] ...[SP] dataN2.
  • ...
  • Independent variable N1 [SP] data1 [SP] data2 [SP] ...[SP] dataN2.
  • where Independent variable i is the i'th value of the independent variable (frequency or time), data1 through dataN2 are the corresponding values of the dependent variables, and [SP] is the user specified separation character (see description of OPTions entry SPnn below).
  • File TEXTmmnn.AC will contain the results of the AC analysis (if requested), file TEXTmmnn.TR will contain the results of the TRansient analysis (if requested), and file TEXTmmnn.NT will contain the unsorted results of the Noise Table analysis (if requested).
• NTXT: turns off the TXT option described above.
• SPnn: used to establish a separator character for use in the raw ASCII text files described in the TXT option above. The default separator character is a space. The field nn represents the hexadecimal value of an ASCII character. Recommended separators include:

nn	Separator
09	Tab
20	Space ' '
2C	Comma ','
3A	Colon ':'
3B	Semi-colon ';'

• STDIO: Causes CCICAP to report all numerical results to standard output. Normal informational messages to standard output are suppressed.
• NSTDIO: turns off the STDIO mode described above.

Options Record Examples:

.OPT SIZE * request information about formulation.

.OPT SIZE MAT * request above and the matrices.

.OPT FILE * create binary data files.

.OPT NTAB * suppress all tabular data printout.

.OPT SIZE MAT NTAB PLTP * all of the above.

.OPT MAG RPS * use magnitude and phase, radians per second and radians,

* for AC analysis units.

.OPT IMP MAG * impulse for TRansient response, magnitude for AC response.

.OPT TXT SP3A * produce raw ascii data files, use ';' as the field separator.