id: https://modellen.netbeheernederland.nl/netbewust-laden/upcoming
name: netbewust-laden
description: |-
  Information model for the "Netbewust Laden" data product.
title: Netbewust Laden
license: https://www.apache.org/licenses/LICENSE-2.0.txt
imports:
  - linkml:types
prefixes:
  linkml: https://w3id.org/linkml/
  cim: https://cim.ucaiug.io/ns#
  dcterms: http://purl.org/dc/terms/
  eu: https://cim.ucaiug.io/ns/eu#
  nl: https://cim.ucaiug.io/ns/nl#
  unit: http://qudt.org/vocab/unit/
annotations:
  model_uri: https://modellen.netbeheernederland.nl/netbewust-laden
  exchange_format: application/ld+json
  model_type: data-product
  environment: https://ghcr.io/netbeheernederland/build-dp:0.41
enums:
  MeasurementKind:
    description: Types of measurement.
    enum_uri: nl:MeasurementKind
    permissible_values:
      gevraagdeTransportcapaciteit:
        meaning: nl:MeasurementKind.gevraagdeTransportcapaciteit
      benodigdeTransportcapaciteit:
        meaning: nl:MeasurementKind.benodigdeTransportcapaciteit
      piekbelasting:
        meaning: nl:MeasurementKind.piekbelasting
      geprognotiseerdeBelasting:
        meaning: nl:MeasurementKind.geprognotiseerdeBelasting
      historischeBelasting:
        meaning: nl:MeasurementKind.historischeBelasting
  UnitMultiplier:
    description: "The unit multipliers defined for the CIM.  When applied to unit symbols, the unit symbol is treated as a derived unit. Regardless of the contents of the unit symbol text, the unit symbol shall be treated as if it were a single-character unit symbol. Unit symbols should not contain multipliers, and it should be left to the multiplier to define the multiple for an entire data type. \r\n\r\nFor example, if a unit symbol is \"m2Pers\" and the multiplier is \"k\", then the value is k(m**2/s), and the multiplier applies to the entire final value, not to any individual part of the value. This can be conceptualized by substituting a derived unit symbol for the unit type. If one imagines that the symbol \"Þ\" represents the derived unit \"m2Pers\", then applying the multiplier \"k\" can be conceptualized simply as \"kÞ\".\r\n\r\nFor example, the SI unit for mass is \"kg\" and not \"g\".  If the unit symbol is defined as \"kg\", then the multiplier is applied to \"kg\" as a whole and does not replace the \"k\" in front of the \"g\". In this case, the multiplier of \"m\" would be used with the unit symbol of \"kg\" to represent one gram.  As a text string, this violates the instructions in IEC 80000-1. However, because the unit symbol in CIM is treated as a derived unit instead of as an SI unit, it makes more sense to conceptualize the \"kg\" as if it were replaced by one of the proposed replacements for the SI mass symbol. If one imagines that the \"kg\" were replaced by a symbol \"Þ\", then it is easier to conceptualize the multiplier \"m\" as creating the proper unit \"mÞ\", and not the forbidden unit \"mkg\"."
    from_schema: https://modellen.netbeheernederland.nl/nbnl-equipment
    enum_uri: cim:UnitMultiplier
    permissible_values:
      G:
        meaning: cim:UnitMultiplier.G
      h:
        meaning: cim:UnitMultiplier.h
      k:
        meaning: cim:UnitMultiplier.k
      m:
        meaning: cim:UnitMultiplier.m
      M:
        meaning: cim:UnitMultiplier.M
      micro:
        meaning: cim:UnitMultiplier.micro
      none:
        meaning: cim:UnitMultiplier.none
  UnitSymbol:
    description: "The derived units defined for usage in the CIM. In some cases, the derived unit is equal to an SI unit. Whenever possible, the standard derived symbol is used instead of the formula for the derived unit. For example, the unit symbol Farad is defined as \"F\" instead of \"CPerV\". In cases where a standard symbol does not exist for a derived unit, the formula for the unit is used as the unit symbol. For example, density does not have a standard symbol and so it is represented as \"kgPerm3\". With the exception of the \"kg\", which is an SI unit, the unit symbols do not contain multipliers and therefore represent the base derived unit to which a multiplier can be applied as a whole. \r\nEvery unit symbol is treated as an unparseable text as if it were a single-letter symbol. The meaning of each unit symbol is defined by the accompanying descriptive text and not by the text contents of the unit symbol.\r\nTo allow the widest possible range of serializations without requiring special character handling, several substitutions are made which deviate from the format described in IEC 80000-1. The division symbol \"/\" is replaced by the letters \"Per\". Exponents are written in plain text after the unit as \"m3\" instead of being formatted as \"m\" with a superscript of 3  or introducing a symbol as in \"m^3\". The degree symbol \"°\" is replaced with the letters \"deg\". Any clarification of the meaning for a substitution is included in the description for the unit symbol.\r\nNon-SI units are included in list of unit symbols to allow sources of data to be correctly labelled with their non-SI units (for example, a GPS sensor that is reporting numbers that represent feet instead of meters). This allows software to use the unit symbol information correctly convert and scale the raw data of those sources into SI-based units. \r\nThe integer values are used for harmonization with IEC 61850."
    from_schema: https://modellen.netbeheernederland.nl/nbnl-equipment
    enum_uri: cim:UnitSymbol
    permissible_values:
      A:
        meaning: cim:UnitSymbol.A
      Ah:
        meaning: cim:UnitSymbol.Ah
      none:
        meaning: cim:UnitSymbol.none
      ohm:
        meaning: cim:UnitSymbol.ohm
      V:
        meaning: cim:UnitSymbol.V
      VA:
        meaning: cim:UnitSymbol.VA
      VAh:
        meaning: cim:UnitSymbol.VAh
      VAr:
        meaning: cim:UnitSymbol.VAr
      VArh:
        meaning: cim:UnitSymbol.VArh
      W:
        meaning: cim:UnitSymbol.W
      Wb:
        meaning: cim:UnitSymbol.Wb
      Wh:
        meaning: cim:UnitSymbol.Wh
