Skip to content

Class: Switch

A generic device designed to close, or open, or both, one or more electric circuits. All switches are two terminal devices including grounding switches. The ACDCTerminal.connected at the two sides of the switch shall not be considered for assessing switch connectivity, i.e. only Switch.open, .normalOpen and .locked are relevant.

URI: cim:Switch

 classDiagram
    class Switch
      ConductingEquipment <|-- Switch


      Switch <|-- ProtectedSwitch
      Switch <|-- Disconnector


      Switch : Equipment.aggregate

      Switch : ConductingEquipment.BaseVoltage

          Switch --> BaseVoltage : ConductingEquipment.BaseVoltage

      Switch : IdentifiedObject.description

      Switch : IdentifiedObject.energyIdentCodeEic

      Switch : Equipment.EquipmentContainer

          Switch --> EquipmentContainer : Equipment.EquipmentContainer

      Switch : IdentifiedObject.mRID

      Switch : IdentifiedObject.Names

          Switch --> Name : IdentifiedObject.Names

      Switch : Switch.normalOpen

      Switch : Equipment.normallyInService

      Switch : Switch.ratedCurrent

          Switch --> CurrentFlow : Switch.ratedCurrent

      Switch : Switch.retained

      Switch : IdentifiedObject.shortName

      Switch : ConductingEquipment.Terminals

          Switch --> Terminal : ConductingEquipment.Terminals

Inheritance

Slots

