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
DVM > Sources > DVM Input Source
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 or maximum 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 FINAL_VOLTAGE; 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 ???MATH???\frac{1}{2}\left(\text{START_VOLTAGE}+\text{FINAL_VOLTAGE}\right)???MATH??? 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.

Note: In all of the examples below, the Source column is the first column in the testplan and, therefore, begins with the special three character sequence: *?@.

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)
The results of this testplan entry are shown below:

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: