Project

General

Profile

CIM Issues #5049

Inconsistent naming for p,q,r,x and others

Added by Herbert Falk about 2 years ago. Updated 6 months ago.

Status:
Review
Priority:
Normal
Author/Contact Info:
Todd Viegut
Base Release:
CIM17
Solution to be Applied To:
CIM18
Solution Version:
Solution Applied By:
Completion Date:
CIM Keywords:
Breaking Change:
Yes
Breaking Change Description:
Because attributes are renamed
CIM Impacted Groups:
WG13
Requestor:
Standard(s):
Version:
Clause:
Sub-Clause:
Paragraph:
Table:
Originally Closed in Version:
Origination Date:
01/14/2020
Origination ID:
13_303
Originally Assigned To:

Description

Per CDV country comments CH_78, SE6, SE75 & NO71 for 301 Ed7:

Within the DCGround class the attribute 'r' (i.e. resistance to ground.) should be renamed to resistance so as to be consistent in other areas of the CIM such as in DCLineSegment.resistance.

There are two schools on attribute naming.

Short alias names relating to quantity names is commonly used, e.g.
  • P - active power
    . Q - reactive power
    . r - resistance
    . x - reactance
    . etc.

Verbose names describing the quantity:
. activePower
. reactivePower
. resistance
. reactance
. etc

Both are used but the alias naming is more common for p, q, r, x etc.

Having different attribute names for the same quantity increase complexity in implementations as more names must be handled for the same quantity, e.g. EnergySource.activePower and RotatingMachine.p


Proposed Solution

Proposal to rename to resistance was discussed for inclusion in CIM18.

Note that these may be breaking changes and thus why deferred to CIM 18.

It was strongly suggested that we add to our modeling guidelines guide that the same name should be used for attributes that represent the same information across all CIM classes.


Decision

14-Jan-2020 Decision to apply the proposed resolution when revving to CIM18

Oslo, 14 Jun 2023
Apply the changes following the decision in issue #6202

#1

Updated by Yang Feng over 1 year ago

  • Subject changed from Per CDV country comments CH_78, SE6, SE75 & NO71 for 301 Ed to Inconsistent naming for p,q,r,x and others
  • Proposed Solution updated (diff)
#2

Updated by Chavdar Ivanov 10 months ago

  • Status changed from New to Open
  • Solution to be Applied To changed from 61970cim18 to CIM18
  • Breaking Change changed from No to Yes
  • Breaking Change Description set to Because attributes are renamed

Question: do we only fix DCGround.r or in all places where we have .r, .p. .q? For example in the converters in teh C package we have p and q. SvPowerFlow and many other classes....

#3

Updated by Chavdar Ivanov 10 months ago

  • Status changed from Open to Review
#4

Updated by Chavdar Ivanov 6 months ago

  • Decision updated (diff)

Also available in: Atom PDF