Class: Vsource¶

A Vsource object in OpenDSS representing an ideal voltage source (slack bus) in the distribution system. Used to represent the transmission-system equivalent or a substation source.

URI: dss:Vsource

 classDiagram
    class Vsource
    click Vsource href "../Vsource/"
      Vsource : angle

      Vsource : basefreq

      Vsource : basekv

      Vsource : baseMVA

      Vsource : bus1

      Vsource : bus2

      Vsource : Daily

      Vsource : Duty

      Vsource : enabled

      Vsource : frequency

      Vsource : Isc1

      Vsource : Isc3

      Vsource : like

      Vsource : Model

      Vsource : MVAsc1

      Vsource : MVAsc3

      Vsource : name

      Vsource : phases

      Vsource : pu

      Vsource : puZ0

      Vsource : puZ1

      Vsource : puZ2

      Vsource : puZideal

      Vsource : R0

      Vsource : R1

      Vsource : ScanType

      Vsource : Sequence

      Vsource : spectrum

      Vsource : X0

      Vsource : x0r0

      Vsource : X1

      Vsource : x1r1

      Vsource : Yearly

      Vsource : Z0

      Vsource : Z1

      Vsource : Z2

Class Properties¶

Property	Value
Class URI	dss:Vsource

Slots¶

Name	Cardinality and Range	Description	Inheritance
name	1 String	Object name	direct
bus1	0..1 String	Name of bus to which the main terminal (1) is connected	direct
basekv	0..1 Float	Base Source kV, usually phase-phase (L-L) unless positive-sequence or single-...	direct
pu	0..1 Float	Per unit of the base voltage that the source is actually operating at	direct
angle	0..1 Float	Phase angle in degrees of first phase	direct
frequency	0..1 String	Source frequency	direct
phases	0..1 Integer	Number of phases	direct
MVAsc3	0..1 Float	MVA Short circuit, 3-phase fault	direct
MVAsc1	0..1 Float	MVA Short Circuit, 1-phase fault	direct
x1r1	0..1 String	Positive-sequence X/R ratio	direct
x0r0	0..1 String	Zero-sequence X/R ratio	direct
Isc3	0..1 Float	Alternate method of defining source impedance via 3-phase fault current (kA)	direct
Isc1	0..1 Float	Alternate method of defining source impedance via single-phase fault current ...	direct
R1	0..1 Float	Positive-sequence resistance, ohms	direct
X1	0..1 Float	Positive-sequence reactance, ohms	direct
R0	0..1 Float	Zero-sequence resistance, ohms	direct
X0	0..1 Float	Zero-sequence reactance, ohms	direct
ScanType	0..1 String	{pos*	zero
Sequence	0..1 String	{pos*	neg
bus2	0..1 String	Name of bus to which 2^nd terminal is connected	direct
Z1	0..1 Float	Positive-sequence equivalent source impedance, ohms, as a 2-element complex a...	direct
Z0	0..1 Float	Zero-sequence equivalent source impedance, ohms, as a 2-element complex array...	direct
Z2	0..1 Float	Negative-sequence equivalent source impedance, ohms, as a 2-element complex a...	direct
puZ1	0..1 Float	Positive-sequence impedance in per-unit on source kVA base	direct
puZ0	0..1 Float	Zero-sequence impedance in per-unit	direct
puZ2	0..1 Float	Negative-sequence impedance in per-unit	direct
baseMVA	0..1 Float	Base MVA for converting per-unit impedances	direct
Yearly	0..1 String	LOADSHAPE object to use for the per-unit voltage for YEARLY-mode simulations	direct
Daily	0..1 String	LOADSHAPE object to use for the per-unit voltage for DAILY-mode simulations	direct
Duty	0..1 String	LOADSHAPE object to use for the per-unit voltage for DUTYCYCLE-mode simulatio...	direct
Model	0..1 String	{Thevenin*	Ideal} Specifies whether the Vsource is to be considered a Theve...
puZideal	0..1 Float	Per-unit series impedance when Model=Ideal	direct
spectrum	0..1 String	Name of harmonic spectrum for this source	direct
basefreq	0..1 Float	Base Frequency for ratings	direct
enabled	0..1 Boolean	{Yes	No or True
like	0..1 String	Make like another object, e	direct

Comments¶

OpenDSS Vsource maps to CIM EnergySource. Voltage magnitude and angle are SSH-profile attributes; nominal voltage and sequence impedances (r, x, r0, x0) are EQ-profile attributes. Only two import paths are currently implemented: direct R1/X1/R0/X0, or MVAsc3/MVAsc1 (with x1r1/x0r0) when R1/X1/R0/X0 are absent. Isc3/Isc1/Z1/Z0/Z2/puZ1/puZ0/ puZ2/puZideal are accepted by the OpenDSS parser but not currently read by this converter.

Identifier and Mapping Information¶

Schema Source¶

from schema: https://gridappsd.github.io/dss-graph/opendss

Mappings¶

Mapping Type	Mapped Value
self	dss:Vsource
native	dss:Vsource
exact	cim:EnergySource

LinkML Source¶

Direct¶

name: Vsource
description: A Vsource object in OpenDSS representing an ideal voltage source (slack
  bus) in the distribution system. Used to represent the transmission-system equivalent
  or a substation source.
comments:
- 'OpenDSS Vsource maps to CIM EnergySource. Voltage magnitude and angle are SSH-profile
  attributes; nominal voltage and sequence impedances (r, x, r0, x0) are EQ-profile
  attributes. Only two import paths are currently implemented: direct R1/X1/R0/X0,
  or MVAsc3/MVAsc1 (with x1r1/x0r0) when R1/X1/R0/X0 are absent. Isc3/Isc1/Z1/Z0/Z2/puZ1/puZ0/
  puZ2/puZideal are accepted by the OpenDSS parser but not currently read by this
  converter.'
from_schema: https://gridappsd.github.io/dss-graph/opendss
exact_mappings:
- cim:EnergySource
attributes:
  name:
    name: name
    description: Object name. Must be unique per object type.
    comments:
    - Direct name mapping; no conversion needed.
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    exact_mappings:
    - cim:IdentifiedObject.name
    identifier: true
    domain_of:
    - Load
    - Generator
    - Generic5
    - Gicline
    - Indmach012
    - Pvsystem
    - Storage
    - Upfc
    - Vccs
    - Vsconverter
    - Windgen
    - Autotrans
    - Capacitor
    - Gictransformer
    - Line
    - Reactor
    - Transformer
    - Capcontrol
    - Espvlcontrol
    - Expcontrol
    - Fuse
    - Gendispatcher
    - Invcontrol
    - Pycontrol
    - Recloser
    - Regcontrol
    - Relay
    - Storagecontroller
    - Swtcontrol
    - Upfccontrol
    - Cndata
    - Dynamicexp
    - Growthshape
    - Linecode
    - Linegeometry
    - Linespacing
    - Loadshape
    - Priceshape
    - Spectrum
    - TccCurve
    - Tsdata
    - Tshape
    - Wiredata
    - Xfmrcode
    - Xycurve
    - Energymeter
    - Fmonitor
    - Monitor
    - Sensor
    - Fault
    - Gicsource
    - Isource
    - Vsource
    range: string
    required: true
  bus1:
    name: bus1
    annotations:
      order:
        tag: order
        value: 1
    description: Name of bus to which the main terminal (1) is connected.
    comments:
    - 'Structural mapping: equipment.Terminals[0].ConnectivityNode.name.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    related_mappings:
    - cim:Terminal.ConnectivityNode
    domain_of:
    - Load
    - Generator
    - Generic5
    - Gicline
    - Indmach012
    - Pvsystem
    - Storage
    - Upfc
    - Vccs
    - Windgen
    - Capacitor
    - Line
    - Reactor
    - Fault
    - Isource
    - Vsource
    range: string
    required: false
  basekv:
    name: basekv
    annotations:
      order:
        tag: order
        value: 2
      dss_default:
        tag: dss_default
        value: float(115.0)
    description: Base Source kV, usually phase-phase (L-L) unless positive-sequence
      or single-phase model. Default is 115 kV.
    comments:
    - 'Import: EnergySource.nominalVoltage = Voltage(basekv, ''kV''). Export: basekv
      = nominalVoltage.to(''kV''). CIM stores in V (SI base).'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    exact_mappings:
    - cim:EnergySource.nominalVoltage
    rank: 1000
    domain_of:
    - Vsource
    range: float
    required: false
    minimum_value: 0.0
  pu:
    name: pu
    annotations:
      order:
        tag: order
        value: 3
      dss_default:
        tag: dss_default
        value: float(1.0)
    description: Per unit of the base voltage that the source is actually operating
      at. Default is 1.0.
    comments:
    - 'Import: EnergySource.voltageMagnitude = Voltage(basekv * pu, ''kV'') (SSH attribute).
      Export: pu = voltageMagnitude.to(''kV'') / basekv.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    close_mappings:
    - cim:EnergySource.voltageMagnitude
    rank: 1000
    domain_of:
    - Vsource
    range: float
    required: false
    minimum_value: 0.0
  angle:
    name: angle
    annotations:
      order:
        tag: order
        value: 4
    description: Phase angle in degrees of first phase. Default is 0 degrees.
    comments:
    - 'Import: EnergySource.voltageAngle = AngleRadians(angle_deg * π/180) (SSH attribute).
      Export: angle = voltageAngle.to(''deg'').'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    exact_mappings:
    - cim:EnergySource.voltageAngle
    domain_of:
    - Spectrum
    - Gicsource
    - Isource
    - Vsource
    range: float
    required: false
  frequency:
    name: frequency
    annotations:
      order:
        tag: order
        value: 5
    description: Source frequency. Default = circuit base frequency.
    comments:
    - Not stored on CIM EnergySource; base frequency is a circuit-level property in
      CIM.
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    domain_of:
    - Gicline
    - Upfc
    - Gicsource
    - Isource
    - Vsource
    range: string
    required: false
  phases:
    name: phases
    annotations:
      order:
        tag: order
        value: 6
    description: Number of phases. Default = 3.
    comments:
    - 'Import: inferred from the bus1 node suffix via parse_bus_phases(); not stored
      directly on CIM EnergySource. Export: inferred from the PhaseCode of the connected
      Terminal (single-phase codes → 1, two-phase codes → 2, otherwise 3).'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    domain_of:
    - Load
    - Generator
    - Generic5
    - Gicline
    - Indmach012
    - Pvsystem
    - Storage
    - Upfc
    - Vccs
    - Vsconverter
    - Windgen
    - Autotrans
    - Capacitor
    - Gictransformer
    - Line
    - Reactor
    - Transformer
    - Xfmrcode
    - Fault
    - Gicsource
    - Isource
    - Vsource
    range: integer
    required: false
  MVAsc3:
    name: MVAsc3
    annotations:
      order:
        tag: order
        value: 7
    description: MVA Short circuit, 3-phase fault. Used to derive positive-sequence
      impedance.
    comments:
    - 'Import fallback, used only when R1/X1/R0/X0 are not all given: Z1 = basekv²
      / MVAsc3; r = Z1 / √(1 + x1r1²); x = r × x1r1 (x1r1 defaults to 4.0 if not specified).
      Not stored directly on CIM; r and x are the canonical fields and are always
      written back on export via R1/X1 — MVAsc3 itself is not exported.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    close_mappings:
    - cim:EnergySource.r
    - cim:EnergySource.x
    rank: 1000
    domain_of:
    - Vsource
    range: float
    required: false
  MVAsc1:
    name: MVAsc1
    annotations:
      order:
        tag: order
        value: 8
    description: MVA Short Circuit, 1-phase fault. Used to derive zero-sequence impedance.
    comments:
    - 'Import fallback, used only when R1/X1/R0/X0 are not all given and MVAsc3 >
      0: Zs = basekv² / MVAsc1; Z0 = 3×Zs − 2×Z1; r0 = Z0 / √(1 + x0r0²); x0 = r0
      × x0r0 (x0r0 defaults to 3.0 if not specified). If MVAsc1 is absent, r0/x0 default
      to r/x instead. Not stored directly on CIM; r0/x0 are the canonical fields and
      are always written back on export via R0/X0 — MVAsc1 itself is not exported.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    close_mappings:
    - cim:EnergySource.r0
    - cim:EnergySource.x0
    rank: 1000
    domain_of:
    - Vsource
    range: float
    required: false
  x1r1:
    name: x1r1
    annotations:
      order:
        tag: order
        value: 9
    description: Positive-sequence X/R ratio. Used with MVAsc3 to derive R1, X1.
    comments:
    - 'OpenDSS-only (N/A): used in the MVAsc3 fallback to split Z1 into r and x (see
      MVAsc3 comments); defaults to 4.0 if not specified. Not stored on CIM EnergySource.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    domain_of:
    - Vsource
    range: string
    required: false
  x0r0:
    name: x0r0
    annotations:
      order:
        tag: order
        value: 10
    description: Zero-sequence X/R ratio. Used with MVAsc1 to derive R0, X0.
    comments:
    - 'OpenDSS-only (N/A): used in the MVAsc1 fallback to split Z0 into r0 and x0
      (see MVAsc1 comments); defaults to 3.0 if not specified. Not stored on CIM EnergySource.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    domain_of:
    - Vsource
    range: string
    required: false
  Isc3:
    name: Isc3
    annotations:
      order:
        tag: order
        value: 11
    description: Alternate method of defining source impedance via 3-phase fault current
      (kA).
    todos:
    - Converter does not currently consume Isc3 as an r/x source; would need to be
      added to the import fallback chain to roundtrip models that only set Isc3.
    comments:
    - 'OpenDSS-only (N/A): alternate way to specify source impedance via 3-phase fault
      current; the current converter does not read Isc3 (only R1/X1/R0/X0 and MVAsc3/MVAsc1
      are consumed).'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    domain_of:
    - Vsource
    range: float
    required: false
  Isc1:
    name: Isc1
    annotations:
      order:
        tag: order
        value: 12
    description: Alternate method of defining source impedance via single-phase fault
      current (kA).
    todos:
    - Converter does not currently consume Isc1 as an r0/x0 source; would need to
      be added to the import fallback chain to roundtrip models that only set Isc1.
    comments:
    - 'OpenDSS-only (N/A): alternate way to specify zero-sequence impedance via single-phase
      fault current; the current converter does not read Isc1.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    domain_of:
    - Vsource
    range: float
    required: false
  R1:
    name: R1
    annotations:
      order:
        tag: order
        value: 13
    description: Positive-sequence resistance, ohms. Alternate way to define source
      impedance.
    comments:
    - 'Import: EnergySource.r = Resistance(R1, ''ohm''). Export: R1 = r.to(''ohm'').
      CIM stores in ohm (SI base).'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    exact_mappings:
    - cim:EnergySource.r
    domain_of:
    - Gictransformer
    - Vsource
    range: float
    required: false
  X1:
    name: X1
    annotations:
      order:
        tag: order
        value: 14
    description: Positive-sequence reactance, ohms.
    comments:
    - 'Import: EnergySource.x = Reactance(X1, ''ohm''). Export: X1 = x.to(''ohm'').'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    exact_mappings:
    - cim:EnergySource.x
    rank: 1000
    domain_of:
    - Vsource
    range: float
    required: false
  R0:
    name: R0
    annotations:
      order:
        tag: order
        value: 15
    description: Zero-sequence resistance, ohms.
    comments:
    - 'Import: EnergySource.r0 = Resistance(R0, ''ohm''). Export: R0 = r0.to(''ohm'').'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    exact_mappings:
    - cim:EnergySource.r0
    rank: 1000
    domain_of:
    - Vsource
    range: float
    required: false
  X0:
    name: X0
    annotations:
      order:
        tag: order
        value: 16
    description: Zero-sequence reactance, ohms.
    comments:
    - 'Import: EnergySource.x0 = Reactance(X0, ''ohm''). Export: X0 = x0.to(''ohm'').'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    exact_mappings:
    - cim:EnergySource.x0
    rank: 1000
    domain_of:
    - Vsource
    range: float
    required: false
  ScanType:
    name: ScanType
    annotations:
      order:
        tag: order
        value: 17
    description: '{pos*| zero | none} Maintain specified sequence for harmonic solution.'
    comments:
    - 'OpenDSS-only (N/A): harmonic analysis sequence type; no CIM equivalent.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    domain_of:
    - Vsource
    range: string
    required: false
  Sequence:
    name: Sequence
    annotations:
      order:
        tag: order
        value: 18
    description: '{pos*| neg | zero} Set the phase angles for the specified symmetrical
      component sequence for non-harmonic solution modes.'
    comments:
    - 'OpenDSS-only (N/A): sequence assignment for symmetrical component models; no
      CIM equivalent.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    domain_of:
    - Vsource
    range: string
    required: false
  bus2:
    name: bus2
    annotations:
      order:
        tag: order
        value: 19
    description: Name of bus to which 2nd terminal is connected. Default is the floating
      neutral node.
    comments:
    - 'OpenDSS-only (N/A): second terminal bus; CIM EnergySource is single-terminal
      (grounded neutral implicit).'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    domain_of:
    - Gicline
    - Upfc
    - Capacitor
    - Line
    - Reactor
    - Fault
    - Vsource
    range: string
    required: false
  Z1:
    name: Z1
    annotations:
      order:
        tag: order
        value: 20
    description: Positive-sequence equivalent source impedance, ohms, as a 2-element
      complex array [R, X].
    todos:
    - Converter does not currently consume Z1 as an r/x source; would need to be added
      to the import fallback chain to roundtrip models that only set Z1.
    comments:
    - 'OpenDSS-only (N/A): alternate complex-array form for R1/X1; the current converter
      does not read Z1 (only scalar R1/X1 are consumed).'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    domain_of:
    - Reactor
    - Vsource
    range: float
    required: false
  Z0:
    name: Z0
    annotations:
      order:
        tag: order
        value: 21
    description: Zero-sequence equivalent source impedance, ohms, as a 2-element complex
      array [R, X].
    todos:
    - Converter does not currently consume Z0 as an r0/x0 source; would need to be
      added to the import fallback chain to roundtrip models that only set Z0.
    comments:
    - 'OpenDSS-only (N/A): alternate complex-array form for R0/X0; the current converter
      does not read Z0 (only scalar R0/X0 are consumed).'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    domain_of:
    - Reactor
    - Vsource
    range: float
    required: false
  Z2:
    name: Z2
    annotations:
      order:
        tag: order
        value: 22
    description: Negative-sequence equivalent source impedance, ohms, as a 2-element
      complex array [R, X].
    comments:
    - 'OpenDSS-only (N/A): negative-sequence impedance; no CIM equivalent on EnergySource.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    domain_of:
    - Reactor
    - Vsource
    range: float
    required: false
  puZ1:
    name: puZ1
    annotations:
      order:
        tag: order
        value: 23
    description: Positive-sequence impedance in per-unit on source kVA base.
    todos:
    - Converter does not currently consume puZ1 as an r/x source; would need to be
      added to the import fallback chain to roundtrip models that only set puZ1.
    comments:
    - 'OpenDSS-only (N/A): alternate per-unit form for source impedance (z_base =
      basekv² / baseMVA); the current converter does not read puZ1.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    domain_of:
    - Vsource
    range: float
    required: false
  puZ0:
    name: puZ0
    annotations:
      order:
        tag: order
        value: 24
    description: Zero-sequence impedance in per-unit.
    todos:
    - Converter does not currently consume puZ0 as an r0/x0 source; would need to
      be added to the import fallback chain to roundtrip models that only set puZ0.
    comments:
    - 'OpenDSS-only (N/A): alternate per-unit form for zero-sequence impedance; the
      current converter does not read puZ0.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    domain_of:
    - Vsource
    range: float
    required: false
  puZ2:
    name: puZ2
    annotations:
      order:
        tag: order
        value: 25
    description: Negative-sequence impedance in per-unit.
    comments:
    - 'OpenDSS-only (N/A): negative-sequence per-unit impedance; no CIM equivalent.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    domain_of:
    - Vsource
    range: float
    required: false
  baseMVA:
    name: baseMVA
    annotations:
      order:
        tag: order
        value: 26
    description: Base MVA for converting per-unit impedances. Default is 100 MVA.
    comments:
    - 'OpenDSS-only (N/A): would be used as the per-unit base for puZ1/puZ0/puZ2 conversion,
      but the converter does not currently read those fields (see their comments);
      not stored on CIM EnergySource.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    domain_of:
    - Vsource
    range: float
    required: false
  Yearly:
    name: Yearly
    annotations:
      order:
        tag: order
        value: 27
    description: LOADSHAPE object to use for the per-unit voltage for YEARLY-mode
      simulations.
    todos:
    - Loadshape converter not yet implemented.
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    related_mappings:
    - cim:SeasonDayTypeSchedule
    domain_of:
    - Generic5
    - Indmach012
    - Storagecontroller
    - Isource
    - Vsource
    range: string
    required: false
  Daily:
    name: Daily
    annotations:
      order:
        tag: order
        value: 28
    description: LOADSHAPE object to use for the per-unit voltage for DAILY-mode simulations.
    todos:
    - Loadshape converter not yet implemented.
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    related_mappings:
    - cim:SeasonDayTypeSchedule
    domain_of:
    - Generic5
    - Indmach012
    - Storagecontroller
    - Isource
    - Vsource
    range: string
    required: false
  Duty:
    name: Duty
    annotations:
      order:
        tag: order
        value: 29
    description: LOADSHAPE object to use for the per-unit voltage for DUTYCYCLE-mode
      simulations.
    todos:
    - Loadshape converter not yet implemented.
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    related_mappings:
    - cim:SeasonDayTypeSchedule
    domain_of:
    - Generic5
    - Indmach012
    - Storagecontroller
    - Isource
    - Vsource
    range: string
    required: false
  Model:
    name: Model
    annotations:
      order:
        tag: order
        value: 30
    description: '{Thevenin* | Ideal} Specifies whether the Vsource is to be considered
      a Thevenin short circuit model or a quasi-ideal voltage source.'
    comments:
    - 'OpenDSS-only (N/A): source model type selector; no CIM equivalent on EnergySource.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    domain_of:
    - Vsource
    range: string
    required: false
  puZideal:
    name: puZideal
    annotations:
      order:
        tag: order
        value: 31
    description: Per-unit series impedance when Model=Ideal.
    comments:
    - 'OpenDSS-only (N/A): ideal source series impedance; no CIM equivalent.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    domain_of:
    - Vsource
    range: float
    required: false
  spectrum:
    name: spectrum
    annotations:
      order:
        tag: order
        value: 32
    description: Name of harmonic spectrum for this source.
    comments:
    - 'OpenDSS-only (N/A): harmonic spectrum reference; no CIM equivalent in the standard
      profile.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    domain_of:
    - Load
    - Generator
    - Generic5
    - Gicline
    - Indmach012
    - Pvsystem
    - Storage
    - Upfc
    - Vccs
    - Vsconverter
    - Windgen
    - Gicsource
    - Isource
    - Vsource
    range: string
    required: false
  basefreq:
    name: basefreq
    annotations:
      order:
        tag: order
        value: 33
    description: Base Frequency for ratings.
    comments:
    - Not stored on CIM EnergySource; base frequency is a circuit-level property.
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    domain_of:
    - Load
    - Generator
    - Generic5
    - Gicline
    - Indmach012
    - Pvsystem
    - Storage
    - Upfc
    - Vccs
    - Vsconverter
    - Windgen
    - Autotrans
    - Capacitor
    - Gictransformer
    - Line
    - Reactor
    - Transformer
    - Capcontrol
    - Espvlcontrol
    - Expcontrol
    - Fuse
    - Gendispatcher
    - Invcontrol
    - Pycontrol
    - Recloser
    - Regcontrol
    - Relay
    - Storagecontroller
    - Swtcontrol
    - Upfccontrol
    - Energymeter
    - Fmonitor
    - Monitor
    - Sensor
    - Fault
    - Gicsource
    - Isource
    - Vsource
    range: float
    required: false
  enabled:
    name: enabled
    annotations:
      order:
        tag: order
        value: 34
    description: '{Yes|No or True|False} Indicates whether this element is enabled.'
    comments:
    - 'OpenDSS-only (N/A): if False, converter returns None and no CIM object is created.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    domain_of:
    - Load
    - Generator
    - Generic5
    - Gicline
    - Indmach012
    - Pvsystem
    - Storage
    - Upfc
    - Vccs
    - Vsconverter
    - Windgen
    - Autotrans
    - Capacitor
    - Gictransformer
    - Line
    - Reactor
    - Transformer
    - Capcontrol
    - Espvlcontrol
    - Expcontrol
    - Fuse
    - Gendispatcher
    - Invcontrol
    - Pycontrol
    - Recloser
    - Regcontrol
    - Relay
    - Storagecontroller
    - Swtcontrol
    - Upfccontrol
    - Energymeter
    - Fmonitor
    - Monitor
    - Sensor
    - Fault
    - Gicsource
    - Isource
    - Vsource
    range: boolean
    required: false
  like:
    name: like
    annotations:
      order:
        tag: order
        value: 35
    description: 'Make like another object, e.g.: New Vsource.V2 like=V1 ...'
    comments:
    - 'OpenDSS-only (N/A): DSS template/copy directive resolved at parse time; no
      CIM equivalent.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    domain_of:
    - Load
    - Generator
    - Generic5
    - Gicline
    - Indmach012
    - Pvsystem
    - Storage
    - Upfc
    - Vccs
    - Vsconverter
    - Windgen
    - Autotrans
    - Capacitor
    - Gictransformer
    - Line
    - Reactor
    - Transformer
    - Capcontrol
    - Espvlcontrol
    - Expcontrol
    - Fuse
    - Gendispatcher
    - Invcontrol
    - Pycontrol
    - Recloser
    - Regcontrol
    - Relay
    - Storagecontroller
    - Swtcontrol
    - Upfccontrol
    - Cndata
    - Dynamicexp
    - Growthshape
    - Linecode
    - Linegeometry
    - Linespacing
    - Loadshape
    - Priceshape
    - Spectrum
    - TccCurve
    - Tsdata
    - Tshape
    - Wiredata
    - Xfmrcode
    - Xycurve
    - Energymeter
    - Fmonitor
    - Monitor
    - Sensor
    - Fault
    - Gicsource
    - Isource
    - Vsource
    range: string
    required: false
class_uri: dss:Vsource

Induced¶

name: Vsource
description: A Vsource object in OpenDSS representing an ideal voltage source (slack
  bus) in the distribution system. Used to represent the transmission-system equivalent
  or a substation source.
comments:
- 'OpenDSS Vsource maps to CIM EnergySource. Voltage magnitude and angle are SSH-profile
  attributes; nominal voltage and sequence impedances (r, x, r0, x0) are EQ-profile
  attributes. Only two import paths are currently implemented: direct R1/X1/R0/X0,
  or MVAsc3/MVAsc1 (with x1r1/x0r0) when R1/X1/R0/X0 are absent. Isc3/Isc1/Z1/Z0/Z2/puZ1/puZ0/
  puZ2/puZideal are accepted by the OpenDSS parser but not currently read by this
  converter.'
from_schema: https://gridappsd.github.io/dss-graph/opendss
exact_mappings:
- cim:EnergySource
attributes:
  name:
    name: name
    description: Object name. Must be unique per object type.
    comments:
    - Direct name mapping; no conversion needed.
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    exact_mappings:
    - cim:IdentifiedObject.name
    identifier: true
    owner: Vsource
    domain_of:
    - Load
    - Generator
    - Generic5
    - Gicline
    - Indmach012
    - Pvsystem
    - Storage
    - Upfc
    - Vccs
    - Vsconverter
    - Windgen
    - Autotrans
    - Capacitor
    - Gictransformer
    - Line
    - Reactor
    - Transformer
    - Capcontrol
    - Espvlcontrol
    - Expcontrol
    - Fuse
    - Gendispatcher
    - Invcontrol
    - Pycontrol
    - Recloser
    - Regcontrol
    - Relay
    - Storagecontroller
    - Swtcontrol
    - Upfccontrol
    - Cndata
    - Dynamicexp
    - Growthshape
    - Linecode
    - Linegeometry
    - Linespacing
    - Loadshape
    - Priceshape
    - Spectrum
    - TccCurve
    - Tsdata
    - Tshape
    - Wiredata
    - Xfmrcode
    - Xycurve
    - Energymeter
    - Fmonitor
    - Monitor
    - Sensor
    - Fault
    - Gicsource
    - Isource
    - Vsource
    range: string
    required: true
  bus1:
    name: bus1
    annotations:
      order:
        tag: order
        value: 1
    description: Name of bus to which the main terminal (1) is connected.
    comments:
    - 'Structural mapping: equipment.Terminals[0].ConnectivityNode.name.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    related_mappings:
    - cim:Terminal.ConnectivityNode
    owner: Vsource
    domain_of:
    - Load
    - Generator
    - Generic5
    - Gicline
    - Indmach012
    - Pvsystem
    - Storage
    - Upfc
    - Vccs
    - Windgen
    - Capacitor
    - Line
    - Reactor
    - Fault
    - Isource
    - Vsource
    range: string
    required: false
  basekv:
    name: basekv
    annotations:
      order:
        tag: order
        value: 2
      dss_default:
        tag: dss_default
        value: float(115.0)
    description: Base Source kV, usually phase-phase (L-L) unless positive-sequence
      or single-phase model. Default is 115 kV.
    comments:
    - 'Import: EnergySource.nominalVoltage = Voltage(basekv, ''kV''). Export: basekv
      = nominalVoltage.to(''kV''). CIM stores in V (SI base).'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    exact_mappings:
    - cim:EnergySource.nominalVoltage
    rank: 1000
    owner: Vsource
    domain_of:
    - Vsource
    range: float
    required: false
    minimum_value: 0.0
  pu:
    name: pu
    annotations:
      order:
        tag: order
        value: 3
      dss_default:
        tag: dss_default
        value: float(1.0)
    description: Per unit of the base voltage that the source is actually operating
      at. Default is 1.0.
    comments:
    - 'Import: EnergySource.voltageMagnitude = Voltage(basekv * pu, ''kV'') (SSH attribute).
      Export: pu = voltageMagnitude.to(''kV'') / basekv.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    close_mappings:
    - cim:EnergySource.voltageMagnitude
    rank: 1000
    owner: Vsource
    domain_of:
    - Vsource
    range: float
    required: false
    minimum_value: 0.0
  angle:
    name: angle
    annotations:
      order:
        tag: order
        value: 4
    description: Phase angle in degrees of first phase. Default is 0 degrees.
    comments:
    - 'Import: EnergySource.voltageAngle = AngleRadians(angle_deg * π/180) (SSH attribute).
      Export: angle = voltageAngle.to(''deg'').'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    exact_mappings:
    - cim:EnergySource.voltageAngle
    owner: Vsource
    domain_of:
    - Spectrum
    - Gicsource
    - Isource
    - Vsource
    range: float
    required: false
  frequency:
    name: frequency
    annotations:
      order:
        tag: order
        value: 5
    description: Source frequency. Default = circuit base frequency.
    comments:
    - Not stored on CIM EnergySource; base frequency is a circuit-level property in
      CIM.
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    owner: Vsource
    domain_of:
    - Gicline
    - Upfc
    - Gicsource
    - Isource
    - Vsource
    range: string
    required: false
  phases:
    name: phases
    annotations:
      order:
        tag: order
        value: 6
    description: Number of phases. Default = 3.
    comments:
    - 'Import: inferred from the bus1 node suffix via parse_bus_phases(); not stored
      directly on CIM EnergySource. Export: inferred from the PhaseCode of the connected
      Terminal (single-phase codes → 1, two-phase codes → 2, otherwise 3).'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    owner: Vsource
    domain_of:
    - Load
    - Generator
    - Generic5
    - Gicline
    - Indmach012
    - Pvsystem
    - Storage
    - Upfc
    - Vccs
    - Vsconverter
    - Windgen
    - Autotrans
    - Capacitor
    - Gictransformer
    - Line
    - Reactor
    - Transformer
    - Xfmrcode
    - Fault
    - Gicsource
    - Isource
    - Vsource
    range: integer
    required: false
  MVAsc3:
    name: MVAsc3
    annotations:
      order:
        tag: order
        value: 7
    description: MVA Short circuit, 3-phase fault. Used to derive positive-sequence
      impedance.
    comments:
    - 'Import fallback, used only when R1/X1/R0/X0 are not all given: Z1 = basekv²
      / MVAsc3; r = Z1 / √(1 + x1r1²); x = r × x1r1 (x1r1 defaults to 4.0 if not specified).
      Not stored directly on CIM; r and x are the canonical fields and are always
      written back on export via R1/X1 — MVAsc3 itself is not exported.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    close_mappings:
    - cim:EnergySource.r
    - cim:EnergySource.x
    rank: 1000
    owner: Vsource
    domain_of:
    - Vsource
    range: float
    required: false
  MVAsc1:
    name: MVAsc1
    annotations:
      order:
        tag: order
        value: 8
    description: MVA Short Circuit, 1-phase fault. Used to derive zero-sequence impedance.
    comments:
    - 'Import fallback, used only when R1/X1/R0/X0 are not all given and MVAsc3 >
      0: Zs = basekv² / MVAsc1; Z0 = 3×Zs − 2×Z1; r0 = Z0 / √(1 + x0r0²); x0 = r0
      × x0r0 (x0r0 defaults to 3.0 if not specified). If MVAsc1 is absent, r0/x0 default
      to r/x instead. Not stored directly on CIM; r0/x0 are the canonical fields and
      are always written back on export via R0/X0 — MVAsc1 itself is not exported.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    close_mappings:
    - cim:EnergySource.r0
    - cim:EnergySource.x0
    rank: 1000
    owner: Vsource
    domain_of:
    - Vsource
    range: float
    required: false
  x1r1:
    name: x1r1
    annotations:
      order:
        tag: order
        value: 9
    description: Positive-sequence X/R ratio. Used with MVAsc3 to derive R1, X1.
    comments:
    - 'OpenDSS-only (N/A): used in the MVAsc3 fallback to split Z1 into r and x (see
      MVAsc3 comments); defaults to 4.0 if not specified. Not stored on CIM EnergySource.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    owner: Vsource
    domain_of:
    - Vsource
    range: string
    required: false
  x0r0:
    name: x0r0
    annotations:
      order:
        tag: order
        value: 10
    description: Zero-sequence X/R ratio. Used with MVAsc1 to derive R0, X0.
    comments:
    - 'OpenDSS-only (N/A): used in the MVAsc1 fallback to split Z0 into r0 and x0
      (see MVAsc1 comments); defaults to 3.0 if not specified. Not stored on CIM EnergySource.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    owner: Vsource
    domain_of:
    - Vsource
    range: string
    required: false
  Isc3:
    name: Isc3
    annotations:
      order:
        tag: order
        value: 11
    description: Alternate method of defining source impedance via 3-phase fault current
      (kA).
    todos:
    - Converter does not currently consume Isc3 as an r/x source; would need to be
      added to the import fallback chain to roundtrip models that only set Isc3.
    comments:
    - 'OpenDSS-only (N/A): alternate way to specify source impedance via 3-phase fault
      current; the current converter does not read Isc3 (only R1/X1/R0/X0 and MVAsc3/MVAsc1
      are consumed).'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    owner: Vsource
    domain_of:
    - Vsource
    range: float
    required: false
  Isc1:
    name: Isc1
    annotations:
      order:
        tag: order
        value: 12
    description: Alternate method of defining source impedance via single-phase fault
      current (kA).
    todos:
    - Converter does not currently consume Isc1 as an r0/x0 source; would need to
      be added to the import fallback chain to roundtrip models that only set Isc1.
    comments:
    - 'OpenDSS-only (N/A): alternate way to specify zero-sequence impedance via single-phase
      fault current; the current converter does not read Isc1.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    owner: Vsource
    domain_of:
    - Vsource
    range: float
    required: false
  R1:
    name: R1
    annotations:
      order:
        tag: order
        value: 13
    description: Positive-sequence resistance, ohms. Alternate way to define source
      impedance.
    comments:
    - 'Import: EnergySource.r = Resistance(R1, ''ohm''). Export: R1 = r.to(''ohm'').
      CIM stores in ohm (SI base).'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    exact_mappings:
    - cim:EnergySource.r
    owner: Vsource
    domain_of:
    - Gictransformer
    - Vsource
    range: float
    required: false
  X1:
    name: X1
    annotations:
      order:
        tag: order
        value: 14
    description: Positive-sequence reactance, ohms.
    comments:
    - 'Import: EnergySource.x = Reactance(X1, ''ohm''). Export: X1 = x.to(''ohm'').'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    exact_mappings:
    - cim:EnergySource.x
    rank: 1000
    owner: Vsource
    domain_of:
    - Vsource
    range: float
    required: false
  R0:
    name: R0
    annotations:
      order:
        tag: order
        value: 15
    description: Zero-sequence resistance, ohms.
    comments:
    - 'Import: EnergySource.r0 = Resistance(R0, ''ohm''). Export: R0 = r0.to(''ohm'').'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    exact_mappings:
    - cim:EnergySource.r0
    rank: 1000
    owner: Vsource
    domain_of:
    - Vsource
    range: float
    required: false
  X0:
    name: X0
    annotations:
      order:
        tag: order
        value: 16
    description: Zero-sequence reactance, ohms.
    comments:
    - 'Import: EnergySource.x0 = Reactance(X0, ''ohm''). Export: X0 = x0.to(''ohm'').'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    exact_mappings:
    - cim:EnergySource.x0
    rank: 1000
    owner: Vsource
    domain_of:
    - Vsource
    range: float
    required: false
  ScanType:
    name: ScanType
    annotations:
      order:
        tag: order
        value: 17
    description: '{pos*| zero | none} Maintain specified sequence for harmonic solution.'
    comments:
    - 'OpenDSS-only (N/A): harmonic analysis sequence type; no CIM equivalent.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    owner: Vsource
    domain_of:
    - Vsource
    range: string
    required: false
  Sequence:
    name: Sequence
    annotations:
      order:
        tag: order
        value: 18
    description: '{pos*| neg | zero} Set the phase angles for the specified symmetrical
      component sequence for non-harmonic solution modes.'
    comments:
    - 'OpenDSS-only (N/A): sequence assignment for symmetrical component models; no
      CIM equivalent.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    owner: Vsource
    domain_of:
    - Vsource
    range: string
    required: false
  bus2:
    name: bus2
    annotations:
      order:
        tag: order
        value: 19
    description: Name of bus to which 2nd terminal is connected. Default is the floating
      neutral node.
    comments:
    - 'OpenDSS-only (N/A): second terminal bus; CIM EnergySource is single-terminal
      (grounded neutral implicit).'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    owner: Vsource
    domain_of:
    - Gicline
    - Upfc
    - Capacitor
    - Line
    - Reactor
    - Fault
    - Vsource
    range: string
    required: false
  Z1:
    name: Z1
    annotations:
      order:
        tag: order
        value: 20
    description: Positive-sequence equivalent source impedance, ohms, as a 2-element
      complex array [R, X].
    todos:
    - Converter does not currently consume Z1 as an r/x source; would need to be added
      to the import fallback chain to roundtrip models that only set Z1.
    comments:
    - 'OpenDSS-only (N/A): alternate complex-array form for R1/X1; the current converter
      does not read Z1 (only scalar R1/X1 are consumed).'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    owner: Vsource
    domain_of:
    - Reactor
    - Vsource
    range: float
    required: false
  Z0:
    name: Z0
    annotations:
      order:
        tag: order
        value: 21
    description: Zero-sequence equivalent source impedance, ohms, as a 2-element complex
      array [R, X].
    todos:
    - Converter does not currently consume Z0 as an r0/x0 source; would need to be
      added to the import fallback chain to roundtrip models that only set Z0.
    comments:
    - 'OpenDSS-only (N/A): alternate complex-array form for R0/X0; the current converter
      does not read Z0 (only scalar R0/X0 are consumed).'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    owner: Vsource
    domain_of:
    - Reactor
    - Vsource
    range: float
    required: false
  Z2:
    name: Z2
    annotations:
      order:
        tag: order
        value: 22
    description: Negative-sequence equivalent source impedance, ohms, as a 2-element
      complex array [R, X].
    comments:
    - 'OpenDSS-only (N/A): negative-sequence impedance; no CIM equivalent on EnergySource.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    owner: Vsource
    domain_of:
    - Reactor
    - Vsource
    range: float
    required: false
  puZ1:
    name: puZ1
    annotations:
      order:
        tag: order
        value: 23
    description: Positive-sequence impedance in per-unit on source kVA base.
    todos:
    - Converter does not currently consume puZ1 as an r/x source; would need to be
      added to the import fallback chain to roundtrip models that only set puZ1.
    comments:
    - 'OpenDSS-only (N/A): alternate per-unit form for source impedance (z_base =
      basekv² / baseMVA); the current converter does not read puZ1.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    owner: Vsource
    domain_of:
    - Vsource
    range: float
    required: false
  puZ0:
    name: puZ0
    annotations:
      order:
        tag: order
        value: 24
    description: Zero-sequence impedance in per-unit.
    todos:
    - Converter does not currently consume puZ0 as an r0/x0 source; would need to
      be added to the import fallback chain to roundtrip models that only set puZ0.
    comments:
    - 'OpenDSS-only (N/A): alternate per-unit form for zero-sequence impedance; the
      current converter does not read puZ0.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    owner: Vsource
    domain_of:
    - Vsource
    range: float
    required: false
  puZ2:
    name: puZ2
    annotations:
      order:
        tag: order
        value: 25
    description: Negative-sequence impedance in per-unit.
    comments:
    - 'OpenDSS-only (N/A): negative-sequence per-unit impedance; no CIM equivalent.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    owner: Vsource
    domain_of:
    - Vsource
    range: float
    required: false
  baseMVA:
    name: baseMVA
    annotations:
      order:
        tag: order
        value: 26
    description: Base MVA for converting per-unit impedances. Default is 100 MVA.
    comments:
    - 'OpenDSS-only (N/A): would be used as the per-unit base for puZ1/puZ0/puZ2 conversion,
      but the converter does not currently read those fields (see their comments);
      not stored on CIM EnergySource.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    owner: Vsource
    domain_of:
    - Vsource
    range: float
    required: false
  Yearly:
    name: Yearly
    annotations:
      order:
        tag: order
        value: 27
    description: LOADSHAPE object to use for the per-unit voltage for YEARLY-mode
      simulations.
    todos:
    - Loadshape converter not yet implemented.
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    related_mappings:
    - cim:SeasonDayTypeSchedule
    owner: Vsource
    domain_of:
    - Generic5
    - Indmach012
    - Storagecontroller
    - Isource
    - Vsource
    range: string
    required: false
  Daily:
    name: Daily
    annotations:
      order:
        tag: order
        value: 28
    description: LOADSHAPE object to use for the per-unit voltage for DAILY-mode simulations.
    todos:
    - Loadshape converter not yet implemented.
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    related_mappings:
    - cim:SeasonDayTypeSchedule
    owner: Vsource
    domain_of:
    - Generic5
    - Indmach012
    - Storagecontroller
    - Isource
    - Vsource
    range: string
    required: false
  Duty:
    name: Duty
    annotations:
      order:
        tag: order
        value: 29
    description: LOADSHAPE object to use for the per-unit voltage for DUTYCYCLE-mode
      simulations.
    todos:
    - Loadshape converter not yet implemented.
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    related_mappings:
    - cim:SeasonDayTypeSchedule
    owner: Vsource
    domain_of:
    - Generic5
    - Indmach012
    - Storagecontroller
    - Isource
    - Vsource
    range: string
    required: false
  Model:
    name: Model
    annotations:
      order:
        tag: order
        value: 30
    description: '{Thevenin* | Ideal} Specifies whether the Vsource is to be considered
      a Thevenin short circuit model or a quasi-ideal voltage source.'
    comments:
    - 'OpenDSS-only (N/A): source model type selector; no CIM equivalent on EnergySource.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    owner: Vsource
    domain_of:
    - Vsource
    range: string
    required: false
  puZideal:
    name: puZideal
    annotations:
      order:
        tag: order
        value: 31
    description: Per-unit series impedance when Model=Ideal.
    comments:
    - 'OpenDSS-only (N/A): ideal source series impedance; no CIM equivalent.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    rank: 1000
    owner: Vsource
    domain_of:
    - Vsource
    range: float
    required: false
  spectrum:
    name: spectrum
    annotations:
      order:
        tag: order
        value: 32
    description: Name of harmonic spectrum for this source.
    comments:
    - 'OpenDSS-only (N/A): harmonic spectrum reference; no CIM equivalent in the standard
      profile.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    owner: Vsource
    domain_of:
    - Load
    - Generator
    - Generic5
    - Gicline
    - Indmach012
    - Pvsystem
    - Storage
    - Upfc
    - Vccs
    - Vsconverter
    - Windgen
    - Gicsource
    - Isource
    - Vsource
    range: string
    required: false
  basefreq:
    name: basefreq
    annotations:
      order:
        tag: order
        value: 33
    description: Base Frequency for ratings.
    comments:
    - Not stored on CIM EnergySource; base frequency is a circuit-level property.
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    owner: Vsource
    domain_of:
    - Load
    - Generator
    - Generic5
    - Gicline
    - Indmach012
    - Pvsystem
    - Storage
    - Upfc
    - Vccs
    - Vsconverter
    - Windgen
    - Autotrans
    - Capacitor
    - Gictransformer
    - Line
    - Reactor
    - Transformer
    - Capcontrol
    - Espvlcontrol
    - Expcontrol
    - Fuse
    - Gendispatcher
    - Invcontrol
    - Pycontrol
    - Recloser
    - Regcontrol
    - Relay
    - Storagecontroller
    - Swtcontrol
    - Upfccontrol
    - Energymeter
    - Fmonitor
    - Monitor
    - Sensor
    - Fault
    - Gicsource
    - Isource
    - Vsource
    range: float
    required: false
  enabled:
    name: enabled
    annotations:
      order:
        tag: order
        value: 34
    description: '{Yes|No or True|False} Indicates whether this element is enabled.'
    comments:
    - 'OpenDSS-only (N/A): if False, converter returns None and no CIM object is created.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    owner: Vsource
    domain_of:
    - Load
    - Generator
    - Generic5
    - Gicline
    - Indmach012
    - Pvsystem
    - Storage
    - Upfc
    - Vccs
    - Vsconverter
    - Windgen
    - Autotrans
    - Capacitor
    - Gictransformer
    - Line
    - Reactor
    - Transformer
    - Capcontrol
    - Espvlcontrol
    - Expcontrol
    - Fuse
    - Gendispatcher
    - Invcontrol
    - Pycontrol
    - Recloser
    - Regcontrol
    - Relay
    - Storagecontroller
    - Swtcontrol
    - Upfccontrol
    - Energymeter
    - Fmonitor
    - Monitor
    - Sensor
    - Fault
    - Gicsource
    - Isource
    - Vsource
    range: boolean
    required: false
  like:
    name: like
    annotations:
      order:
        tag: order
        value: 35
    description: 'Make like another object, e.g.: New Vsource.V2 like=V1 ...'
    comments:
    - 'OpenDSS-only (N/A): DSS template/copy directive resolved at parse time; no
      CIM equivalent.'
    from_schema: https://gridappsd.github.io/dss-graph/other/vsource
    owner: Vsource
    domain_of:
    - Load
    - Generator
    - Generic5
    - Gicline
    - Indmach012
    - Pvsystem
    - Storage
    - Upfc
    - Vccs
    - Vsconverter
    - Windgen
    - Autotrans
    - Capacitor
    - Gictransformer
    - Line
    - Reactor
    - Transformer
    - Capcontrol
    - Espvlcontrol
    - Expcontrol
    - Fuse
    - Gendispatcher
    - Invcontrol
    - Pycontrol
    - Recloser
    - Regcontrol
    - Relay
    - Storagecontroller
    - Swtcontrol
    - Upfccontrol
    - Cndata
    - Dynamicexp
    - Growthshape
    - Linecode
    - Linegeometry
    - Linespacing
    - Loadshape
    - Priceshape
    - Spectrum
    - TccCurve
    - Tsdata
    - Tshape
    - Wiredata
    - Xfmrcode
    - Xycurve
    - Energymeter
    - Fmonitor
    - Monitor
    - Sensor
    - Fault
    - Gicsource
    - Isource
    - Vsource
    range: string
    required: false
class_uri: dss:Vsource