DVM - Design Verification Module

Sine Waveform Source

The Sine Waveform Source subcircuit models a time-varying source with a sinusoidal voltage. At time=0, the source starts at $\frac{1}{2}\left(\text{START_VOLTAGE}+\text{FINAL_VOLTAGE}\right)$, and has a sine-wave function. The sine source is not used in any test objectives. You can change any source to a Sine Waveform Source with a Sin() call in a Source column.

Other similar sources include:

Cosine Source - Same as a Sine Waveform Source but with a Cosine function.

In this Topic ShowHide

Parameters
Testplan Entry
Examples

Model Name	Sine Waveform Source
Simulator		This device is compatible with both the SIMetrix and SIMPLIS simulators.
Parts Selector Menu Location	DVM ▶Sources ▶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_SIN
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 sinusoidal source voltage. If non-zero, the sinusoidal source voltage amplitude will decay with a time constant equal to$\frac{1}{\text{COEFFICIENT}}.
FINAL_VOLTAGE	750m	Real		V	The peak or maximum voltage for the sine wave 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 source pulse
IDLE_IN_POP	0	Real	0 or 1		If set to 0, the source voltage during the POP analysis is set to the START_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 $\frac{1}{2}\left(\text{START_VOLTAGE}+\text{FINAL_VOLTAGE}\right)$ 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 sinusoidal waveform, used only if the USE_PHASE parameter is 1.
START_VOLTAGE	0	Real		V	The minimum or starting voltage for the sine 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 sinusoid 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 Sine Waveform Source subcircuit, place a Sin() testplan entry in the Source column.

The Sine Waveform Source testplan entry has the following syntax with the arguments taken from the list of parameters above.

Sin(REF, START_VOLTAGE, FINAL_VOLTAGE, FREQUENCY)
Sin(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 managed DVM sources.
START_VOLTAGE	n/a	The minimum or starting voltage for the sine 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 sine 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 sine wave 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 examples set the first DVM managed source to a Sine Waveform Source with a minimum voltage of 0V and a peak voltage of 1V. The timing parameters and the optional parameter strings are different for each example.

Zero Time Delay Example

The TIME_DELAY parameter is set to zero, resulting in a sine wave which starts at the calculated value of $\frac{1}{2}\left(\text{START_VOLTAGE}+\text{FINAL_VOLTAGE}\right)$ at t=0.

*?@ Source
Sin(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 is interpreted as a phase delay.

*?@ Source
Sin(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: $\frac{1}{2}\left(\text{START_VOLTAGE}+\text{FINAL_VOLTAGE}\right)$

*?@ Source
Sin(INPUT:1, 0, 1, 10k, TIME_DELAY=25u OFF_UNTIL_DELAY=1)

The results of this testplan entry are shown below: