Execute an instruction¶
The method SLiCAPinstruction.instruction.execute() executes the instruction and returns a SLiCAPprotos.allResults() object with attributes comprising instruction data and instruction results. See SLiCAPprotos.allResults().
Execution results¶
At the start of the execution, attributes from the instance of the SLiCAPinstruction.instruction() object are copied to corresponding attributes of the SLiCAPprotos.allResults() object. All copies, except that of the SLiCAPinstruction.instruction.circuit attribute are deep copies.
In the following sections we will describe the attributes that carry the execution results. We will do this for all data types.
Data type dc¶
Calculates the DC value of the detector quantity; only for gain type ‘vi’.
If parameter stepping is enabled:
A list with dc values (float, sympy.Symbol, symPy.Expr) is assigned to SLiCAPprotos.allResults.dc
If parameter stepping is disabled:
The dc value (float, sympy.Symbol, symPy.Expr) is assigned to SLiCAPprotos.allResults.dc
Data type dcsolve¶
Calculates DC solution of the network; only for gain type ‘vi’.
If parameter stepping is enabled:
A list with dc solutions (symPy.Matrix) is assigned to SLiCAPprotos.allResults.dcSolve
If parameter stepping is disabled:
The dc solution (symPy.Matrix) is assigned to SLiCAPprotos.allResults.dcSolve
Data type dcvar¶
Calculates contribution of all dc variances (sources and resistors) to the detector-referred variance. Only for gain type ‘vi’. If a signal source has been defined it also calculates the contibutions to the source-referred variance.
If parameter stepping is enabled:
A list with values of the total detector-referred variance (float, sympy.Symbol, symPy.Expr) is assigned to SLiCAPprotos.allResults.ovar
A dict with key-value pairs is assigned to SLiCAPprotos.allResults.ovarTerms
key: Name of the source (str)
value: List with contributions of source to the detector-referred variance (float, sympy.Symbol, symPy.Expr)
If a signal source has been defined:
A list with values of the total source-referred variance (float, sympy.Symbol, symPy.Expr) is assigned to SLiCAPprotos.allResults.ivar
A dict with key-value pairs is assigned to SLiCAPprotos.allResults.ivarTerms
key: Name of the source (str)
value: List with contributions of this source to the source-referred variance (float, sympy.Symbol, symPy.Expr)
If parameter stepping is disabled:
The total detector-referred variance (float, sympy.Symbol, symPy.Expr) is assigned to SLiCAPprotos.allResults.ovar
A dict with key-value pairs is assigned to SLiCAPprotos.allResults.ovarTerms
key: Name of the source (str)
value: Contributions of this source to the detector-referred variance (float, sympy.Symbol, symPy.Expr)
If a signal source has been defined:
The total source-referred variance (float, sympy.Symbol, symPy.Expr) is assigned to SLiCAPprotos.allResults.ivar
A dict with key-value pairs is assigned to SLiCAPprotos.allResults.ivarTerms
key: Name of the source (str)
value: Contributions this source to the source-referred variance (float, sympy.Symbol, symPy.Expr)
Data type denom¶
Calculates the denominator of the Laplace Transform of the unit-impulse response or of a voltage or a current.
If parameter stepping is enabled:
A list with results (float, sympy.Expr) is assigned to SLiCAPprotos.allResults.denom
If parameter stepping is disabled:
The result (float, sympy.Expr) is assigned to SLiCAPprotos.allResults.denom
Data type impulse¶
Calculates the unit-impulse response (inverse Laplace Transform); may not work with symbolic values. Not for gain type ‘vi’.
If parameter stepping is enabled:
A list with results (float, sympy.Expr) is assigned to SLiCAPprotos.allResults.impulse
If parameter stepping is disabled:
The result (float, sympy.Expr) is assigned to SLiCAPprotos.allResults.impulse
Data type laplace¶
Calculates the Laplace transfer function (Laplace transform of the unit-impulse response) or the Lapalce tarsnform of a voltage or a current.
If parameter stepping is enabled:
A list with results (float, sympy.Expr) is assigned to SLiCAPprotos.allResults.laplace
If parameter stepping is disabled:
The result (float, sympy.Expr) is assigned to SLiCAPprotos.allResults.laplace
Data type matrix¶
Calculates the matrix equation of the circuit and applies the specified conversion.
If parameter stepping is disabled:
The vector with independent variables (sympy.Matrix) is assigned to SLiCAPprotos.allResults.Iv
The vector with dependent variables (sympy.Matrix) is assigned to SLiCAPprotos.allResults.Dv
The MNA matrix (sympy.Matrix) is assigned to SLiCAPprotos.allResults.M
Parameter stepping with data type ‘matrix’ is not supported.
Data type noise¶
Calculates contributions to the detector-referred noise of all noise sources. Only for gain type ‘vi’. If a signal source has been defined it also calculates the contibutions to the source-referred noise.
If parameter stepping is enabled:
A list with values of the total detector-referred noise spectral density in \(\left[\mathrm{\frac{V^2}{Hz}}\right]\) or \(\left[\mathrm{\frac{A^2}{Hz}}\right]\) (float, sympy.Symbol, symPy.Expr) is assigned to SLiCAPprotos.allResults.onoise
A dict with key-value pairs is assigned to SLiCAPprotos.allResults.onoiseTerms
key: Name of the source (str)
value: List with contributions of this source to the detector-referred noise spectral density in \(\left[\mathrm{\frac{V^2}{Hz}}\right]\) or \(\left[\mathrm{\frac{A^2}{Hz}}\right]\) (float, sympy.Symbol, symPy.Expr)
If a signal source has been defined:
A list with values of the total source-referred noise spectral density in \(\left[\mathrm{\frac{V^2}{Hz}}\right]\) or \(\left[\mathrm{\frac{A^2}{Hz}}\right]\) (float, sympy.Symbol, symPy.Expr) is assigned to SLiCAPprotos.allResults.inoise
A dict with key-value pairs is assigned to SLiCAPprotos.allResults.inoiseTerms
key: Name of the source (str)
value: List with contributions of this source to the source-referred noise spectral density in \(\left[\mathrm{\frac{V^2}{Hz}}\right]\) or \(\left[\mathrm{\frac{A^2}{Hz}}\right]\) (float, sympy.Symbol, symPy.Expr)
If parameter stepping is disabled:
The total detector-referred noise spectral density in \(\left[\mathrm{\frac{V^2}{Hz}}\right]\) or \(\left[\mathrm{\frac{A^2}{Hz}}\right]\) (float, sympy.Symbol, symPy.Expr) is assigned to SLiCAPprotos.allResults.onoise
A dict with key-value pairs is assigned to SLiCAPprotos.allResults.onoiseTerms
key: Name of the source (str)
value: Contributions of this source to the detector-referred noise spectral density in \(\left[\mathrm{\frac{V^2}{Hz}}\right]\) or \(\left[\mathrm{\frac{A^2}{Hz}}\right]\) (float, sympy.Symbol, symPy.Expr)
If a signal source has been defined:
The total source-referred noise spectral density in \(\left[\mathrm{\frac{V^2}{Hz}}\right]\) or \(\left[\mathrm{\frac{A^2}{Hz}}\right]\) (float, sympy.Symbol, symPy.Expr) is assigned to SLiCAPprotos.allResults.noise
A dict with key-value pairs is assigned to SLiCAPprotos.allResults.inoiseTerms
key: Name of the source (str)
value: Contributions of this source to the source-referred noise spectral density in \(\left[\mathrm{\frac{V^2}{Hz}}\right]\) or \(\left[\mathrm{\frac{A^2}{Hz}}\right]\) (float, sympy.Symbol, symPy.Expr)
Data type numer¶
Calculates the numerator of the Laplace Transform of the unit-impulse response or of a voltage or a current.
If parameter stepping is enabled:
A list with results (float, sympy.Expr) is assigned to SLiCAPprotos.allResults.numer
If parameter stepping is disabled:
The result (float, sympy.Expr) is assigned to SLiCAPprotos.allResults.numer
Data type params¶
Calculates the values of parameters, while sweeping or stepping other parameters. This data type should be used when plotting parameters against each other. Only the copied instruction data is returned.
Data type poles¶
Calculates the complex solutions of the denominator of the Laplace transfer function. It may not work with symbolic parameters and it not implemented for dataType vi.
If parameter stepping is enabled:
A list of lists with solutions (complex) is assigned to SLiCAPprotos.allResults.poles
If parameter stepping is disabled:
A list with solutions (complex) is assigned to SLiCAPprotos.allResults.poles
Data type pz¶
Calculates the complex solutions of the numerator and of the denominator of the Laplace Transform of the unit-impulse response and the zero-frequency value of the transfer. Poles and zeros with the same frequency cancel each other out. It may not work with symbolic parameters and it not implemented for dataType vi.
note
pole-zero pairs with equal complex frequencies (tolerance = \(10^{\mathrm{-ini.disp}}\)) are removed from the results.
If parameter stepping is enabled:
A list of lists with solutions (complex) of the denominator is assigned to SLiCAPprotos.allResults.poles
A list of lists with solutions (complex) of the numerator is assigned to SLiCAPprotos.allResults.zeros
A list with zero-frequency values (float) of the transfer is assigned to SLiCAPprotos.allResults.DCvalue
If parameter stepping is disabled:
A list with solutions (complex) of the denominator is assigned to SLiCAPprotos.allResults.poles
A list with solutions (complex) of the numerator is assigned to SLiCAPprotos.allResults.zeros
The zero-frequency values (float) of the transfer is assigned to SLiCAPprotos.allResults.DCvalue
Data type solve¶
Calculates the network solution; only for gain type ‘vi’.
If parameter stepping is enabled:
A list with solutions (symPy.Matrix) is assigned to SLiCAPprotos.allResults.solve
If parameter stepping is disabled:
The solution (symPy.Matrix) is assigned to SLiCAPprotos.allResults.solve
Data type step¶
Calculates inverse Laplace transform of (1/s) times the transfer function. It may not work with symbolic values.
If parameter stepping is enabled:
A list with results (float, sympy.Expr) is assigned to SLiCAPprotos.allResults.stepResp
If parameter stepping is disabled:
The result (float, sympy.Expr) is assigned to SLiCAPprotos.allResults.stepResp
Data type time¶
Calculates inverse Laplace transform of a detector voltage or current. Only for gain type ‘vi’. It may not work with symbolic values.
If parameter stepping is enabled:
A list with results (float, sympy.Expr) is assigned to SLiCAPprotos.allResults.time
If parameter stepping is disabled:
The result (float, sympy.Expr) is assigned to SLiCAPprotos.allResults.time
Data type zeros¶
Calculates the complex solutions of the numerator of the Laplace transfer function. It may not work with symbolic parameters and it not implemented for dataType vi.
If parameter stepping is enabled:
A list of lists with solutions (complex) is assigned to SLiCAPprotos.allResults.poles
If parameter stepping is disabled:
A list with solutions (complex) is assigned to SLiCAPprotos.allResults.poles