PWLR - PWL Controlled Source (Differential IO)
Model Kind
General
Model Sub-Kind
Generic Editor
SPICE Prefix
A
Model Name
PWL
SPICE Netlist Template Format
@DESIGNATOR %%vd(%1,%2) %%vd(%3,%4)@"DESIGNATOR"PWL
.MODEL @"DESIGNATOR"PWL pwl (x_array =[@x_array] y_array =[@y_array] ?input_domain|input_domain=@input_domain| ?fraction|fraction=@fraction|)
Parameters (definable at component level)
The following component-level parameters are definable for this model type and are listed on the Parameters tab of the Sim Model dialog. To access this dialog, simply double-click on the entry for the simulation model link in the Models region of the Component Properties dialog.
| x_array | x-element array. Enter a list of progressively increasing values, using spaces as separators. At least two values must be entered for the array. |
| y_array | y-element array. Enter a list of values, using spaces as separators. At least two values must be entered for the array. |
| input_domain | input smoothing domain. Enter a value in the range 1.0e-12 to 0.5 (Default = 0.01). |
| fraction | used to control whether the smoothing domain is specified as a fractional (TRUE) or absolute (FALSE) value. (Default = TRUE). |
Notes
The function of this model is to take the input signal and provide an output that is dependent on a piece-wise linear waveform, as defined by coordinate values specified in the x_array and y_array parameters.
The x_array parameter values are input coordinate points (progressively increasing), while the y_array parameter values represent the corresponding outputs at those points. You could think of the function as being analogous to a look-up table, where the input signal amplitude is mapped to the corresponding input value in the x_array and then the y_array value that this is paired with, is used for the output signal.
For values of the input signal that are smaller than the first element value of x_array and greater than that of the last, the function uses the lowest and highest two coordinate pairs respectively and extends the slope between each. The function is therefore perfectly linear before the first coordinate and after the last coordinate specified by the arrays.
The PWL function does not have inherent output limiting. Care should therefore be taken as it is quite possible to end up with excessively large or small outputs for larger values of input.
The use of the smoothing domain around each coordinate point in the defined PWL waveform, reduces the possibility of non-convergence. Inherent checking of the value entered for the input_domain parameter is carried out by the model, so that overlap of smoothing domains does not result from too high a value being specified.
Care should be taken when using the smoothing domain as a fractional value (fraction = TRUE), as excessive smoothing can result if the coordinates specified in the x_array and y_array parameters are inappropriate.
The input signal can be either a differential current or differential voltage signal.
Example
Consider the PWL function in the above image, with the following characteristics:
- Pin1 (positive input) is connected to net
In1 - Pin2 (negative input) is connected to net
In2 - Pin3 (positive output) is connected to net
Out - Pin4 (negative output) is connected to net
GND - Designator is
U1 - x_array =
-6 -5 -4 -3 -2 -1 0 1 2 3 4 5 6 - y_array =
-6 -6 -6 -6 -6 -6 0 6 6 6 6 6 6 - input_domain =
0.1 - fraction =
FALSE
The entry in the SPICE netlist would be:
*Schematic Netlist:
AU1 %vd(IN1,IN2) %vd(OUT,0)AU1PWL
.MODEL AU1PWL pwl (x_array =[-6 -5 -4 -3 -2 -1 0 1 2 3 4 5 6] y_array =[-6 -6 -6
+ -6 -6 -6 0 6 6 6 6 6 6] input_domain=0.1 fraction=FALSE)
The effect of the function can be seen in the resultant waveforms obtained by running a transient analysis of the circuit.
In this example, the following analysis parameters on the Transient/Fourier Analysis page of the Analyses Setup dialog have been used:
- Transient Start Time - set to
0.000 - Transient Stop Time - set to
50.00m - Transient Step Time - set to
200.0u - Transient Max Step Time - set to
200.0u