id: https://modellen.netbeheernederland.nl/nbnl-equipment/2.0
name: nbnl-equipment
description: |-
  Information model for the data product "NBNL Equipment"
title: NBNL Equipment
license: https://www.apache.org/licenses/LICENSE-2.0.txt
imports:
  - linkml:types
prefixes:
  cbs: https://www.cbs.nl/nl-nl/onze-diensten/methoden/begrippen/
  cim: https://cim.ucaiug.io/ns#
  ck: http://data.netbeheernederland.nl/capaciteitskaart/def#
  dcterms: http://purl.org/dc/terms/
  eu: https://cim.ucaiug.io/ns/eu#
  linkml: https://w3id.org/linkml/
  nbnl-term: https://begrippen.netbeheernederland.nl/id/
  nl: https://cim.ucaiug.io/ns/nl#
  unit: http://qudt.org/vocab/unit/
  vocab: http://modellen.netbeheernederland.nl/nbnl-equipment/
annotations:
  model_uri: https://modellen.netbeheernederland.nl/nbnl-equipment
  exchange_format: application/ld+json
  model_type: data-product
  environment: https://ghcr.io/netbeheer-nederland/build-dp:0.38
enums:
  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: http://data.netbeheernederland.nl/data-product/im-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: http://data.netbeheernederland.nl/data-product/im-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
  UpdateInfoKind:
    description: Type of information that has been updated as part of this dataset.
    enum_uri: nl:UpdateInfoKind
    permissible_values:
      KI:
        description: Kleurinformatie.
        meaning: nl:UpdateInfoKind.KI
      ATC:
        description: Aanwezige transportcapaciteit.
        meaning: nl:UpdateInfoKind.ATC
      BTC:
        description: Benodigde transportcapaciteit.
        meaning: nl:UpdateInfoKind.BTC
      WR:
        description: Wachtrij.
        meaning: nl:UpdateInfoKind.WR
      NU:
        description: Netuitbreidingen.
        meaning: nl:UpdateInfoKind.NU
      CO:
        description: Congestie opgelost.
        meaning: nl:UpdateInfoKind.CO
