Documentation Home Page HYPERSIM Home Page
Pour la documentation en FRANÇAIS, utilisez l'outil de traduction de votre navigateur Chrome, Edge ou Safari. Voir un exemple.

AC V Source, Programmable

Description

Programmable variable sources (PVS) allow the user to set their own times and durations in some models. A variable voltage source has a series-connected RLC impedance.

Table of Contents

The RLC impedance elements can be connected either in series or parallel, and at least one of the RLC values must not be null. Above figure shows the icon and the diagram used to represent the programmable variable voltage sources.

Mask and Parameters


  • General Controls tab
NameDescriptionUnit
Source status (Enable/Disable)To enable or disable the source
Starting mode (Slow/Fast)If “Fast”, the source is immediately activated or deactivated.  If “Slow”, when the source is activated, the amplitude of the source increases linearly from zero to the steady-state value. When the source is deactivate, the amplitude of the source decreases linearly from the steady-state value to zero. -
Base MVABase power per phase in MVAMVA
Base VoltBase voltage phase to the ground in kilovoltkilovolt
Base FreqBase frequency in hertzhertz
RLC typeSeries (series R, L, C) or parallel (parallel R, L, C)-
Frequency Source frequencyHz
Phase sequence
  • 1 Direct or Inverse (positive or negative): In this mode, a constant differential of 120 degrees is maintained between the phases when the phase angle is changed by entering the value in the field or by adjusting the appropriate hand on the dial. All the fields are reset and all the hands are repositioned to maintain this 120 degrees differential. The only difference between the positive and negative sequences is that in the latter, the signs for phases b and c are inverted.
  • 2 Zero (homopolar): Here, a, b and c are in phase. Their differential is zero. When a field is modified or a dial handle is set, the other two phases automatically take the same value and the same position.
  • 3 Per phase. The “Per phase” mode allows users to define the same angle for the phases selected using a checkmark. The other phases are not involved. If many phases are selected, modifying a field or setting a dial handle for one phase automatically brings the other phases to the same value and position.

ModulePeak value of the amplitude for the source voltage in volts (or PU) volts (or PU)
DC offsetDirect current superimposed on the source signal.
Angle Angle of each phase in degrees. The value of the angles can be modified either by directly entering the numerical values in the appropriate fields or by adjusting the hands on the dial. The input of the angle varies as a function of the sequence selected in the Source Control sectiondegrees
RResistance value in ohms (or PU) for each phase (in order: a b c)ohms (or pu)
LInductance value in henry (or PU) for each phase (in order: a b c)henry (or pu)
CCapacitor value in farad (or PU) for each phase (in order: a b c)farad (or pu)

Synchronization (None/Internal): The synchronization of a source means that a programmed sequence of events will start with the rising front of a synchronizing signal. The synchronization is linked with the start of programming (Start/Stop) and the repetitive mode. The operations must be initiated in ScopeView (see Figure 4 - 8) for the synchronization signals to take effect. See the paragraph on the repetitive mode (further down) for a description of the synchronization effects.

At the time this manual was written, the source could only be synchronized internally (POW). The option of synchronizing with an external signal is planned (External).

Programming status (Start/Stop)Allows or prohibits the starting of programmed sequences of events. The effect depends on the synchronization and repetitive mode. See the paragraph on the repetitive mode for a description of the Start effects.
Repetitive (Enable/Disable)The repetitive mode allows users to repeat a programmed sequence of events indefinitely
DisableThe repetitive mode is not selected and the sequence of events will be executed only once according to the following conditions (Start button must be pressed)


Operations (ScopeView)Synch OFFSynch ON
Operation sequence OFF

Manual mode: The sequence is initiated as soon as the Start button is pressed and is executed only once.

To restart, press Stop, followed by Start
The sequence is never initiated.
Operation sequence ONThe sequence is initiated with the rising front of the synch signals (the Start button must be pressed) and is executed only once. A synch signal is required to repeat.
In this table, the modes switching/no switching and the modes asynchronized/synchronized come from the ScopeView acquisition parameters.

