IdentifiedObject

description

This document describes the IdentifiedObject as part of the modelling-guidelines for the NBNL Profile Group.
version

current
author

Arend Hagreis, ahagreis@netbeheernederland.nl
feedback

Issue on GitHub (Netbeheer-Nederland/modeling-guidelines)

Introduction

This document is part of the grid modelling approach and details the grid model data requirements for data supplied by Dutch transmission and distribution system operators and describes in detail the Indentief Object.

Most of the terms in this document are used within the energy industry, particularly in standards like the IEC Common Information Model (CIM).

The cim:mRID (Master Resource Identifier) as part of the IndentifiedObjects class is a unique identification code issued by a model authority for objects within the Common Information Model (CIM). It is used to uniquely identify network components (such as lines, transformers) globally, preferably via a UUID, and is crucial for data exchange.

Definition

IdentifiedObject is a root class to provide common identification for all classes needing identification and naming attributes. The mRID attribute in this class is a unique identification code issued by a model authority (the (data) owner) for most objects within the Common Information Model (CIM).

Core entities

The identifiedObject class has two core attributes for identification and naming:

  • mRID - Master resource identifier issued by a model authority.

  • name - free human readable and possibly non unique text naming the object.

cim:IdentifiedObject
cim:IdentifiedObject

Modelling choices

Object identification (ID) is intended for machine consumption

  • IDs must be globally unique and persistent over time

  • Avoid human intervention in managing IDs → simple and cheap

Object naming is intended for human consumption

  • Names are created and managed by humans

  • Names do not have to be unique and may change but

    • Non unique names may lead to confusion and mistakes

    • Changing names may also lead to confusion and mistakes

In CIM, relationships between objects are typically established using the Master Resource Identifier (mRID), as it provides a stable and unique identifier, while the name serves as a human-readable label that can be used for display purposes or to provide additional context about the object.

The mRID is based on a UUID and is unique and persistent.

The mRID is unique within an exchange context, but preferably Global uniqueness should be achieved. This can be done by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.

The mRID is associated with the @id and the mRID attributes in Json-ld files.

    {
      "@id": "urn:uuid:4b1ce74e-2909-4311-9d12-bc6c12c45006",
      "@type": "cim:Substation",
      "cim:IdentifiedObject.mRID": "4b1ce74e-2909-4311-9d12-bc6c12c45006",
      "cim:IdentifiedObject.name": "Netstation Fictief"
    }