next up previous contents index
Next: The stats Command Up: Miscellaneous Commands Previous: The quit Command   Contents   Index


The rusage Command

The rusage command is used to obtain information about the consumption of system resources and other statistics during the WRspice session.

rusage [all] [resource ...]
If any resource keywords are given, only those resources are printed. All resources are printed if the keyword all is given. With no arguments, only total time and space usage are printed. The show command can also be used to obtain resource statistics. The recognized keywords are listed below.

The stats command is almost identical to rusage, and accepts the same keywords. The difference is that stats given without arguments will print all run statistics.

accept
This keyword prints the number of accepted time points from the last transient analysis.

cvchktime
Print the time spent checking for convergence in the most recent dc or transient analysis (including operating point).

elapsed
This keyword prints the total amount of time that has elapsed since the last call of the rusage or stats command with the elapsed keyword (explicit or implied with ``all''), or to the program start time.

equations
Print the number of nodes in the current circuit, including internally generated nodes. This includes the ground node so is one larger than the matrix size.

faults
This keyword prints the number of page faults and context switches seen by the program thus far. See also pagefaults, involcxswitch, and volcxswitch for the values that occurred during the last anslysis.

fillin
Print the number of fillins generated during matrix reordering and factoring. This is not available from KLU.

involcxswitch
This provides the number of involuntary context switches seen during the last analysis. If multiple threads are being used, this is the total for all threads.

loadtime
If given, print the time spent loading the matrix in the last simulation run. This includes the time spent in computation of device characteristics.

loadthrds
Report the number of threads used for device evaluation and matrix loading during the most recent dc (including operating point) or transient analysis. This would be at most the value of the loadthrds option variable in effect during the analysis, but is the number of threads actually used.

loopthrds
Report the number of threads in use for repetitive analysis in the most recent analysis run. This would be at most the value of the loopthrds option variable in effect during the analysis, but is the number of threads actually used.

lutime
The lutime keyword will print the time spent in LU factorization of the matrix during the last simulation run.

matsize
Print the size of the circuit matrix.

nonzero
Print the number of nonzero matrix elements.

pagefaults
Report the number of page faults seen during the most recent analysis.

rejected
This keyword prints the number of rejected time points in the last transient analysis.

reordertime
Print the time spent reordering the matrix for numerical stability in the most recent simulation.

solvetime
This will print the time spent solving the matrix equations, after LU decomposition, in the last simulation run.

space
This keyword will print the memory presently in use by WRspice.

time
This keyword will print the time used by the last simulation run.

totaltime
If this keyword is given, the total time used in the present session will be printed.

totiter
This keyword prints the total number of Newton iterations used in the last analysis.

trancuriters
This prints the number of Newton iterations used in the most recent transient analysis time point evaluation.

traniter
The traniter keyword will print the number of iterations used in the last transient analysis. This does not include iterations used in the operating point calculation, unlike totiter which includes these iterations.

tranitercut
The number if times that the most recent transient analysis had a time step cut by iteration count. If the itl4 limit is reached when attempting convergence at a transient time point, the timestep is cut and convergence is reattempted.

tranlutime
The time spent LU factoring the matrix in the most recent transient analysis, not including the dc operating point calculation.

tranouttime
Print the time spent saving output in the most recent transient analysis.

tranpoints
This keyword prints the number of internal time steps used in the last transient analysis.

transolvetime
This keyword prints the matrix solution time required by the last transient analysis, not including the operating point calculation.

trantime
This keyword will print the total time spent in transient analysis in the last transient analysis, not including the operating point calculation.

trantrapcut
This is the number of times in the most recent transient analysis that a timestep was cut due to the trapcheck algorithm. This may occur when the trapcheck variable is set, which enables a test to detect numerical problems in trapezoidal integration.

trantstime
Report the time spent computing the next timestep in the most recent transient analysis.

volcxswitch
This provides the number of voluntary context switches seen during the last analysis. If multiple threads are being used, this is the total for all threads.


next up previous contents index
Next: The stats Command Up: Miscellaneous Commands Previous: The quit Command   Contents   Index
Stephen R. Whiteley 2017-10-02