When Enabled, the programmed sequence of events will be repeated indefinitely according to the following conditions:

Operations (ScopeView)Synch OFFSynch ON
Operation sequence OFF

Manual mode: The sequence is initiated as soon as the Start button is pressed and is executed until the Stop button is pressed.

To restart, press Start

The sequence is never initiated.
Operation sequence ON

The sequence is initiated with the rising front of the synch signals (the Start button must be pressed) and is executed indefinitely thereafter until the stop button is pressed

The subsequent synch signals are ignored. To reactivate, press Start again.

Programming status (Enable/Disable): If Enabled, the programmed sequence of events is displayed in the windows where HYPERSIM® was launched.

ScopewView Acquisition Parameters

Timed Variation Programming (Control Panel - Timed variation)

Timed variations allow users to program sequences of events affecting the steady-state of the source, as defined by the settings for the amplitude, phase, frequency, and DC component on page General of the control panel.

It is possible to vary the amplitude, phase angle, frequency, and DC component of the source. These variations can be in modulation form (sinusoidal or random), step, ramp, or staircase. It is possible to execute some variations simultaneously. For example, the amplitude and frequency of a source can be made to vary in the same period of time. It is also possible to apply simultaneously a modulation and a ramp.

The activation of the variations is controlled by the Enable/Disable buttons on the page Timed variation of the control panel. Enable allows the execution of the variations, while Disable prohibits the application of the variations, but the programming values are saved.

Modulations

Modulation induces a sine or random variation of the selected parameter. Sinusoidal modulation can be applied to the amplitude, the frequency or the phase angle of a source, but for only one of these parameters at a time. Random modulation only applies to the amplitude of the source. It is possible to program other events, such as steps or ramps during a source modulation.

The random modulation periodically adds or subtracts a constant value to the value to be modulated.

The choice of adding or subtracting is random and the probability of each is 50%.

Modulation types: Allows users to select the parameter to modulate 

NoneNo modulation (the parameters already entered are kept)
AmplitudeSinusoidal modulation of the amplitude
FrequencySinusoidal modulation of the frequency
PhaseSinusoidal modulation of the phase angle
RandomRandom modulation of the amplitude

Parameters for the sinusoidal modulation:

AmplitudeAmplitude of the modulation sine
FrequencyFrequency of the modulation sine
PhasePhase of the modulation sine
TimingStart and end times of a modulation. The steady-state applies before and after the modulation period

Parameters for the random amplitude modulation:

  • Amplitude: Value to add to or subtract from the quantity modulated.
  • Frequency and phase: Not used.
  • Timing: Start (B) and end (E) times of the modulation and period (t) (multiple of) time step between successive calculations of the random signal. This period (B/E/I) must be greater than the calculation step selected for simulation. 

Example of amplitude modulation
In the General controls page (see Figure 4 - 7), enter the parameters as follows:

  • Module: 1 V peak
  • Angle: 0 deg.
  • DC offset: 0V
  • Frequency: 10Hz
  • Phase sequence: Direct
  • Source status: Enable
  • Starting mode: Slow
  • Programming: Start
  • Repetitive: Disable

Note: This mode, when Enabled, leaves the program variation running forever after the first Synchronization signal received (from Scopeview). To stop it, you have to toggle the parameters Programming from Start to Stop.

Programming: Enable

Note: This parameter displays the timed programming in a table format in the HYPERSIM® terminal window.
In the Time variations page, enter parameters as follows:

  • Select the Amplitude modulation type button
  • Timed variations: Enable
  • Amplitude: 0.5 Volts (Amplitude of the modulation)
  • Frequency: 2 Hz (Frequency of the modulation)
  • Phase angle: 0.0 deg.
  • Timing: 0/2 s

Using Scopeview, look at the signals Vabc and Iabc at the source.

Use a Time length of 2.5 seconds and a sampling rate associated with the time step of the simulation.

You will see an amplitude modulation of 0.5 V over a 1 V signal, at a rate of 2 Hz on an initial frequency of 10 Hz, during a two-second time span.

