id: https://modellen.netbeheernederland.nl/netburen/upcoming
name: netburen
description: |-
  Information model for Netburen data product.
title: Netburen
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#
  dcat: http://www.w3.org/ns/dcat#
  dct: http://purl.org/dc/terms/
  github: https://github.com/
  liander: http://data.liander.nl/markt/def#
  nbnl: https://begrippen.netbeheernederland.nl/energiesysteembeheer/nl/page/
  nl: http://iec.ch/TC57/CIM100-Netherlands#
  owl: http://www.w3.org/2002/07/owl#
  skos: http://www.w3.org/2004/02/skos/core#
  this: http://data.netbeheernederland.nl/data-product/dp-netburen/def#
annotations:
  model_uri: https://modellen.netbeheernederland.nl/netburen
  exchange_format: application/json
  model_type: data-product
  environment: https://ghcr.io/netbeheer-nederland/build-dp:0.35
classes:
  TopologyDataSet:
    description: A single instance of a published dataset.
    attributes:
      identifier:
        slot_uri: dct:identifier
        required: true
        multivalued: false
      contact_point:
        slot_uri: dcat:contactPoint
        required: true
        multivalued: false
      conforms_to:
        slot_uri: dct:conformsTo
        required: true
        multivalued: false
      release_date:
        slot_uri: dct:issued
        range: date
        required: true
        multivalued: false
      version:
        slot_uri: owl:versionInfo
        required: true
        multivalued: false
      substations:
        slot_uri: this:TopologyDataSet.Substations
        range: Substation
        required: true
        multivalued: true
      lines:
        slot_uri: this:TopologyDataSet.Lines
        range: Line
        required: false
        multivalued: true
    class_uri: this:TopologyDataSet
    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
    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
      m_rid:
        description: "Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.\r\nFor CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements."
        slot_uri: cim:IdentifiedObject.mRID
        range: string
        required: false
        multivalued: false
      names:
        description: All names of this identified object.
        slot_uri: cim:IdentifiedObject.Names
        range: Name
        required: false
        multivalued: true
      short_name:
        description: The attribute is used for an exchange of a human readable short name with length of the string 12 characters maximum.
        slot_uri: cim:IdentifiedObject.shortName
        range: string
        required: false
        multivalued: false
    class_uri: cim:IdentifiedObject
  Name:
    description: "The Name class provides the means to define any number of human readable  names for an object. A name is <b>not</b> to be used for defining inter-object relationships. For inter-object relationships instead use the object identification 'mRID'.\r\n"
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Core
    attributes:
      name_type:
        description: Type of this name.
        slot_uri: cim:Name.NameType
        range: NameType
        required: true
        multivalued: false
    class_uri: cim:Name
  NameType:
    description: "Type of name. Possible values for attribute 'name' are implementation dependent but standard profiles may specify types. An enterprise may have multiple IT systems each having its own local name for the same object, e.g. a planning system may have different names from an EMS. An object may also have different names within the same IT system, e.g. localName as defined in CIM version 14. The definition from CIM14 is:\r\nThe localName is a human readable name of the object. It is a free text name local to a node in a naming hierarchy similar to a file directory structure. A power system related naming hierarchy may be: Substation, VoltageLevel, Equipment etc. Children of the same parent in such a hierarchy have names that typically are unique among them.\r\n"
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Core
    attributes:
      description:
        description: "Description of the name type.\r\n"
        slot_uri: cim:NameType.description
        range: string
        required: false
        multivalued: false
      name_type_authority:
        description: Authority responsible for managing names of this type.
        slot_uri: cim:NameType.NameTypeAuthority
        range: NameTypeAuthority
        required: false
        multivalued: false
    class_uri: cim:NameType
  NameTypeAuthority:
    description: "Authority responsible for creation and management of names of a given type; typically an organization or an enterprise system.\r\n"
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61970.Base.Core
    attributes:
      description:
        description: "Description of the name type authority.\r\n"
        slot_uri: cim:NameTypeAuthority.description
        range: string
        required: false
        multivalued: false
    class_uri: cim:NameTypeAuthority
  Line:
    description: Contains equipment beyond a substation belonging to a power transmission line.
    is_a: EquipmentContainer
    class_uri: cim:Line
  EquipmentContainer:
    description: A modelling construct to provide a root class for containing equipment.
    is_a: ConnectivityNodeContainer
    class_uri: cim:EquipmentContainer
  Equipment:
    description: The parts of a power system that are physical devices, electronic or mechanical.
    is_a: PowerSystemResource
    class_uri: cim:Equipment
  ConnectivityNodeContainer:
    description: A base class for all objects that may contain connectivity nodes or topological nodes.
    is_a: PowerSystemResource
    class_uri: cim:ConnectivityNodeContainer
  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.
    is_a: IdentifiedObject
    attributes:
      location:
        description: Location of this power system resource.
        slot_uri: cim:PowerSystemResource.Location
        range: Location
        required: false
        multivalued: false
    class_uri: cim:PowerSystemResource
  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.
    exact_mappings:
      - nbnl:station
    is_a: EquipmentContainer
    attributes:
      bays:
        description: Bays contained in the substation.
        slot_uri: cim:Substation.Bays
        range: Bay
        required: true
        multivalued: true
    class_uri: cim:Substation
  Bay:
    description: A collection of power system resources (within a given substation) including conducting equipment, protection relays, measurements, and telemetry.  A bay typically represents a physical grouping related to modularization of equipment.
    exact_mappings:
      - nbnl:veld
    is_a: EquipmentContainer
    attributes:
      energy_consumers:
        description: Source or consumer connected to the bay.
        slot_uri: this:Bay.EnergyConsumers
        range: EnergyConsumer
        required: true
        multivalued: true
    class_uri: cim:Bay
  EnergyConnection:
    description: A connection of energy generation or consumption on the power system model.
    is_a: ConductingEquipment
    attributes:
      market_evaluation_points:
        description: Market evaluation points associated with the  EnergyConnection.
        slot_uri: this:EnergyConnection.MarketEvaluationPoints
        range: MarketEvaluationPoint
        required: true
        multivalued: true
    class_uri: cim:EnergyConnection
  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
  ConductingEquipment:
    description: The parts of the AC power system that are designed to carry current or that are conductively connected through terminals.
    is_a: Equipment
    class_uri: cim:ConductingEquipment
  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.
    is_a: IdentifiedObject
    attributes:
      coordinate_system:
        description: Coordinate system used to describe position points of this location.
        slot_uri: cim:Location.CoordinateSystem
        range: CoordinateSystem
        required: false
        multivalued: false
      main_address:
        description: Main address of the location.
        slot_uri: cim:Location.mainAddress
        range: StreetAddress
        required: true
        multivalued: false
      position_points:
        description: Sequence of position points describing this location, expressed in coordinate system 'Location.CoordinateSystem'.
        slot_uri: cim:Location.PositionPoints
        range: PositionPoint
        required: false
        multivalued: true
    class_uri: cim:Location
  CoordinateSystem:
    description: Coordinate reference system.
    is_a: IdentifiedObject
    attributes:
      crs_urn:
        description: 'A Uniform Resource Name (URN) for the coordinate reference system (crs) used to define ''Location.PositionPoints''.

          An 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::4236.

          A profile should limit this code to a set of allowed URNs agreed to by all sending and receiving parties.'
        slot_uri: cim:CoordinateSystem.crsUrn
        range: string
        required: true
        multivalued: false
    class_uri: cim:CoordinateSystem
  StreetAddress:
    description: General purpose street and postal address information.
    attributes:
      postal_code:
        description: Postal code for the address.
        slot_uri: cim:StreetAddress.postalCode
        range: string
        required: false
        multivalued: false
      street_detail:
        description: Street detail.
        slot_uri: cim:StreetAddress.streetDetail
        range: StreetDetail
        required: true
        multivalued: false
      town_detail:
        description: Town detail.
        slot_uri: cim:StreetAddress.townDetail
        range: TownDetail
        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:
      name:
        slot_uri: cim:StreetDetail.name
        range: string
        required: false
        multivalued: false
        description: Name of the street.
      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
  TownDetail:
    description: Town details, in the context of address.
    attributes:
      code:
        description: Town code.
        slot_uri: cim:TownDetail.code
        range: string
        required: false
        multivalued: false
      name:
        slot_uri: cim:TownDetail.name
        range: string
        required: false
        multivalued: false
        description: Town name.
      state_or_province:
        description: Name of the state or province.
        slot_uri: cim:TownDetail.stateOrProvince
        range: string
        required: false
        multivalued: false
    class_uri: cim:TownDetail
  PositionPoint:
    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:
      sequence_number:
        description: Zero-relative sequence number of this point within a series of points.
        slot_uri: cim:PositionPoint.sequenceNumber
        range: integer
        required: false
        multivalued: false
      x_position:
        description: X axis position.
        slot_uri: cim:PositionPoint.xPosition
        range: string
        required: true
        multivalued: false
      y_position:
        description: Y axis position.
        slot_uri: cim:PositionPoint.yPosition
        range: string
        required: true
        multivalued: false
      z_position:
        description: (if applicable) Z axis position.
        slot_uri: cim:PositionPoint.zPosition
        range: string
        required: false
        multivalued: false
    class_uri: cim:PositionPoint
  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.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC61968.Metering
    is_a: IdentifiedObject
    attributes:
      european_article_number_ean:
        description: The attribute is used for an exchange of the EAN code (European Article Number). The length of the string is 16 characters as defined by the EAN code. For details on EAN scheme please refer to the [Codebesluit toekenning EAN-codes elektriciteit](https://www.acm.nl/nl/publicaties/codebesluit-toekenning-ean-codes-elektriciteit).
        slot_uri: nl:IdentifiedObject.europeanArticleNumberEAN
        range: string
        required: true
        multivalued: false
    class_uri: cim:UsagePoint
  MarketEvaluationPoint:
    description: The identification of an entity where energy products are measured or computed.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM.IEC62325.MarketManagement
    exact_mappings:
      - nbnl:aansluiting
    is_a: UsagePoint
    class_uri: cim:MarketEvaluationPoint
version: upcoming
generation_date: "2026-04-10"
