Skip to content

Class: VoltageLevel

A collection of equipment at one common system voltage forming a switchgear. The equipment typically consists of breakers, busbars, instrumentation, control, regulation and protection devices as well as assemblies of all these.

URI: cim:VoltageLevel

 classDiagram
    class VoltageLevel
      EquipmentContainer <|-- VoltageLevel

      VoltageLevel : additional_grouped_equipment

          VoltageLevel --> Equipment : additional_grouped_equipment

      VoltageLevel : alias_name

      VoltageLevel : asset_datasheet

          VoltageLevel --> AssetInfo : asset_datasheet

      VoltageLevel : assets

          VoltageLevel --> Asset : assets

      VoltageLevel : base_voltage

          VoltageLevel --> BaseVoltage : base_voltage

      VoltageLevel : bays

          VoltageLevel --> Bay : bays

      VoltageLevel : clearances

          VoltageLevel --> ClearanceDocument : clearances

      VoltageLevel : configuration_event

          VoltageLevel --> ConfigurationEvent : configuration_event

      VoltageLevel : connectivity_nodes

          VoltageLevel --> ConnectivityNode : connectivity_nodes

      VoltageLevel : controls

          VoltageLevel --> Control : controls

      VoltageLevel : description

      VoltageLevel : diagram_objects

          VoltageLevel --> DiagramObject : diagram_objects

      VoltageLevel : equipments

          VoltageLevel --> Equipment : equipments

      VoltageLevel : generic_action

          VoltageLevel --> GenericAction : generic_action

      VoltageLevel : high_voltage_limit

          VoltageLevel --> Voltage : high_voltage_limit

      VoltageLevel : instance_set

          VoltageLevel --> InstanceSet : instance_set

      VoltageLevel : location

          VoltageLevel --> Location : location

      VoltageLevel : low_voltage_limit

          VoltageLevel --> Voltage : low_voltage_limit

      VoltageLevel : m_rid

      VoltageLevel : measurements

          VoltageLevel --> Measurement : measurements

      VoltageLevel : names

          VoltageLevel --> Name : names

      VoltageLevel : operating_share

          VoltageLevel --> OperatingShare : operating_share

      VoltageLevel : operational_tags

          VoltageLevel --> OperationalTag : operational_tags

      VoltageLevel : properties_cimdata_object

          VoltageLevel --> ChangeSetMember : properties_cimdata_object

      VoltageLevel : psrevents

          VoltageLevel --> PSREvent : psrevents

      VoltageLevel : psrtype

          VoltageLevel --> PSRType : psrtype

      VoltageLevel : reporting_group

          VoltageLevel --> ReportingGroup : reporting_group

      VoltageLevel : substation

          VoltageLevel --> Substation : substation

      VoltageLevel : targeting_cimdata_object

          VoltageLevel --> ChangeSetMember : targeting_cimdata_object

      VoltageLevel : topological_node

          VoltageLevel --> TopologicalNode : topological_node

      VoltageLevel : verification_action

          VoltageLevel --> VerificationAction : verification_action

Inheritance

Slots

