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:

In this Topic Hide

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:

 

© 2015 simplistechnologies.com | All Rights Reserved