Amplitude modulation results

Example of frequency modulation

In the General Controls page (see figure 4 - 7), enter the parameters as follows:

  • Module: 1 V peak
  • Angle: 0 deg.
  • DC offset: 0V
  • Frequency: 10Hz
  • Phase sequence: Direct
  • Source status: Enable
  • Starting mode: Slow
  • Programming: Start
  • Repetitive: Disable

Note: This mode, when enabled, leaves the program variation running forever after the first Synchronization signal received (from Scopeview). To stop it, you have to toggle the parameters Programming from Start to Stop.
• Programming: Enable
Note: This parameter displays the timed programming in a table format in the HYPERSIM® window.
• In the Time variations page, enter parameters as follows:

  • Timed variations: Enable
  • Select the Frequency modulation type button
  • Amplitude: 10 Volts (Amplitude of the modulation + and –)
  • Frequency: 1 Hz (Rate of the modulation)
  • Phase angle: 0.0 deg.
  • Timing: 0/2 s

Using ScopeView, look at the signals Vabc and Iabc of the source.
Use a Time length of 2.5 seconds and a sampling rate associated with the time step of the simulation. You will see a frequency modulation of ±10 Hz over a 10 Hz signal (meaning a variation from 0 to 20 Hz), at a rate of 1 Hz, during a two-second time span.

Ramp/Step Generation
Step or ramp variations can be programmed independently for each of the source parameters (amplitude, phase, frequency, DC component). These variations can coincide with a modulation. Five buttons in the bottom section on Timed variation page of the control panel allow users to select the parameter to be changed. Each selection is independent and has its own list of parameters on the right side. The operation in steady state precedes and follows each variation unless an infinite variation (without any end time) was programmed, a case where the final value of the variation is kept until the interruption of the variations. Here is the list of types of variations shown in the control panel. 

Types:

  • AC: for a variation of the peak amplitude of the source.
  • DC: for a variation of the DC component of the source.
  • Phase: for a variation of the phase angle of the source.
  • Frequency: for a variation of the source frequency.
  • Sequence: to change a sequence.

Parameters

These parameters describe how the selected variables by typeset parameter will change in time. For example, the AC amplitude, DC component and source phase variations are described in the following fields: Amplitude, Operation Timing and Phase. Each of these fields is a list of specifications whose elements are separated by commas. All the lists of a variation type must have the same number of elements. Moreover, each element of a list is linked with the elements in the same position of the other lists. The input format of the values in the lists is described below:
Amplitude