Name Cardinality and Range Description Inheritance
high_voltage_limit 0..1
Voltage
The bus bar's high voltage limit direct
low_voltage_limit 0..1
Voltage
The bus bar's low voltage limit direct
bays 0..*
Bay
The bays within this voltage level direct
base_voltage 1..1
BaseVoltage
The base voltage used for all equipment within the voltage level direct
substation 1..1
Substation
The substation of the voltage level direct
equipments 0..*
Equipment
Contained equipment EquipmentContainer
additional_grouped_equipment 0..*
Equipment
The additonal contained equipment EquipmentContainer
topological_node 0..*
TopologicalNode
The topological nodes which belong to this connectivity node container ConnectivityNodeContainer
connectivity_nodes 0..*
ConnectivityNode
Connectivity nodes which belong to this connectivity node container ConnectivityNodeContainer
controls 0..*
Control
The controller outputs used to actually govern a regulating device, e PowerSystemResource
measurements 0..*
Measurement
The measurements associated with this power system resource PowerSystemResource
psrtype 0..1
PSRType
Custom classification for this power system resource PowerSystemResource
configuration_event 0..*
ConfigurationEvent
All configuration events created for this Power System resource PowerSystemResource
reporting_group 0..*
ReportingGroup
Reporting groups to which this power system resource belongs PowerSystemResource
operating_share 0..*
OperatingShare
The operating shares of this power system resource PowerSystemResource
asset_datasheet 0..1
AssetInfo
Datasheet information for this power system resource PowerSystemResource
verification_action 0..*
VerificationAction
The verification action that is performed on the power system resource PowerSystemResource
clearances 0..*
ClearanceDocument
All clearances applicable to this power system resource PowerSystemResource
generic_action 0..*
GenericAction
The generic action that is performed on the power system resource PowerSystemResource
psrevents 0..*
PSREvent
All events associated with this power system resource PowerSystemResource
assets 0..*
Asset
All assets represented by this power system resource PowerSystemResource
location 0..1
Location
Location of this power system resource PowerSystemResource
operational_tags 0..*
OperationalTag
All operational tags placed on this power system resource PowerSystemResource
alias_name 0..1
String
The aliasName is free text human readable name of the object alternative to I... IdentifiedObject
description 0..1
String
The description is a free human readable text describing or naming the object IdentifiedObject
m_rid 0..1
String
Master resource identifier issued by a model authority IdentifiedObject
diagram_objects 0..*
DiagramObject
The diagram objects that are associated with the domain object IdentifiedObject
instance_set 1..1
InstanceSet
Dataset containing the data objects IdentifiedObject
names 0..*
Name
All names of this identified object IdentifiedObject
properties_cimdata_object 0..1
ChangeSetMember
The single CIM data object in the appropriate dataset context IdentifiedObject
targeting_cimdata_object 0..*
ChangeSetMember
Data objects registered IdentifiedObject

Usages

used by used in type used
BaseVoltage voltage_level range VoltageLevel
Substation voltage_levels range VoltageLevel
Bay voltage_level range VoltageLevel

Identifier and Mapping Information

Schema Source

  • from schema: https://cim.ucaiug.io/ns#TC57CIM

Mappings

Mapping Type Mapped Value
self cim:VoltageLevel
native cim:VoltageLevel

LinkML Source

Direct

name: VoltageLevel
description: A collection of equipment at one common system voltage forming a switchgear.
  The equipment typically consists of breakers, busbars, instrumentation, control,
  regulation and protection devices as well as assemblies of all these.
from_schema: https://cim.ucaiug.io/ns#TC57CIM
rank: 1000
is_a: EquipmentContainer
attributes:
  high_voltage_limit:
    name: high_voltage_limit
    description: "The bus bar's high voltage limit.\r\nThe limit applies to all equipment\
      \ and nodes contained in a given VoltageLevel. It is not required that it is\
      \ exchanged in pair with lowVoltageLimit. It is preferable to use operational\
      \ VoltageLimit, which prevails, if present."
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:VoltageLevel.highVoltageLimit
    multivalued: false
    domain_of:
    - VoltageLevel
    range: Voltage
    required: false
  low_voltage_limit:
    name: low_voltage_limit
    description: "The bus bar's low voltage limit.\r\nThe limit applies to all equipment\
      \ and nodes contained in a given VoltageLevel. It is not required that it is\
      \ exchanged in pair with highVoltageLimit. It is preferable to use operational\
      \ VoltageLimit, which prevails, if present."
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:VoltageLevel.lowVoltageLimit
    multivalued: false
    domain_of:
    - VoltageLevel
    range: Voltage
    required: false
  bays:
    name: bays
    description: The bays within this voltage level.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:VoltageLevel.Bays
    multivalued: true
    domain_of:
    - VoltageLevel
    - Substation
    range: Bay
    required: false
  base_voltage:
    name: base_voltage
    description: The base voltage used for all equipment within the voltage level.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    slot_uri: cim:VoltageLevel.BaseVoltage
    multivalued: false
    domain_of:
    - TopologicalNode
    - TransformerEnd
    - ConductingEquipment
    - VoltageLevel
    - AssetDeployment
    range: BaseVoltage
    required: true
  substation:
    name: substation
    description: The substation of the voltage level.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:VoltageLevel.Substation
    multivalued: false
    domain_of:
    - VoltageLevel
    - Bay
    - DCConverterUnit
    range: Substation
    required: true
