Project

General

Profile

CIM Issues #6202

Modeling guide is missing instructions for data type names in attribute names

Added by Martin Miller 9 months ago. Updated 4 months ago.

Status:
Review
Priority:
Normal
Solution Version:
CIM18
Breaking Change:
Yes
Breaking Change Description:
Change to attribut names
CIM Impacted Groups:
WG13, WG14, WG16
Requestor:
Martin Miller
Standard(s):

CIM Modeling Guide

Version:
v1.1
Clause:
Sub-Clause:
Paragraph:
Table:
Origination Date:
Origination ID:
Originally Assigned To:

Description

In a previous version of CIM, the UML was cleaned up to change all properties like "ratedkV" and "ratedVoltage" to be renamed to "ratedU" based on the policy that the data type abbreviations should be used instead of data type names or units of measurement.

However, this naming rule is missing in section "5.5 Attribute Rules" in the CIM Modeling Guide v1.1 (2021-02-13).


Decision

Reviewed on 12-Jun-2023 in Oslo:

Reviewed and universally agreed that this should be added to the CIM Modelling Guide document. It should be spelled out explicitly in the guide which values this should adhere to and what the required value should be. The below is what was decided should be added as a rule to the section:

Active Power (P)
Reactive Power (Q)
Apparent Power (S)
Resistance (R)
Reactance (X)
Conductance (G)
Susceptance (B)
Power Factor (PF)

IMPORTANT: the rule should state that camel case is to be used. So an attribute would be just "x" and not "X" but ratedX if using camel case.

While there is agreement on the attributes with units listed above, the universal use of (U) for voltage needs further exploration.(e.g. voltage should voltage be using "U" e.g. not ratedkV or ratedVotage, but rather ratedU). It would be good to identify the voltage attributes to see if there are obvious attributes that should be cleaned up.

Additionally, the rule should include:
When expressing sequencing specifically for Reactance (X), (Resistance) R, Susceptance (B) and Conductance (G) the following abbreviations are to be applied:

positive -> expressed as shown above as X, R, B, G
zero sequence -> express as X0, R0, B0, G0
negative sequence -> express as X2, R2, B2, G2

NOTE: As part of this task the UML should be updated so that wherever the existing model expresses or abbreviates "Participation Factor" today as PF it should be changed to fully spell the attribute out. This will remove any ambiguity that will exist. Also we have 2 instances in the UML today where we have negative sequencing expressed as RN and XN and should be changed to R2 and X2 (this would be a breaking change). Given that CIM18 has a lot of breaking changes it is recommended this goes in at the same time (before September 2023).

Question remains as to who to assign the modeling guide updates to.

Modeling should be done by respective modeling managers where applicable.

#1

Updated by Martin Miller 9 months ago

  • Subject changed from Modeling guide is missing instructions for value types in names to Modeling guide is missing instructions for data type names in attribute names
#2

Updated by Todd Viegut 4 months ago

  • Status changed from New to Open
#3

Updated by Todd Viegut 4 months ago

  • Status changed from Open to Review
  • Solution Version set to CIM18
  • Breaking Change set to Yes
  • Breaking Change Description set to Change to attribut names
  • Requestor set to Martin Miller
  • Decision updated (diff)
#4

Updated by Pat Brown 4 months ago

  • Decision updated (diff)
#5

Updated by Pat Brown 4 months ago

  • Decision updated (diff)

Also available in: Atom PDF