Specifies both the amplitude and the type of variation. Each element of the list corresponds to a variation and consists of one to three numbers (initial value, final value and increment), separated by /, following the variation type required. Here is the correspondence:

  • B,...Initial value only: step variation
  • B/E,...Initial value and final value: ramp
  • B/E/I(,...The initial value, final value, and increment: staircase.

Each element in the list must have a corresponding element in the Operation Timing and Phase lists.

Timing

Specifies the start and end times to apply the variations. Each element consists of two numbers separated by a/, depending on the case. The first (B) specifies the start of the variation in seconds. The second (E) specifies the end of the variation in seconds. Normally, both times must be entered and are compulsory for ramps or staircases. It is possible to specify only the start time (omit the /) for a step that keeps its value indefinitely. Each element in the
list must have a corresponding element in the Amplitude and Phase lists.


Phase

Specifies to which source phases the variations must be applied. Each element in the list designates a certain number of phases. These are simply the characters A, B and C, juxtaposed, if one wants to apply the variation to phases A, B or C. To set only phase A,
the element in the list will be..., A,... To set all the phases, the element will be..., ABC,... Each element in the list must have a corresponding element in the Amplitude and Operation Timing lists.


Frequency

The value of the frequency is specified in the same way as the Amplitude.
However, the frequency variation always applies to all the phases of the source.


Sequence

List of types of sequences.
Example of Ramp and Step generation.
First example: The peak voltage in steady-state of a source is 100 kV and the user wants to increase it progressively to 125 kV over a period of 0.3 seconds after a delay of 0.1 seconds. The delay is calculated from a starting point which depends on the synchronization mode of the source (refer to paragraph F in Source Control). The variation applies to all phases.

  • Enable the AC ramp/step button to enter in the fields the following variation parameters:
  • Amplitude: 100000/125000
  • Timing: 0.1/0.3
  • Phase: ABC

Suppose the user wants to change the base voltage source according to the following model:
A ramp applied to the source amplitude with the following parameters:

  • Start time: 0.1 s
  • End time: 0.3 s
  • Initial amplitude: 0.0 s
  • Final amplitude: 600 000 volts

Another ramp applied to the source amplitude with the following parameters:

  • Start time: 0.35 s
  • End time: 0.45 s
  • Initial amplitude: 1 000 000 volts

For a DC components step with the following parameters:

  • Start time: 0.2 s
  • End time: 0.3 S
  • Amplitude: 200 000 volts
  • These events are programmed as follows (assuming that all the phases are active):
  • Enable AC and DC ramp/step and fill in the fields with the corresponding parameters:

AC

  • Amplitude: 0.0/600000, 1000000/100V
  • Timing: 0.1/0.3,0.35/0.45s
  • Phase: ABC

DC

  • Amplitude: 200000
  • Operation timing: 0.2/0.3
  • Phase: ABC

Note: The values in the fields to program the wave amplitude (AC) were aligned vertically to set apart both events occurring at times that do not coincide. Events affecting the same object cannot coincide. However, two events affecting different parameters of a source, such as the wave and DC components amplitude, can coincide without any problem.

Below figure shows a section on the second page of the programmable voltage sources control panel describing the preceding programming.

Example

  • Enable AC and DC ramp/step and fill in the fields with the corresponding parameters:

AC

  • Amplitude: 1/10V
  • Timing: 0.5/2s
  • Phase: ABC

Programming Harmonics (Control Panel - Harmonics)

This function allows users to add harmonics to the waveform of the source. Programming harmonics consists in defining the harmonic content, specifying the times at which the harmonics will be added and the general activation of the harmonics.
The fields of the parameters allowing to define the harmonic content are identified in the General parameters section with the following labels (See figure 4 - 13):
Harmonic Numbers

This is the list of the numbers for the required harmonics.
The harmonics are numbered from 1 (the fundamental) to 50. It is not necessary to specify the fundamental (1). The list consists of elements separated by commas. Each element can be an integer or a compact notation B/E/I allowing to specify a succession of harmonics, starting with the first (B) to the last (E) with increments I. It is possible to repeat the same harmonic number.
Amplitude

The list of amplitudes relative to each harmonic. The amplitude of each harmonic is relative to the fundamental (amplitude 1). It is specified by a number Ar so that 0.0 < Ar <= 1.0. The list must contain the same number of elements as the list
of harmonic numbers. The elements are separated by commas and each can be a number between 0.0 and 1.0 or the compact notation B/E/I allowing to specify a succession of equidistant amplitudes.
Angle

List of the phase angles for each harmonic.
Enter here the required phase angle displacement (outphasing) relative to the fundamental. This outphasing must be specified in degrees. The list must contain the same number of elements as the list of harmonic numbers. The elements are separated by commas and each element can be an angle or the compact notation B/E/I allowing users to specify a succession of equidistant angles.
Sequence

List of specifications of the sequences (positive, negative, zero and per phase) for each harmonic.

Each harmonic must be specified in positive, negative, zero sequence or per phase. The list provides the sequence to use for each harmonic. It can be empty if all the harmonics are in positive sequence (the most common case). If not, it must contain the same number of elements as in the list of harmonic numbers. The elements are separated by commas. Each element can be one of the following letters:

  • D Harmonic is in positive sequence (0, -120, +120 degrees)
  • I Harmonic is in negative sequence (0, +120, -120 degrees)
  • H Harmonic is in zero sequence (0, 0, 0 degrees)
  • P Harmonic applies only to some phases

Phase

List of phases to which apply the parameters per phase (list Sequence)
The Phase list must contain as many elements as there are parameters per phase (P) in the Sequence list. It can be empty if there are no parameters per phase. The elements are separated by commas. Each element can be formed by a concatenation of the letters A, B and C corresponding to the selected phases. The case ABC is programmed more simply by using the positive sequence (D).

The fields allowing users to program the injection of harmonics are at the beginning of the page.
There are two such fields:
Timing

List of enable/disable times - activation/deactivation.
This is a list of the time values whose elements are separated by commas. Each element can be a numerical value or a compact notation B/E/I for a series of equidistant values. The list must contain at least one element in order to generate harmonics.
Operating activation

List of activations:

This list specifies whether or not there is activation of harmonics. It is linked to the list of times and must contain the same number of elements. The elements are separated by commas. Each element can have the value 1 to activate harmonics
or 0 to deactivate. The minimum list must contain the value 1 in order to generate harmonics.
In this case, the generation of harmonics will begin at the time entered in the Operation Timing list and will remain active until the events programming is stopped by clicking the Stop button on the first page of the control panel.
The global activation of harmonic injection is done by clicking the Enable button on page 3. When Disable is selected, the source operates without harmonics. However, the programming of harmonics is saved and can be reactivated at any time.
Example of harmonic voltage source programming:

Synthesize an harmonic voltage source with the following parameters:
In the General Control page, enter the parameters as follows:

  • Module: 1 Vpeak
  • Angle: 0
  • DC offset: 0 V
  • Frequency: 10 Hz
  • Phase sequence: Direct
  • Source mode: Enable
  • Starting mode: Slow
  • Programming: Start
  • Repetitive: Disable

Note: This mode when enabled, leaves the program variation running forever after the first Synchronization trig received (from Scopeview). To stop it, you have to toggle the parameters Programming from start to stop
Programming: Enable

Note: These parameters print the timed programming in a table format in the HYPERSIM® window.
In the Harmonics page, enter the following parameters:

  • Harmonic number: 10
  • Amplitude: 0.25pu
  • Activation: 1, 0, 1, 0
  • Timing: 0.1, 1, 1.1, 2 s
  • Phase: ABC
  • Angle: 0
  • Sequence: D

Using ScopeView, look at the signals Vabc and Iabc of the source.
Use a Time length of 2.5 seconds and a sampling rate associated with the time step of the simulation. You will get a generation of 0.25 pu of the 10th harmonic in direct sequence over impose with the main signal of 10 Hz, and so between 0.1 and 1 second and also between 1.1 and 2 seconds.

Load Flow Parameters

These parameters can be used for the steady-state solution of the network.

NameDescriptionUnit
Type
  • PQ: P and Q specified, V and θ calculated.
  • PV: P and V specified, Q and θ calculated.
  • Swing: V and θ specified, P and Q calculated.

VoltagePu voltage, specified for PV-bus and Slack-bus, calculated for PQ-bus.pu
AnglePhase angle of voltage, specified for Slack-bus, calculated for PQ-bus and PV-bus.degrees
Q minimum limitMinimum reactive power generation limit for PV-busMvar
Q maximum limitMaximum reactive power generation limit for PV-busMvar
PSpecified generation for PV-bus and Slack-bus, specified load for PQ-busMw
QSpecified load for PQ-bus, calculated within limits for PV-bus, calculated for Slack-bus.Mvar

Ports, Inputs, Outputs and Signals Available for Monitoring

Ports

  • The voltage source has only one network connector (port), since is always referenced to the ground. 

Inputs

  • None

Outputs

  • None

Sensors

  • I: Measured current (voltage source) (A). 
  • VlNT: Source voltage (V). 

OPAL-RT TECHNOLOGIES, Inc. | 1751, rue Richardson, bureau 1060 | Montréal, Québec Canada H3K 1G6 | opal-rt.com | +1 514-935-2323
Follow OPAL-RT: LinkedIn | Facebook | YouTube | X/Twitter