Ctrl+K

Vsource#

( Circuit Element, PC Element )

EPRI’s OpenDSS Documentation for this component: https://opendss.epri.com/Vsource.html

#

Name

Type

Default

Units

Description

1

Bus1

string
(bus def.)

Name of bus to which the main terminal (1) is connected.
bus1=busname
bus1=busname.1.2.3

The VSOURCE object is a two-terminal voltage source (Thevenin equivalent). Bus2 defaults to Bus1 with all phases connected to ground (node 0) unless previously specified. This is a Yg connection. If you want something different, define the Bus2 property explicitly.

2

BasekV

real

115.0

Base Source kV, usually phase-phase (L-L) unless you are making a positive-sequence model or 1-phase model in which case, it will be phase-neutral (L-N) kV.

3

pu

real

1.0

Per unit of the base voltage that the source is actually operating at.
“pu=1.05”

4

Angle

real

0.0

Phase angle in degrees of first phase: e.g.,Angle=10.3

5

Frequency

real

Hz

Source frequency. Defaults to system default base frequency.

6

Phases

integer

3

Number of phases.

7

MVASC3

real

MVA

MVA Short circuit, 3-phase fault. Z1 is determined by squaring the base kv and dividing by this value. For single-phase source, this value is not used.

8

MVASC1

real

MVA

MVA Short Circuit, 1-phase fault. The “single-phase impedance”, Zs, is determined by squaring the base kV and dividing by this value. Then Z0 is determined by Z0 = 3Zs - 2Z1. For 1-phase sources, Zs is used directly. Use X0R0 to define X/R ratio for 1-phase source.

9

X1R1

real

Positive-sequence X/R ratio.

10

X0R0

real

Zero-sequence X/R ratio.

11

Isc3

real

A

Alternate method of defining the source impedance.
3-phase short circuit current.

12

Isc1

real

A

Alternate method of defining the source impedance.
single-phase short circuit current.

13

R1

real

Ω

Alternate method of defining the source impedance.
Positive-sequence resistance.
Redundant with Z1

14

X1

real

Ω

Alternate method of defining the source impedance.
Positive-sequence reactance.
Redundant with Z1

15

R0

real

Ω

Alternate method of defining the source impedance.
Zero-sequence resistance.
Redundant with Z0

16

X0

real

Ω

Alternate method of defining the source impedance.
Zero-sequence reactance.
Redundant with Z0

17

ScanType

string
(from enum. Scan Type)

Positive

Maintain specified sequence for harmonic solution. Default is positive sequence. Otherwise, angle between phases rotates with harmonic.

18

Sequence

string
(from enum. Sequence Type)

Positive

Set the phase angles for the specified symmetrical component sequence for non-harmonic solution modes.

19

Bus2

string
(bus def.)

Name of bus to which 2nd terminal is connected.
bus2=busname
bus2=busname.1.2.3

Default is Bus1.0.0.0 (grounded wye connection)

20

Z1

complex

Ω

Positive-sequence equivalent source impedance, ohms, as a 2-element array representing a complex number. Example:

Z1=[1, 2] ! represents 1 + j2

If defined, Z1, Z2, and Z0 are used to define the impedance matrix of the VSOURCE. Z1 MUST BE DEFINED TO USE THIS OPTION FOR DEFINING THE MATRIX.

Side Effect: Sets Z2 and Z0 to same values unless they were previously defined.

21

Z0

complex

Ω

Zero-sequence equivalent source impedance, ohms, as a 2-element array representing a complex number. Example:

Z0=[3, 4] ! represents 3 + j4

Used to define the impedance matrix of the VSOURCE if Z1 is also specified.

Note: Z0 defaults to Z1 if it is not specifically defined.

22

Z2

complex

Ω

Negative-sequence equivalent source impedance, ohms, as a 2-element array representing a complex number. Example:

Z2=[1, 2] ! represents 1 + j2

Used to define the impedance matrix of the VSOURCE if Z1 is also specified.

Note: Z2 defaults to Z1 if it is not specifically defined. If Z2 is not equal to Z1, the impedance matrix is asymmetrical.

23

puZ1

complex

2-element array: e.g., [1 2]. An alternate way to specify Z1. See Z1 property. Per-unit positive-sequence impedance on base of Vsource BasekV and BaseMVA.

24

puZ0

complex

2-element array: e.g., [1 2]. An alternate way to specify Z0. See Z0 property. Per-unit zero-sequence impedance on base of Vsource BasekV and BaseMVA.

25

puZ2

complex

2-element array: e.g., [1 2]. An alternate way to specify Z2. See Z2 property. Per-unit negative-sequence impedance on base of Vsource BasekV and BaseMVA.

26

BaseMVA

real

Default value is 100. Base used to convert values specified with puZ1, puZ0, and puZ2 properties to ohms on kV base specified by BasekV property.

27

Yearly

string
(LoadShape name)

LOADSHAPE object to use for the per-unit voltage for YEARLY-mode simulations. Set the Mult property of the LOADSHAPE to the pu curve. Qmult is not used. If UseActual=Yes then the Mult curve should be actual L-N kV.

Must be previously defined as a LOADSHAPE object.

Is set to the Daily load shape when Daily is defined. The daily load shape is repeated in this case. Set to NONE to reset to no loadshape for Yearly mode. The default is no variation.

28

Daily

string
(LoadShape name)

LOADSHAPE object to use for the per-unit voltage for DAILY-mode simulations. Set the Mult property of the LOADSHAPE to the pu curve. Qmult is not used. If UseActual=Yes then the Mult curve should be actual L-N kV.

Must be previously defined as a LOADSHAPE object.

Sets Yearly curve if it is not already defined. Set to NONE to reset to no loadshape for Yearly mode. The default is no variation.

29

Duty

string
(LoadShape name)

LOADSHAPE object to use for the per-unit voltage for DUTYCYCLE-mode simulations. Set the Mult property of the LOADSHAPE to the pu curve. Qmult is not used. If UseActual=Yes then the Mult curve should be actual L-N kV.

Must be previously defined as a LOADSHAPE object.

Defaults to Daily load shape when Daily is defined. Set to NONE to reset to no loadshape for Yearly mode. The default is no variation.

30

Model

string
(from enum. VSource: Model)

Thevenin

Specifies whether the Vsource is to be considered a Thevenin short circuit model or a quasi-ideal voltage source. If Thevenin, the Vsource uses the impedances defined for all calculations. If “Ideal”, the model uses a small impedance on the diagonal of the impedance matrix for the fundamental base frequency power flow only. Then switches to actual Thevenin model for other frequencies.

31

puZIdeal

complex

[1e-06, 0.001]

2-element array: e.g., [1 2]. The pu impedance to use for the quasi-ideal voltage source model. Should be a very small impedances. Default is [1e-6, 0.001]. Per-unit impedance on base of Vsource BasekV and BaseMVA. If too small, solution may not work. Be sure to check the voltage values and powers.

32

Spectrum

string
(Spectrum name)

defaultvsource

Name of harmonic spectrum for this source.

33

BaseFreq

real

Hz

Base Frequency for ratings.

34

Enabled

boolean

True

Indicates whether this element is enabled.

35

Like

string
(Vsource name)
deprecated

Make like another object, e.g.:

New Capacitor.C2 like=c1 …

Enumerations#

VSource: Model#

Value

Thevenin

Ideal