classes:
  BaseVoltage:
    description: 'Defines a system base voltage which is referenced. '
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Core
    exact_mappings:
      - vocab:spanningsniveau
    is_a: IdentifiedObject
    attributes:
      nominalVoltage:
        description: The power system resource's base voltage. Shall be a positive value and not zero.
        slot_uri: cim:BaseVoltage.nominalVoltage
        range: Voltage
        required: true
        multivalued: false
    class_uri: cim:BaseVoltage
  Voltage:
    annotations:
      represents_cim_data_type:
        tag: represents_cim_data_type
        value: true
    description: Electrical voltage, can be both AC and DC.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Domain
    attributes:
      multiplier:
        slot_uri: cim:Voltage.multiplier
        range: UnitMultiplier
        required: true
        multivalued: false
      unit:
        slot_uri: cim:Voltage.unit
        range: UnitSymbol
        required: true
        multivalued: false
      value:
        slot_uri: cim:Voltage.value
        range: float
        required: true
        multivalued: false
    class_uri: cim:Voltage
  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
    exact_mappings:
      - nbnl-term:gtj7b
    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
  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
    narrow_mappings:
      - nbnl-term:n4sk8
    is_a: EquipmentContainer
    attributes:
      Region:
        description: The SubGeographicalRegion containing the substation.
        slot_uri: cim:Substation.Region
        range: SubGeographicalRegion
        required: true
        multivalued: false
    exact_mappings:
      - vocab:station
    class_uri: cim:Substation
  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
    narrow_mappings:
      - nbnl-term:w9pqm
    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
  GeographicalRegion:
    description: "A geographical region of a power system network model.\r\n"
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Core
    exact_mappings:
      - cbs:landsdeel
    is_a: IdentifiedObject
    class_uri: cim:GeographicalRegion
    tree_root: true
  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
        exact_mappings:
          - ck:EnergyArea.short_code
    class_uri: cim:IdentifiedObject
  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
    narrow_mappings:
      - nbnl-term:n4sk8
    is_a: IdentifiedObject
    attributes:
      ConnectivityNodeContainer:
        description: Container of this connectivity node.
        slot_uri: cim:ConnectivityNode.ConnectivityNodeContainer
        range: VoltageLevel
        required: true
        multivalued: false
      BoundaryPoint:
        description: The boundary point associated with the connectivity node.
        slot_uri: eu:ConnectivityNode.BoundaryPoint
        range: BoundaryPoint
        required: false
        multivalued: false
    class_uri: cim:ConnectivityNode
  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
  BoundaryPoint:
    description: Designates a connection point at which one or more model authority sets shall connect to. The location of the connection point as well as other properties are agreed between organisations responsible for the interconnection, hence all attributes of the class represent this agreement.  It is primarily used in a boundary model authority set which can contain one or many BoundaryPoint-s among other Equipment-s and their connections.
    exact_mappings:
      - nbnl-term:fqqa7
    is_a: PowerSystemResource
    attributes:
      fromEndIsoCode:
        description: 'The ISO code of the region which the "From" side of the Boundary point belongs to or it is connected to.

          The ISO code is a two-character country code as defined by ISO 3166 (http://www.iso.org/iso/country_codes). The length of the string is 2 characters maximum.'
        slot_uri: eu:BoundaryPoint.fromEndIsoCode
        range: string
        required: true
        multivalued: false
      fromEndNameTso:
        description: Identifies the name of the transmission system operator, distribution system operator or other entity at which the "From" side of the interconnection is connected to. The length of the string is 64 characters maximum.
        slot_uri: eu:BoundaryPoint.fromEndNameTso
        range: string
        required: true
        multivalued: false
      toEndIsoCode:
        description: 'The ISO code of the region which the "To" side of the Boundary point belongs to or is connected to.

          The ISO code is a two-character country code as defined by ISO 3166 (http://www.iso.org/iso/country_codes). The length of the string is 2 characters maximum.'
        slot_uri: eu:BoundaryPoint.toEndIsoCode
        range: string
        required: true
        multivalued: false
      toEndNameTso:
        description: Identifies the name of the transmission system operator, distribution system operator or other entity at which the "To" side of the interconnection is connected to. The length of the string is 64 characters maximum.
        slot_uri: eu:BoundaryPoint.toEndNameTso
        range: string
        required: true
        multivalued: false
    class_uri: eu:BoundaryPoint
  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
    attributes:
      ReportingGroup:
        slot_uri: cim:PowerSystemResource.ReportingGroup
        range: ReportingGroup
        required: false
        multivalued: true
        description: Reporting groups to which this power system resource belongs.
    abstract: true
    class_uri: cim:PowerSystemResource
  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
  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
    exact_mappings:
      - vocab:transformator
    class_uri: cim:PowerTransformer
  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
    exact_mappings:
      - nbnl-term:8eytm
    class_uri: cim:PowerTransformerEnd
  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
    class_uri: cim:ConductingEquipment
  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:
        slot_uri: cim:Terminal.ConductingEquipment
        any_of:
          - range: PowerTransformer
          - range: EnergyConsumer
        required: true
        multivalued: false
        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.
    class_uri: cim:Terminal
  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
    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
    abstract: true
    class_uri: cim:TransformerEnd
  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
    exact_mappings:
      - vocab:aangeslotene
    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
  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
    attributes:
      EquipmentContainer:
        description: Container of this equipment.
        slot_uri: cim:Equipment.EquipmentContainer
        any_of:
          - range: EquipmentContainer
          - range: Substation
        required: false
        multivalued: false
    abstract: true
    class_uri: cim:Equipment
  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
  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
    exact_mappings:
      - nbnl-term:2whwi
      - vocab:stationslimiet
    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
    attributes:
      OperationalLimitSet:
        description: The limit set to which the limit values belong.
        slot_uri: cim:OperationalLimit.OperationalLimitSet
        range: OperationalLimitSet
        required: true
        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
    abstract: 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
        range: PowerTransformer
        required: false
        multivalued: false
      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
  Contingency:
    description: An event threatening system reliability, consisting of one or more contingency elements.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Contingency
    is_a: IdentifiedObject
    attributes:
      mustStudy:
        description: Set true if must study this contingency.
        slot_uri: cim:Contingency.mustStudy
        range: boolean
        required: false
        multivalued: false
    exact_mappings:
      - vocab:knelpunt
    class_uri: cim:Contingency
  ContingencyElement:
    description: 'An element of a system event to be studied by contingency analysis, representing a change in status of a single piece of equipment. '
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Contingency
    is_a: IdentifiedObject
    attributes:
      Contingency:
        description: A contingency element belongs to one contingency.
        slot_uri: cim:ContingencyElement.Contingency
        range: Contingency
        required: true
        multivalued: false
    abstract: true
    class_uri: cim:ContingencyElement
  ContingencyEquipment:
    description: Equipment whose in service status is to change, such as a power transformer or AC line segment.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Contingency
    is_a: ContingencyElement
    attributes:
      Equipment:
        description: The single piece of equipment to which to apply the contingency.
        slot_uri: cim:ContingencyEquipment.Equipment
        range: PowerTransformer
        required: true
        multivalued: false
    class_uri: cim:ContingencyEquipment
  ReportingGroup:
    class_uri: cim:ReportingGroup
    is_a: IdentifiedObject
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Core
    description: A reporting group is used for various ad-hoc groupings used for reporting. The ReportingGroup is used to associate (among others) various cim:PowerSystemResource-s with a nl:Queue (OP).
    attributes:
      ReportingSuperGroup:
        slot_uri: cim:ReportingGroup.ReportingSuperGroup
        range: ReportingSuperGroup
        required: false
        multivalued: false
        description: Reporting super group to which this reporting group belongs.
  ReportingSuperGroup:
    class_uri: cim:ReportingSuperGroup
    is_a: IdentifiedObject
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Core
    description: A reporting super group, groups reporting groups for a higher level report.
  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:
      isVirtual:
        slot_uri: cim:UsagePoint.isVirtual
        range: boolean
        required: false
        multivalued: false
        description: If true, this usage point is virtual, i.e., no physical location exists in the network where a meter could be located to collect the meter readings. For example, one may define a virtual usage point to serve as an aggregation of usage for all of a company's premises distributed widely across the distribution territory. Otherwise, the usage point is physical, i.e., there is a logical point in the network where a meter could be located to collect meter readings.
      Equipments:
        slot_uri: cim:UsagePoint.Equipments
        range: EnergyConsumer
        required: false
        multivalued: true
        description: All equipment connecting this usage point to the electrical grid.
    exact_mappings:
      - nbnl-term:fqqa7
    class_uri: cim:UsagePoint
  UpdateInfo:
    description: Specific type of information that was updated for this dataset.
    attributes:
      date:
        description: Date of the update.
        slot_uri: nl:UpdateInfo.date
        range: date
        required: true
        multivalued: false
      type:
        description: Type of the update.
        slot_uri: nl:UpdateInfo.type
        range: UpdateInfoKind
        required: true
        multivalued: false
    class_uri: nl:UpdateInfo
version: "2.0"
generation_date: "2026-05-11"