Name Cardinality and Range Description Inheritance
normal_open 1..1
Boolean
The attribute is used in cases when no Measurement for the status value is pr... direct
rated_current 0..1
CurrentFlow
The maximum continuous current carrying capacity in amps governed by the devi... direct
retained 1..1
Boolean
Branch is retained in the topological solution direct
base_voltage 0..1
BaseVoltage
Base voltage of this conducting equipment ConductingEquipment
terminals 0..*
Terminal
Conducting equipment have terminals that may be connected to other conducting... ConductingEquipment
aggregate 0..1
Boolean
The aggregate flag provides an alternative way of representing an aggregated ... Equipment
normally_in_service 0..1
Boolean
Specifies the availability of the equipment under normal operating conditions Equipment
equipment_container 0..1
EquipmentContainer
Container of this equipment Equipment
description 0..1
String
The description is a free human readable text describing or naming the object IdentifiedObject
energy_ident_code_eic 0..1
String
The attribute is used for an exchange of the EIC code (Energy identification ... IdentifiedObject
m_rid 1..1
String
Master resource identifier issued by a model authority IdentifiedObject
short_name 0..1
String
The attribute is used for an exchange of a human readable short name with len... IdentifiedObject
names 0..*
Name
All names of this identified object IdentifiedObject

Identifier and Mapping Information

Schema Source

  • from schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile

Mappings

Mapping Type Mapped Value
self cim:Switch
native this:Switch

LinkML Source

Direct

name: Switch
description: A generic device designed to close, or open, or both, one or more electric
  circuits.  All switches are two terminal devices including grounding switches. The
  ACDCTerminal.connected at the two sides of the switch shall not be considered for
  assessing switch connectivity, i.e. only Switch.open, .normalOpen and .locked are
  relevant.
from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
rank: 1000
is_a: ConductingEquipment
attributes:
  normal_open:
    name: normal_open
    description: The attribute is used in cases when no Measurement for the status
      value is present. If the Switch has a status measurement the Discrete.normalValue
      is expected to match with the Switch.normalOpen.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:Switch.normalOpen
    multivalued: false
    domain_of:
    - Switch
    range: boolean
    required: true
  rated_current:
    name: rated_current
    description: 'The maximum continuous current carrying capacity in amps governed
      by the device material and construction.

      The attribute shall be a positive value.'
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:Switch.ratedCurrent
    multivalued: false
    domain_of:
    - Switch
    - BusbarSectionInfo
    - WireInfo
    range: CurrentFlow
    required: false
  retained:
    name: retained
    description: Branch is retained in the topological solution.  The flow through
      retained switches will normally be calculated in power flow.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:Switch.retained
    multivalued: false
    domain_of:
    - Switch
    range: boolean
    required: true
class_uri: cim:Switch

Induced

name: Switch
description: A generic device designed to close, or open, or both, one or more electric
  circuits.  All switches are two terminal devices including grounding switches. The
  ACDCTerminal.connected at the two sides of the switch shall not be considered for
  assessing switch connectivity, i.e. only Switch.open, .normalOpen and .locked are
  relevant.
from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
rank: 1000
is_a: ConductingEquipment
attributes:
  normal_open:
    name: normal_open
    description: The attribute is used in cases when no Measurement for the status
      value is present. If the Switch has a status measurement the Discrete.normalValue
      is expected to match with the Switch.normalOpen.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:Switch.normalOpen
    multivalued: false
    alias: normal_open
    owner: Switch
    domain_of:
    - Switch
    range: boolean
    required: true
  rated_current:
    name: rated_current
    description: 'The maximum continuous current carrying capacity in amps governed
      by the device material and construction.

      The attribute shall be a positive value.'
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:Switch.ratedCurrent
    multivalued: false
    alias: rated_current
    owner: Switch
    domain_of:
    - Switch
    - BusbarSectionInfo
    - WireInfo
    range: CurrentFlow
    required: false
  retained:
    name: retained
    description: Branch is retained in the topological solution.  The flow through
      retained switches will normally be calculated in power flow.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:Switch.retained
    multivalued: false
    alias: retained
    owner: Switch
    domain_of:
    - Switch
    range: boolean
    required: true
  base_voltage:
    name: base_voltage
    description: Base voltage of this conducting equipment.  Use only when there is
      no voltage level container used and only one base voltage applies.  For example,
      not used for transformers.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:ConductingEquipment.BaseVoltage
    multivalued: false
    alias: base_voltage
    owner: Switch
    domain_of:
    - ConductingEquipment
    - VoltageLevel
    - TransformerEnd
    range: BaseVoltage
    required: false
  terminals:
    name: terminals
    description: Conducting equipment have terminals that may be connected to other
      conducting equipment terminals via connectivity nodes or topological nodes.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:ConductingEquipment.Terminals
    multivalued: true
    alias: terminals
    owner: Switch
    domain_of:
    - ConductingEquipment
    - ConnectivityNode
    range: Terminal
    required: false
  aggregate:
    name: aggregate
    description: "The aggregate flag provides an alternative way of representing an\
      \ aggregated (equivalent) element. It is applicable in cases when the dedicated\
      \ classes for equivalent equipment do not have all of the attributes necessary\
      \ to represent the required level of detail.  In case the flag is set to “true”\
      \ the single instance of equipment represents multiple pieces of equipment that\
      \ have been modelled together as an aggregate equivalent obtained by a network\
      \ reduction procedure. Examples would be power transformers or synchronous machines\
      \ operating in parallel modelled as a single aggregate power transformer or\
      \ aggregate synchronous machine.  \nThe attribute is not used for EquivalentBranch,\
      \ EquivalentShunt and EquivalentInjection."
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:Equipment.aggregate
    multivalued: false
    alias: aggregate
    owner: Switch
    domain_of:
    - Equipment
    range: boolean
    required: false
  normally_in_service:
    name: normally_in_service
    description: Specifies the availability of the equipment under normal operating
      conditions. True means the equipment is available for topology processing, which
      determines if the equipment is energized or not. False means that the equipment
      is treated by network applications as if it is not in the model.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:Equipment.normallyInService
    multivalued: false
    alias: normally_in_service
    owner: Switch
    domain_of:
    - Equipment
    range: boolean
    required: false
  equipment_container:
    name: equipment_container
    description: Container of this equipment.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:Equipment.EquipmentContainer
    multivalued: false
    alias: equipment_container
    owner: Switch
    domain_of:
    - Equipment
    range: EquipmentContainer
    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: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:IdentifiedObject.description
    multivalued: false
    alias: description
    owner: Switch
    domain_of:
    - IdentifiedObject
    - NameType
    - NameTypeAuthority
    range: string
    required: false
  energy_ident_code_eic:
    name: energy_ident_code_eic
    description: The attribute is used for an exchange of the EIC code (Energy identification
      Code). The length of the string is 16 characters as defined by the EIC code.
      For details on EIC scheme please refer to ENTSO-E web site.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: eu:IdentifiedObject.energyIdentCodeEic
    multivalued: false
    alias: energy_ident_code_eic
    owner: Switch
    domain_of:
    - IdentifiedObject
    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.

      For 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: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:IdentifiedObject.mRID
    multivalued: false
    alias: m_rid
    owner: Switch
    domain_of:
    - IdentifiedObject
    range: string
    required: true
  short_name:
    name: short_name
    description: The attribute is used for an exchange of a human readable short name
      with length of the string 12 characters maximum.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: eu:IdentifiedObject.shortName
    multivalued: false
    alias: short_name
    owner: Switch
    domain_of:
    - IdentifiedObject
    range: string
    required: false
  names:
    name: names
    description: All names of this identified object.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:IdentifiedObject.Names
    multivalued: true
    alias: names
    owner: Switch
    domain_of:
    - IdentifiedObject
    - NameType
    range: Name
    required: false
class_uri: cim:Switch