classes:
  GeographicalRegion:
    description: "A geographical region of a power system network model.\r\n"
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Core
    is_a: IdentifiedObject
    class_uri: cim:GeographicalRegion
    tree_root: true
  SubGeographicalRegion:
    description: "A subset of a geographical region of a power system network model.\r\n"
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Core
    is_a: IdentifiedObject
    attributes:
      Region:
        description: The geographical region which this sub-geographical region is within.
        slot_uri: cim:SubGeographicalRegion.Region
        range: GeographicalRegion
        required: true
        multivalued: false
      title:
        slot_uri: dcterms:title
        required: false
        multivalued: false
    class_uri: cim:SubGeographicalRegion
  PowerTransformer:
    description: "An electrical device consisting of  two or more coupled windings, with or without a magnetic core, for introducing mutual coupling between electric circuits. Transformers can be used to control voltage and phase shift (active power flow).\r\nA power transformer may be composed of separate transformer tanks that need not be identical.\r\nA power transformer can be modelled with or without tanks and is intended for use in both balanced and unbalanced representations.   A power transformer typically has two terminals, but may have one (grounding), three or more terminals.\r\nThe inherited association ConductingEquipment.BaseVoltage should not be used.  The association from TransformerEnd to BaseVoltage should be used instead."
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Wires
    is_a: ConductingEquipment
    class_uri: cim:PowerTransformer
  ConductingEquipment:
    description: The parts of the AC power system that are designed to carry current or that are conductively connected through terminals.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Core
    is_a: Equipment
    abstract: true
    attributes:
      BaseVoltage:
        description: Base voltage of this conducting equipment. Use only when there is no voltage level container used and only one base voltage applies.
        slot_uri: cim:ConductingEquipment.BaseVoltage
        range: BaseVoltage
        required: false
        multivalued: false
    class_uri: cim:ConductingEquipment
  BaseVoltage:
    description: 'Defines a system base voltage which is referenced. '
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Core
    is_a: IdentifiedObject
    class_uri: cim:BaseVoltage
  Equipment:
    description: The parts of a power system that are physical devices, electronic or mechanical.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Core
    is_a: PowerSystemResource
    abstract: true
    attributes:
      EquipmentContainer:
        description: Container of this equipment.
        slot_uri: cim:Equipment.EquipmentContainer
        required: false
        multivalued: false
        any_of:
          - range: Substation
          - range: VoltageLevel
      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.  \r\nThe attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection."
        slot_uri: cim:Equipment.aggregate
        range: boolean
        required: false
        multivalued: false
    class_uri: cim:Equipment
  PowerSystemResource:
    description: A power system resource (PSR) can be an item of equipment such as a switch, an equipment container containing many individual items of equipment such as a substation, or an organisational entity such as sub-control area. Power system resources can have measurements associated.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Core
    is_a: IdentifiedObject
    abstract: true
    class_uri: cim:PowerSystemResource
  IdentifiedObject:
    description: This is a root class to provide common identification for all classes needing identification and naming attributes.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Core
    abstract: true
    attributes:
      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.
        slot_uri: cim:IdentifiedObject.description
        range: string
        required: false
        multivalued: false
      mRID:
        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."
        slot_uri: cim:IdentifiedObject.mRID
        identifier: true
        range: string
        required: true
        multivalued: false
      europeanArticleNumberEAN:
        description: The attribute is used for an exchange of the EAN code (European Article Number). The length of the string is 18 characters as defined by the EAN code.
        slot_uri: nl:IdentifiedObject.europeanArticleNumberEAN
        range: string
        required: false
        multivalued: false
      name:
        description: "The name is any free human readable and possibly non unique text naming the object.\r\n"
        slot_uri: cim:IdentifiedObject.name
        range: string
        required: false
        multivalued: false
    class_uri: cim:IdentifiedObject
  Substation:
    description: "A collection of equipment for purposes other than generation or utilization, through which electric energy in bulk is passed for the purposes of switching or modifying its characteristics. \r\n"
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Core
    is_a: EquipmentContainer
    attributes:
      Region:
        description: The SubGeographicalRegion containing the substation.
        slot_uri: cim:Substation.Region
        range: SubGeographicalRegion
        required: true
        multivalued: false
    class_uri: cim:Substation
  EquipmentContainer:
    description: 'A modelling construct to provide a root class for containing equipment. '
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Core
    is_a: ConnectivityNodeContainer
    abstract: true
    class_uri: cim:EquipmentContainer
  ConnectivityNodeContainer:
    description: "A base class for all objects that may contain connectivity nodes or topological nodes.\r\n"
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Core
    is_a: PowerSystemResource
    abstract: true
    class_uri: cim:ConnectivityNodeContainer
  EnergyConsumer:
    description: Generic user of energy - a  point of consumption on the power system model.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Wires
    is_a: EnergyConnection
    class_uri: cim:EnergyConsumer
  EnergyConnection:
    description: A connection of energy generation or consumption on the power system model.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Wires
    is_a: ConductingEquipment
    abstract: true
    class_uri: cim:EnergyConnection
  ActivePowerLimit:
    description: Limit on active power flow.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.OperationalLimits
    is_a: OperationalLimit
    attributes:
      value:
        description: Value of active power limit. The attribute shall be a positive value or zero.
        slot_uri: cim:ActivePowerLimit.value
        range: ActivePower
        required: true
        multivalued: false
    class_uri: cim:ActivePowerLimit
  ActivePower:
    annotations:
      represents_cim_data_type:
        tag: represents_cim_data_type
        value: true
    description: Product of RMS value of the voltage and the RMS value of the in-phase component of the current.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Domain
    attributes:
      multiplier:
        slot_uri: cim:ActivePower.multiplier
        range: UnitMultiplier
        required: true
        multivalued: false
      unit:
        slot_uri: cim:ActivePower.unit
        range: UnitSymbol
        required: true
        multivalued: false
      value:
        slot_uri: cim:ActivePower.value
        range: float
        required: true
        multivalued: false
    class_uri: cim:ActivePower
  OperationalLimit:
    description: "A value and normal value associated with a specific kind of limit. \r\nThe sub class value and normalValue attributes vary inversely to the associated OperationalLimitType.acceptableDuration (acceptableDuration for short).  \r\nIf a particular piece of equipment has multiple operational limits of the same kind (apparent power, current, etc.), the limit with the greatest acceptableDuration shall have the smallest limit value and the limit with the smallest acceptableDuration shall have the largest limit value.  Note: A large current can only be allowed to flow through a piece of equipment for a short duration without causing damage, but a lesser current can be allowed to flow for a longer duration. "
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.OperationalLimits
    is_a: IdentifiedObject
    abstract: true
    attributes:
      OperationalLimitSet:
        description: The limit set to which the limit values belong.
        slot_uri: cim:OperationalLimit.OperationalLimitSet
        range: OperationalLimitSet
        required: false
        multivalued: false
      positiveFlowIn:
        description: If true then this OperationalLimit follows the convention that a positive value measured at the Terminal means power is flowing into the related PowerSystemResource.
        slot_uri: nl:OperationalLimit.positiveFlowIn
        range: boolean
        required: false
        multivalued: false
      LimitDependencyModel:
        description: The limit dependency models which are used to calculate this limit. If no limit dependencies are specified then the native limit value is used.
        slot_uri: cim:OperationalLimit.LimitDependencyModel
        range: SeriesEquipmentDependentLimit
        required: false
        multivalued: true
    class_uri: cim:OperationalLimit
  OperationalLimitSet:
    description: "A set of limits associated with equipment.  Sets of limits might apply to a specific temperature, or season for example. A set of limits may contain different severities of limit levels that would apply to the same equipment. The set may contain limits of different types such as apparent power and current limits or high and low voltage limits  that are logically applied together as a set.\r\n"
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.OperationalLimits
    is_a: IdentifiedObject
    attributes:
      Equipment:
        description: The equipment to which the limit set applies.
        slot_uri: cim:OperationalLimitSet.Equipment
        required: false
        multivalued: false
        any_of:
          - range: PowerTransformer
      Terminal:
        description: The terminal where the operational limit set apply.
        slot_uri: cim:OperationalLimitSet.Terminal
        range: Terminal
        required: false
        multivalued: false
    class_uri: cim:OperationalLimitSet
  LimitDependency:
    description: A limit calculation model used to compute an operational limit based on external input such as temperature. These are intended to be shared among operational limits with the same calculation form that apply to a piece of equipment..
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.InfIEC61970.InfOperationalLimits
    is_a: IdentifiedObject
    class_uri: cim:LimitDependency
  EquipmentLimitSeriesComponent:
    description: This represents one instance of an equipment that contributes to the calculation of an operational limit.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.InfIEC61970.InfOperationalLimits
    is_a: IdentifiedObject
    attributes:
      SeriesEquipmentDependentLimit:
        description: Calculation in which the refernce to equipment applies.
        slot_uri: cim:EquipmentLimitSeriesComponent.SeriesEquipmentDependentLimit
        range: SeriesEquipmentDependentLimit
        required: true
        multivalued: false
      Equipment:
        description: Equipment contributing toward the series limit.   The reference here is to Equipment rather than a specific limit on the equipment so the grouiping can be reused for multiple limits of different types on the same instance of equipment.
        slot_uri: cim:EquipmentLimitSeriesComponent.Equipment
        any_of:
          - range: PowerTransformer
        required: true
        multivalued: false
      Terminal:
        description: The terminal where the operational limit set apply.
        slot_uri: nl:EquipmentLimitSeriesComponent.Terminal
        range: Terminal
        required: false
        multivalued: false
    class_uri: cim:EquipmentLimitSeriesComponent
  SeriesEquipmentDependentLimit:
    description: "Limit based on most restrictive equipment limit.\r\nA specification of equipment that determines the calculated operational limit values based upon other equipment and their ratings. The most restrictive limit connected within the group is used. The physical connection based on switch status for example may also impact which elements in the group are considered. Any equipment in the group that are presently connected with the equipment of the directly associated operational limit are used. This provides a means to indicate which potentially equipment limits are considered for a computed operational limit. The operational limit of the same operational limit type is assumed to be used from the grouped equipment. It is also possible to make assumptions or calculations regarding how flow might split if the equipment is not simply in series."
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.InfIEC61970.InfOperationalLimits
    is_a: LimitDependency
    class_uri: cim:SeriesEquipmentDependentLimit
  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.IEC61970.Base.Core
    is_a: EquipmentContainer
    attributes:
      BaseVoltage:
        description: The base voltage used for all equipment within the voltage level.
        slot_uri: cim:VoltageLevel.BaseVoltage
        range: BaseVoltage
        required: true
        multivalued: false
      Substation:
        description: The substation of the voltage level.
        slot_uri: cim:VoltageLevel.Substation
        range: Substation
        required: true
        multivalued: false
    class_uri: cim:VoltageLevel
  PowerTransformerEnd:
    description: "A PowerTransformerEnd is associated with each Terminal of a PowerTransformer.\r\nThe impedance values r, r0, x, and x0 of a PowerTransformerEnd represents a star equivalent as follows.\r\n1) for a two Terminal PowerTransformer the high voltage (TransformerEnd.endNumber=1) PowerTransformerEnd has non zero values on r, r0, x, and x0 while the low voltage (TransformerEnd.endNumber=2) PowerTransformerEnd has zero values for r, r0, x, and x0.  Parameters are always provided, even if the PowerTransformerEnds have the same rated voltage.  In this case, the parameters are provided at the PowerTransformerEnd which has TransformerEnd.endNumber equal to 1.\r\n2) for a three Terminal PowerTransformer the three PowerTransformerEnds represent a star equivalent with each leg in the star represented by r, r0, x, and x0 values.\r\n3) For a three Terminal transformer each PowerTransformerEnd shall have g, g0, b and b0 values corresponding to the no load losses distributed on the three PowerTransformerEnds. The total no load loss shunt impedances may also be placed at one of the PowerTransformerEnds, preferably the end numbered 1, having the shunt values on end 1.  This is the preferred way.\r\n4) for a PowerTransformer with more than three Terminals the PowerTransformerEnd impedance values cannot be used. Instead use the TransformerMeshImpedance or split the transformer into multiple PowerTransformers.\r\nEach PowerTransformerEnd must be contained by a PowerTransformer. Because a PowerTransformerEnd (or any other object) can not be contained by more than one parent, a PowerTransformerEnd can not have an association to an EquipmentContainer (Substation, VoltageLevel, etc)."
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Wires
    is_a: TransformerEnd
    attributes:
      PowerTransformer:
        description: The power transformer of this power transformer end.
        slot_uri: cim:PowerTransformerEnd.PowerTransformer
        range: PowerTransformer
        required: true
        multivalued: false
    class_uri: cim:PowerTransformerEnd
  TransformerEnd:
    description: A conducting connection point of a power transformer. It corresponds to a physical transformer winding terminal.  In earlier CIM versions, the TransformerWinding class served a similar purpose, but this class is more flexible because it associates to terminal but is not a specialization of ConductingEquipment.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Wires
    is_a: IdentifiedObject
    abstract: true
    attributes:
      endNumber:
        description: "Number for this transformer end, corresponding to the end's order in the power transformer vector group or phase angle clock number.  Highest voltage winding should be 1.  Each end within a power transformer should have a unique subsequent end number.   Note the transformer end number need not match the terminal sequence number.\r\n"
        slot_uri: cim:TransformerEnd.endNumber
        range: integer
        required: false
        multivalued: false
      Terminal:
        description: Terminal of the power transformer to which this transformer end belongs.
        slot_uri: cim:TransformerEnd.Terminal
        range: Terminal
        required: true
        multivalued: false
    class_uri: cim:TransformerEnd
  Terminal:
    description: An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Core
    is_a: ACDCTerminal
    attributes:
      ConnectivityNode:
        description: The connectivity node to which this terminal connects with zero impedance.
        slot_uri: cim:Terminal.ConnectivityNode
        range: ConnectivityNode
        required: false
        multivalued: false
      ConductingEquipment:
        description: The conducting equipment of the terminal. Conducting equipment have  terminals that may be connected to other conducting equipment terminals via connectivity nodes or topological nodes.
        slot_uri: cim:Terminal.ConductingEquipment
        required: true
        multivalued: false
        any_of:
          - range: PowerTransformer
          - range: EnergyConsumer
    class_uri: cim:Terminal
  ConnectivityNode:
    description: Connectivity nodes are points where terminals of AC conducting equipment are connected together with zero impedance.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Core
    is_a: IdentifiedObject
    attributes:
      ConnectivityNodeContainer:
        description: Container of this connectivity node.
        slot_uri: cim:ConnectivityNode.ConnectivityNodeContainer
        required: true
        multivalued: false
        any_of:
          - range: VoltageLevel
    class_uri: cim:ConnectivityNode
  ACDCTerminal:
    description: An electrical connection point (AC or DC) to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Core
    is_a: IdentifiedObject
    abstract: true
    class_uri: cim:ACDCTerminal
  TopologicalNode:
    description: For a detailed substation model a topological node is a set of connectivity nodes that, in the current network state, are connected together through any type of closed switches, including  jumpers. Topological nodes change as the current network state changes (i.e., switches, breakers, etc. change state).  For a planning model, switch statuses are not used to form topological nodes.  Instead they are manually created or deleted in a model builder tool. Topological nodes maintained this way are also called _busses_.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Topology
    is_a: IdentifiedObject
    attributes:
      Terminal:
        description: The terminals associated with the topological node. This can be used as an alternative to the connectivity node path to terminal, thus making it unnecessary to model connectivity nodes in some cases. Note that if connectivity nodes are in the model, this association would probably not be used as an input specification.
        slot_uri: cim:TopologicalNode.Terminal
        range: Terminal
        required: true
        multivalued: true
    class_uri: cim:TopologicalNode
  BusNameMarker:
    description: 'Used to apply user standard names to TopologicalNodes. Associated with one or more terminals that are normally connected with the bus name.    The associated terminals are normally connected by non-retained switches. For a ring bus station configuration, all BusbarSection terminals in the ring are typically associated.   For a breaker and a half scheme, both BusbarSections would normally be associated.  For a ring bus, all BusbarSections would normally be associated.  For a "straight" busbar configuration, normally only the main terminal at the BusbarSection would be associated.  '
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Topology
    is_a: IdentifiedObject
    attributes:
      Terminal:
        description: The terminals associated with this bus name marker.
        slot_uri: cim:BusNameMarker.Terminal
        range: Terminal
        required: true
        multivalued: true
      TopologicalNode:
        description: A user defined topological node that was originally defined in a planning model not yet having topology described by ConnectivityNodes. Once ConnectivityNodes has been created they may linked to user defined ToplogicalNdes using BusNameMarkers.
        slot_uri: cim:BusNameMarker.TopologicalNode
        range: TopologicalNode
        required: false
        multivalued: false
    class_uri: cim:BusNameMarker
  CoordinateSystem:
    class_uri: cim:CoordinateSystem
    is_a: IdentifiedObject
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61968.Common
    description: "Coordinate reference system.\r\n"
    attributes:
      crsUrn:
        slot_uri: cim:CoordinateSystem.crsUrn
        range: string
        required: false
        multivalued: false
        description: "A Uniform Resource Name (URN) for the coordinate reference system (crs) used to define 'Location.PositionPoints'.\r\nAn example would be the European Petroleum Survey Group (EPSG) code for a coordinate reference system, defined in URN under the Open Geospatial Consortium (OGC) namespace as: urn:ogc:def:crs:EPSG::XXXX, where XXXX is an EPSG code (a full list of codes can be found at the EPSG Registry web site http://www.epsg-registry.org/). To define the coordinate system as being WGS84 (latitude, longitude) using an EPSG OGC, this attribute would be urn:ogc:def:crs:EPSG::4.3.2.6\r\nA profile should limit this code to a set of allowed URNs agreed to by all sending and receiving parties."
  Location:
    description: "The place, scene, or point of something where someone or something has been, is, and/or will be at a given moment in time. It can be defined with one or more position points (coordinates) in a given coordinate system.\r\n"
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61968.Common
    is_a: IdentifiedObject
    attributes:
      mainAddress:
        description: Main address of the location.
        slot_uri: cim:Location.mainAddress
        range: StreetAddress
        required: false
        multivalued: false
      PowerSystemResources:
        description: All power system resources at this location.
        slot_uri: cim:Location.PowerSystemResources
        any_of:
          - range: EnergyConsumer
          - range: substation
        required: true
        multivalued: true
      CoordinateSystem:
        slot_uri: cim:Location.CoordinateSystem
        range: CoordinateSystem
        required: false
        multivalued: false
        description: Coordinate system used to describe position points of this location.
    class_uri: cim:Location
  PositionPoint:
    class_uri: cim:PositionPoint
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61968.Common
    description: Set of spatial coordinates that determine a point, defined in the coordinate system specified in 'Location.CoordinateSystem'. Use a single position point instance to describe a point-oriented location. Use a sequence of position points to describe a line-oriented object (physical location of non-point oriented objects like cables or lines), or area of an object (like a substation or a geographical zone - in this case, have first and last position point with the same values).
    attributes:
      groupNumber:
        slot_uri: cim:PositionPoint.groupNumber
        range: integer
        required: false
        multivalued: false
        description: Zero-relative sequence number of this group within a series of points; used when there is a need to express disjoint groups of points that are considered to be part of a single location.
      sequenceNumber:
        slot_uri: cim:PositionPoint.sequenceNumber
        range: integer
        required: false
        multivalued: false
        description: Zero-relative sequence number of this point within a series of points.
      xPosition:
        slot_uri: cim:PositionPoint.xPosition
        range: string
        required: true
        multivalued: false
        description: X axis position.
      yPosition:
        slot_uri: cim:PositionPoint.yPosition
        range: string
        required: true
        multivalued: false
        description: Y axis position.
      zPosition:
        slot_uri: cim:PositionPoint.zPosition
        range: string
        required: false
        multivalued: false
        description: (if applicable) Z axis position.
      Location:
        slot_uri: cim:PositionPoint.Location
        range: Location
        required: true
        multivalued: false
        description: Location described by this position point.
  StreetAddress:
    description: General purpose street and postal address information.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61968.Common
    attributes:
      postalCode:
        description: Postal code for the address.
        slot_uri: cim:StreetAddress.postalCode
        range: string
        required: true
        multivalued: false
      streetDetail:
        description: Street detail.
        slot_uri: cim:StreetAddress.streetDetail
        range: StreetDetail
        required: false
        multivalued: false
    class_uri: cim:StreetAddress
  StreetDetail:
    description: "Street details, in the context of address.\r\n"
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61968.Common
    attributes:
      number:
        description: Designator of the specific location on the street.
        slot_uri: cim:StreetDetail.number
        range: string
        required: true
        multivalued: false
    class_uri: cim:StreetDetail
  Measurement:
    description: |-
      A Measurement represents any measured, calculated or non-measured
      non-calculated quantity. Any piece of equipment may contain Measurements,
      e.g. a substation may have temperature measurements and door open
      indications, a transformer may have oil temperature and tank pressure
      measurements, a bay may contain a number of power flow measurements and a
      Breaker may contain a switch status measurement.

      The PSR - Measurement association is intended to capture this use of
      Measurement and is included in the naming hierarchy based on
      EquipmentContainer. The naming hierarchy typically has Measurements as
      leaves, e.g. Substation-VoltageLevel-Bay-Switch-Measurement.

      Some Measurements represent quantities related to a particular sensor
      location in the network, e.g. a voltage transformer (VT) or potential
      transformer (PT) at a busbar or a current transformer (CT) at the bar
      between a breaker and an isolator.  The sensing position is not captured
      in the PSR - Measurement association.  Instead it is captured by the
      Measurement - Terminal association that is used to define the sensing
      location in the network topology. The location is defined by the
      connection of the Terminal to ConductingEquipment.

      If both a Terminal and PSR are associated, and the PSR is of type
      ConductingEquipment, the associated Terminal should belong to that
      ConductingEquipment instance.

      When the sensor location is needed both Measurement-PSR and
      Measurement-Terminal are used. The Measurement-Terminal association is
      never used alone.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Meas
    is_a: IdentifiedObject
    attributes:
      measurementType:
        slot_uri: cim:Measurement.measurementType
        range: MeasurementKind
        required: false
        multivalued: false
        description: "Specifies the type of measurement.  For example, this specifies if the measurement represents an indoor temperature, outdoor temperature, bus voltage, line flow, etc.\r\nWhen the measurementType is set to \"Specialization\", the type of Measurement is defined in more detail by the specialized class which inherits from Measurement.\r\n\r\n"
      unitMultiplier:
        description: The unit multiplier of the measured quantity.
        slot_uri: cim:Measurement.unitMultiplier
        range: UnitMultiplier
        required: true
        multivalued: false
      unitSymbol:
        description: The unit of measure of the measured quantity.
        slot_uri: cim:Measurement.unitSymbol
        range: UnitSymbol
        required: true
        multivalued: false
      Terminal:
        description: One or more measurements may be associated with a terminal in the network.
        slot_uri: cim:Measurement.Terminal
        range: Terminal
        required: false
        multivalued: false
      PowerSystemResource:
        description: The power system resource that contains the measurement.
        slot_uri: cim:Measurement.PowerSystemResource
        range: PowerTransformer
        required: false
        multivalued: false
      SeriesEquipmentDependentLimit:
        slot_uri: nl:Measurement.SeriesEquipmentDependentLimit
        range: SeriesEquipmentDependentLimit
        required: false
        multivalued: false
        description: Measurement which applies to all contained Equipment-s.
    class_uri: cim:Measurement
  Analog:
    description: "Analog represents an analog Measurement.\r\n"
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Meas
    is_a: Measurement
    attributes:
      positiveFlowIn:
        description: If true then this measurement is an active power, reactive power or current with the convention that a positive value measured at the Terminal means power is flowing into the related PowerSystemResource.
        slot_uri: cim:Analog.positiveFlowIn
        range: boolean
        required: false
        multivalued: false
    class_uri: cim:Analog
  AnalogValue:
    description: AnalogValue represents an analog MeasurementValue.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Meas
    is_a: MeasurementValue
    attributes:
      value:
        description: The value to supervise.
        slot_uri: cim:AnalogValue.value
        range: float
        required: false
        multivalued: false
      Analog:
        description: Measurement to which this value is connected.
        slot_uri: cim:AnalogValue.Analog
        range: Analog
        required: true
        multivalued: false
    class_uri: cim:AnalogValue
  MeasurementValue:
    description: "The current state for a measurement. A state value is an instance of a measurement from a specific source. Measurements can be associated with many state values, each representing a different source for the measurement.\r\n"
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Meas
    is_a: IOPoint
    attributes:
      timeStamp:
        description: The time when the value was last updated.
        slot_uri: cim:MeasurementValue.timeStamp
        range: datetime
        required: false
        multivalued: false
    class_uri: cim:MeasurementValue
  IOPoint:
    description: The class describe a measurement or control value. The purpose is to enable having attributes and associations common for measurement and control.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Meas
    is_a: IdentifiedObject
    class_uri: cim:IOPoint
  UsagePoint:
    description: Logical or physical point in the network to which readings or events may be attributed. Used at the place where a physical or virtual meter may be located; however, it is not required that a meter be present.
    is_a: IdentifiedObject
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61968.Metering
    attributes:
      Equipments:
        slot_uri: cim:UsagePoint.Equipments
        range: EnergyConsumer
        required: false
        multivalued: true
        description: All equipment connecting this usage point to the electrical grid.
    class_uri: cim:UsagePoint
version: upcoming
generation_date: "2026-11-13"
