Cosine Waveform Source
The Cosine Waveform Source subcircuit models a time-varying source with a cosinusoidal voltage. At time=0, the source begins at the FINAL_VOLTAGE value and has a cosine function. The Cosine Waveform Source is not used in any test objectives, but you can change any source to a cosine source with a Cos() function call in a Source column.
Other similar sources include:
- Sine Source - similar to the Cosine Waveform Source but with a sine function.
In this topic:
| Model Name | Cosine Waveform Source | |
| Simulator |
|
This device is compatible with both the SIMetrix and SIMPLIS simulators. |
| Parts Selector Menu Location |
||
| Symbol Library | None - the symbol is automatically generated when placed or edited. | |
| Model File | SIMPLIS_DVM_ADVANCED.lb | |
| Subcircuit Name | SIMPLIS_DVM_ADVANCED_SOURCE_COS | |
| Symbols |
|
|
| Schematic |
|
|
Parameters
The following table explains the relevant parameters.
| Parameter Name | Default | Data Type | Range | Units | Parameter Description |
| COEFFICIENT | 0 | Real | The damping coefficient for the cosinusoidal source voltage. If non-zero, the cosinusoidal source voltage amplitude will decay with a time constant equal to ???MATH???\frac{1}{\text{COEFFICIENT}}???MATH???. | ||
| FINAL_VOLTAGE | 750m | Real | V | The peak to peak voltage for the source. This can be a numeric value or a symbolic value, such as a percentage of nominal input voltage. | |
| FREQUENCY | 10k | Real | min: > 0 | Hz | The frequency of the cosine waveform source |
| IDLE_IN_POP | 0 | Real | 0 or 1 | If set to 0, the source voltage during the POP analysis is set to the peak value of the source which is ???MATH???\frac{1}{2}\times\(text{FINAL_VOLTAGE}+\text{START_VOLTAGE}???MATH???; otherwise, the source will be active during the POP analysis. | |
| SOURCE_NAME | SRC | String | n/a | n/a | Name of the DVM source. This name cannot contain spaces. |
| OFF_UNTIL_DELAY | 0 | Real | 0 or 1 | If set to 1, the source voltage will be START_VOLTAGE until the time specified by TIME_DELAY. If set to 0, the value of TIME_DELAY is interpreted as a phase delay. | |
| PHASE_ANGLE | 90 | Real | ° | The phase angle of the cosinusoidal waveform, used only if the USE_PHASE parameter is 1. | |
| START_VOLTAGE | 0 | Real | V | The minimum or starting voltage for the cosine waveform source. This can be a numeric value or a symbolic value, such as a percentage of nominal input voltage. | |
| TIME_DELAY | 10u | Real | min: 0 | s | The delay before the cosinusoid starts. The source behavior before the TIME_DELAY is determined by the OFF_UNTIL_DELAY parameter. |
| USE_PHASE | 0 | Real | 0 or 1 | If set to 1, the source is configured to use the phase angle supplied by the PHASE_ANGLE parameter. |
Testplan Entry
To set any managed DVM source to a Cosine Waveform Source subcircuit, place a Cos() testplan entry in a Source column.
The Cos() testplan entry has the following syntax with the arguments taken from the list of parameters above.
Cos(REF, START_VOLTAGE, FINAL_VOLTAGE, FREQUENCY) Cos(REF, START_VOLTAGE, FINAL_VOLTAGE, FREQUENCY, OPTIONAL_PARAMETER_STRING)
| Argument | Range | Description |
| REF | n/a | The actual reference designator of the DVM source or the more generic syntax of INPUT:n where n is an integer indicating a position in the list of DVM sources. |
| START_VOLTAGE | n/a | The minimum or starting voltage for the cosine waveform source. This can be a numeric value or a symbolic value, such as a percentage of nominal input voltage. |
| FINAL_VOLTAGE | n/a | The peak or maximum voltage for the cosine wave source. This can be a numeric value or a symbolic value, such as a percentage of nominal input voltage. |
| FREQUENCY | min: > 0 | The frequency of the cosine waveform source. |
| OPTIONAL_PARAMETER_STRING | n/a | Parameter string with any of the other parameters from the parameter table above* |
* If multiple parameters are specified, join the parameter key-value pairs with a space, as shown in the examples below. The order of the parameter names does not matter.
Examples
The following three examples set the first DVM managed source to a Cosine Waveform Source with a minimum voltage of 0V and a peak voltage of 1V. The timing parameters and the optional parameter strings are different in each example.
Zero Time Delay Example
Since the TIME_DELAY parameter is set to zero in this example, the cosine wave begins with the FINAL_VOLTAGE value of 1V at t=0.
| *?@ Source |
|---|
| Cos(INPUT:1, 0, 1, 10k, TIME_DELAY=0) |
Time Delay Example
In this example, the TIME_DELAY parameter is set to 25us. Since the OFF_UNTIL_DELAY parameter is not specified, the TIME_DELAY value is interpreted as a phase delay. This results in the same waveform as a Sine Waveform Source.
| *?@ Source |
|---|
| Cos(INPUT:1, 0, 1, 10k, TIME_DELAY=25u) |
The results of this testplan entry are shown below:
Time Delay Example With OFF_UNTIL_DELAY=1
In this example, the TIME_DELAY parameter is set to 25us, and the OFF_UNTIL_DELAY is set to 1; therefore, for simulation times less than the TIME_DELAY parameter, the source voltage is 0.5V, as determined by the following equation: ???MATH???\frac{1}{2}\left(\text{START_VOLTAGE}+\text{FINAL_VOLTAGE}\right)???MATH???
| *?@ Source |
|---|
| Cos(INPUT:1, 0, 1, 10k, TIME_DELAY=25u OFF_UNTIL_DELAY=1) |
The results of this testplan entry are shown below:
