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.
No Additional PropertiesPointer to Location object
Must match regular expression:^Location::'(.+)'$
Pointer to SwitchingAction object
Must match regular expression:^SwitchingAction::'(.+)'$
Pointer to SwitchingAction object
Must match regular expression:^SwitchingAction::'(.+)'$
Array of Terminal objects
No Additional ItemsAn AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.
No Additional PropertiesPointer to ConnectivityNode object
Must match regular expression:^ConnectivityNode::'(.+)'$
The connected status is related to a bus-branch model and the topological node to terminal relation. True implies the terminal is connected to the related topological node and false implies it is not.
In a bus-branch model, the connected status is used to tell if equipment is disconnected without having to change the connectivity described by the topological node to terminal relation. A valid case is that conducting equipment can be connected in one end and open in the other. In particular for an AC line segment, where the reactive line charging can be significant, this is a relevant case.
Represents the normal network phasing condition. If the attribute is missing, three phases (ABC) shall be assumed, except for terminals of grounding classes (specializations of EarthFaultCompensator, GroundDisconnector, and Ground) which will be assumed to be N. Therefore, phase code ABCN is explicitly declared when needed, e.g. for star point grounding equipment.
The phase code on terminals connecting same ConnectivityNode or same TopologicalNode as well as for equipment between two terminals shall be consistent.
The orientation of the terminal connections for a multiple terminal conducting equipment. The sequence numbering starts with 1 and additional terminals should follow in increasing order. The first terminal is the "starting point" for a two terminal branch.
Used in RAVENS Schema to identify the corresponding CIM Object Type of the JSON object.
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.
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.
The 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.
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.
The name is any free human readable and possibly non unique text naming the object.
Array of SvSwitch objects
No Additional ItemsState variable for switch.
No Additional PropertiesThe terminal phase at which the connection is applied. If missing, the injection is assumed to be balanced among non-neutral phases.
The attribute tells if the computed state of the switch is considered open.
Used in RAVENS Schema to identify the corresponding CIM Object Type of the JSON object.
Pointer to SwitchInfo object
Must match regular expression:^SwitchInfo::'(.+)'$
Pointer to BaseVoltage object
Must match regular expression:^BaseVoltage::'(.+)'$
Array of SwitchPhase objects
No Additional ItemsSingle phase of a multi-phase switch when its attributes might be different per phase.
No Additional PropertiesUsed in cases when no Measurement for the status value is present. If the SwitchPhase has a status measurement the Discrete.normalValue is expected to match with this value.
Phase of this SwitchPhase on the side with terminal sequence number equal to 1. Should be a phase contained in that terminal’s phases attribute.
Phase of this SwitchPhase on the side with terminal sequence number equal to 2. Should be a phase contained in that terminal’s Terminal.phases attribute.
Used in RAVENS Schema to identify the corresponding CIM Object Type of the JSON object.
The attribute tells if the switch is considered closed when used as input to topology processing.
The maximum continuous current carrying capacity in amps governed by the device material and construction.
The attribute shall be a positive value.
nan
nan
nan
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.
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.
The 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.
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.
The name is any free human readable and possibly non unique text naming the object.
Array of SvStatus objects
No Additional ItemsState variable for status.
No Additional PropertiesThe in service status as a result of topology processing. It indicates if the equipment is considered as energized by the power flow. It reflects if the equipment is connected within a solvable island. It does not necessarily reflect whether or not the island was solved by the power flow.
The individual phase status. If the attribute is unspecified, then three phase model is assumed.
Used in RAVENS Schema to identify the corresponding CIM Object Type of the JSON object.
Used in RAVENS Schema to identify the corresponding CIM Object Type of the JSON object.
The attribute tells if the switch is considered open when used as input to topology processing.
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.
The transition time from open to close.
nan
nan
Time, in seconds
nan
nan
nan
nan
nan
nan
nan
nan
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.
The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection.
The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.
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.
The length to the place where the cut is located starting from side one of the cut line segment, i.e. the line segment Terminal with sequenceNumber equal to 1.
nan
nan
nan
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.
Specifies the availability of the equipment. 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.
The maximum continuous current carrying capacity in amps governed by the device material and construction.
The attribute shall be a positive value.
nan
nan
nan
Branch is retained in the topological solution. The flow through retained switches will normally be calculated in power flow.
The switch on count since the switch was last reset or initialized.
The date and time when the switch was last switched on.
The maximum fault current a breaking device can break safely under prescribed conditions of use.
nan
nan
nan
If true, the switch is locked. The resulting switch state is a combination of locked and Switch.open attributes as follows:
<ul>
<li>locked=true and Switch.open=true. The resulting state is open and locked;</li>
<li>locked=false and Switch.open=true. The resulting state is open;</li>
<li>locked=false and Switch.open=false. The resulting state is closed.</li>
</ul>
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.
The 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.
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.
The name is any free human readable and possibly non unique text naming the object.