class_uri: cim:VoltageLevel

Induced

name: VoltageLevel
description: A collection of equipment at one common system voltage forming a switchgear.
  The equipment typically consists of breakers, busbars, instrumentation, control,
  regulation and protection devices as well as assemblies of all these.
from_schema: https://cim.ucaiug.io/ns#TC57CIM
rank: 1000
is_a: EquipmentContainer
attributes:
  high_voltage_limit:
    name: high_voltage_limit
    description: "The bus bar's high voltage limit.\r\nThe limit applies to all equipment\
      \ and nodes contained in a given VoltageLevel. It is not required that it is\
      \ exchanged in pair with lowVoltageLimit. It is preferable to use operational\
      \ VoltageLimit, which prevails, if present."
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:VoltageLevel.highVoltageLimit
    multivalued: false
    alias: high_voltage_limit
    owner: VoltageLevel
    domain_of:
    - VoltageLevel
    range: Voltage
    required: false
  low_voltage_limit:
    name: low_voltage_limit
    description: "The bus bar's low voltage limit.\r\nThe limit applies to all equipment\
      \ and nodes contained in a given VoltageLevel. It is not required that it is\
      \ exchanged in pair with highVoltageLimit. It is preferable to use operational\
      \ VoltageLimit, which prevails, if present."
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:VoltageLevel.lowVoltageLimit
    multivalued: false
    alias: low_voltage_limit
    owner: VoltageLevel
    domain_of:
    - VoltageLevel
    range: Voltage
    required: false
  bays:
    name: bays
    description: The bays within this voltage level.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:VoltageLevel.Bays
    multivalued: true
    alias: bays
    owner: VoltageLevel
    domain_of:
    - VoltageLevel
    - Substation
    range: Bay
    required: false
  base_voltage:
    name: base_voltage
    description: The base voltage used for all equipment within the voltage level.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    slot_uri: cim:VoltageLevel.BaseVoltage
    multivalued: false
    alias: base_voltage
    owner: VoltageLevel
    domain_of:
    - TopologicalNode
    - TransformerEnd
    - ConductingEquipment
    - VoltageLevel
    - AssetDeployment
    range: BaseVoltage
    required: true
  substation:
    name: substation
    description: The substation of the voltage level.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:VoltageLevel.Substation
    multivalued: false
    alias: substation
    owner: VoltageLevel
    domain_of:
    - VoltageLevel
    - Bay
    - DCConverterUnit
    range: Substation
    required: true
  equipments:
    name: equipments
    description: Contained equipment.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:EquipmentContainer.Equipments
    multivalued: true
    alias: equipments
    owner: VoltageLevel
    domain_of:
    - EquipmentContainer
    - UsagePoint
    - OperationalRestriction
    - Outage
    range: Equipment
    required: false
  additional_grouped_equipment:
    name: additional_grouped_equipment
    description: The additonal contained equipment.  The equipment belong to the equipment
      container. The equipment is contained in another equipment container, but also
      grouped with this equipment container.  Examples include when a switch contained
      in a substation is also desired to be grouped with a line contianer or when
      a switch is included in a secondary substation and also grouped in a feeder.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:EquipmentContainer.AdditionalGroupedEquipment
    multivalued: true
    alias: additional_grouped_equipment
    owner: VoltageLevel
    domain_of:
    - EquipmentContainer
    range: Equipment
    required: false
  topological_node:
    name: topological_node
    description: The topological nodes which belong to this connectivity node container.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    slot_uri: cim:ConnectivityNodeContainer.TopologicalNode
    multivalued: true
    alias: topological_node
    owner: VoltageLevel
    domain_of:
    - ReportingGroup
    - BusNameMarker
    - ConnectivityNodeContainer
    - SvInjection
    - SvVoltage
    - ConnectivityNode
    - Terminal
    - BaseVoltage
    range: TopologicalNode
    required: false
  connectivity_nodes:
    name: connectivity_nodes
    description: Connectivity nodes which belong to this connectivity node container.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:ConnectivityNodeContainer.ConnectivityNodes
    multivalued: true
    alias: connectivity_nodes
    owner: VoltageLevel
    domain_of:
    - ConnectivityNodeContainer
    - TopologicalNode
    range: ConnectivityNode
    required: false
  controls:
    name: controls
    description: The controller outputs used to actually govern a regulating device,
      e.g. the magnetization of a synchronous machine or capacitor bank breaker actuator.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:PowerSystemResource.Controls
    multivalued: true
    alias: controls
    owner: VoltageLevel
    domain_of:
    - PowerSystemResource
    - HostControlArea
    range: Control
    required: false
  measurements:
    name: measurements
    description: The measurements associated with this power system resource.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:PowerSystemResource.Measurements
    multivalued: true
    alias: measurements
    owner: VoltageLevel
    domain_of:
    - PowerSystemResource
    - ACDCTerminal
    - Asset
    - Location
    - Procedure
    - AnalogLimitSet
    - AccumulatorLimitSet
    range: Measurement
    required: false
  psrtype:
    name: psrtype
    description: Custom classification for this power system resource.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:PowerSystemResource.PSRType
    multivalued: false
    alias: psrtype
    owner: VoltageLevel
    domain_of:
    - PowerSystemResource
    range: PSRType
    required: false
  configuration_event:
    name: configuration_event
    description: All configuration events created for this Power System resource.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:PowerSystemResource.ConfigurationEvent
    multivalued: true
    alias: configuration_event
    owner: VoltageLevel
    domain_of:
    - PowerSystemResource
    - FaultCauseType
    range: ConfigurationEvent
    required: false
  reporting_group:
    name: reporting_group
    description: Reporting groups to which this power system resource belongs.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:PowerSystemResource.ReportingGroup
    multivalued: true
    alias: reporting_group
    owner: VoltageLevel
    domain_of:
    - PowerSystemResource
    - BusNameMarker
    - TopologicalNode
    - ReportingSuperGroup
    range: ReportingGroup
    required: false
  operating_share:
    name: operating_share
    description: The operating shares of this power system resource.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:PowerSystemResource.OperatingShare
    multivalued: true
    alias: operating_share
    owner: VoltageLevel
    domain_of:
    - PowerSystemResource
    - OperatingParticipant
    range: OperatingShare
    required: false
  asset_datasheet:
    name: asset_datasheet
    description: Datasheet information for this power system resource.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:PowerSystemResource.AssetDatasheet
    multivalued: false
    alias: asset_datasheet
    owner: VoltageLevel
    domain_of:
    - PowerSystemResource
    range: AssetInfo
    required: false
  verification_action:
    name: verification_action
    description: The verification action that is performed on the power system resource
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:PowerSystemResource.VerificationAction
    multivalued: true
    alias: verification_action
    owner: VoltageLevel
    domain_of:
    - PowerSystemResource
    range: VerificationAction
    required: false
  clearances:
    name: clearances
    description: All clearances applicable to this power system resource.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:PowerSystemResource.Clearances
    multivalued: true
    alias: clearances
    owner: VoltageLevel
    domain_of:
    - PowerSystemResource
    range: ClearanceDocument
    required: false
  generic_action:
    name: generic_action
    description: The generic action that is performed on the power system resource
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:PowerSystemResource.GenericAction
    multivalued: true
    alias: generic_action
    owner: VoltageLevel
    domain_of:
    - PowerSystemResource
    range: GenericAction
    required: false
  psrevents:
    name: psrevents
    description: All events associated with this power system resource.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:PowerSystemResource.PSREvents
    multivalued: true
    alias: psrevents
    owner: VoltageLevel
    domain_of:
    - PowerSystemResource
    range: PSREvent
    required: false
  assets:
    name: assets
    description: All assets represented by this power system resource. For example,
      multiple conductor assets are electrically modelled as a single AC line segment.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:PowerSystemResource.Assets
    multivalued: true
    alias: assets
    owner: VoltageLevel
    domain_of:
    - PowerSystemResource
    - AssetInfo
    - Location
    - WorkTask
    - ErpRecDelvLineItem
    - AssetContainer
    - ActivityRecord
    - Procedure
    - ReliabilityInfo
    - AssetPropertyCurve
    - AssetOrganisationRole
    - ScheduledEvent
    range: Asset
    required: false
  location:
    name: location
    description: Location of this power system resource.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:PowerSystemResource.Location
    multivalued: false
    alias: location
    owner: VoltageLevel
    domain_of:
    - PowerSystemResource
    - Asset
    - Incident
    - SwitchingOrder
    - TroubleOrder
    - Crew
    - Fault
    - PointOfSale
    - TroubleTicket
    - OutageOrder
    - EnvironmentalMonitoringStation
    - EnvironmentalLocationType
    - PositionPoint
    - FailureEvent
    range: Location
    required: false
  operational_tags:
    name: operational_tags
    description: All operational tags placed on this power system resource.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:PowerSystemResource.OperationalTags
    multivalued: true
    alias: operational_tags
    owner: VoltageLevel
    domain_of:
    - PowerSystemResource
    - Asset
    range: OperationalTag
    required: false
  alias_name:
    name: alias_name
    description: "The aliasName is free text human readable name of the object alternative\
      \ to IdentifiedObject.name. It may be non unique and may not correlate to a\
      \ naming hierarchy.\r\nThe attribute aliasName is retained because of backwards\
      \ compatibility between CIM relases. It is however recommended to replace aliasName\
      \ with the Name class as aliasName is planned for retirement at a future time.\r\
      \n\r\n"
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.aliasName
    multivalued: false
    alias: alias_name
    owner: VoltageLevel
    domain_of:
    - IdentifiedObject
    range: string
    required: false
  description:
    name: description
    description: The description is a free human readable text describing or naming
      the object. It may be non unique and may not correlate to a naming hierarchy.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.description
    multivalued: false
    alias: description
    owner: VoltageLevel
    domain_of:
    - IdentifiedObject
    - NameType
    - NameTypeAuthority
    - DataSet
    - SwitchingStepGroup
    - AreaReserveSpec
    range: string
    required: false
  m_rid:
    name: m_rid
    description: "Master resource identifier issued by a model authority. The mRID\
      \ is unique within an exchange context. Global uniqueness is easily achieved\
      \ by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is\
      \ strongly recommended.\r\nFor CIMXML data files in RDF syntax conforming to\
      \ IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify\
      \ CIM object elements."
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.mRID
    multivalued: false
    alias: m_rid
    owner: VoltageLevel
    domain_of:
    - IdentifiedObject
    - DataSet
    range: string
    required: false
  diagram_objects:
    name: diagram_objects
    description: The diagram objects that are associated with the domain object.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.DiagramObjects
    multivalued: true
    alias: diagram_objects
    owner: VoltageLevel
    domain_of:
    - IdentifiedObject
    range: DiagramObject
    required: false
  instance_set:
    name: instance_set
    description: Dataset containing the data objects.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.InstanceSet
    multivalued: false
    alias: instance_set
    owner: VoltageLevel
    domain_of:
    - IdentifiedObject
    range: InstanceSet
    required: true
  names:
    name: names
    description: All names of this identified object.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.Names
    multivalued: true
    alias: names
    owner: VoltageLevel
    domain_of:
    - IdentifiedObject
    - NameType
    range: Name
    required: false
  properties_cimdata_object:
    name: properties_cimdata_object
    description: The single CIM data object in the appropriate dataset context.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.PropertiesCIMDataObject
    multivalued: false
    alias: properties_cimdata_object
    owner: VoltageLevel
    domain_of:
    - IdentifiedObject
    range: ChangeSetMember
    required: false
  targeting_cimdata_object:
    name: targeting_cimdata_object
    description: Data objects registered.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.TargetingCIMDataObject
    multivalued: true
    alias: targeting_cimdata_object
    owner: VoltageLevel
    domain_of:
    - IdentifiedObject
    range: ChangeSetMember
    required: false
class_uri: cim:VoltageLevel