Design package URLs (namespaces)

[VladimirAlexiev]

@griddigit-ci in https://github.com/Sveino/Inst4CIM-KG/issues/12#issuecomment-2350838054 I have a question here. Is it good to actually have the packages just as "fragment" of the namespace

In the new dynamics and also for the rest of CIM we applied uris for each package Dynamics: http://cim.ucaiug.io/grid/Dynamics/1.0 StandardInterconnections: http://cim.ucaiug.io/grid/StandardInterconnections/1.0

Can each package by a vocabulary and the uri be the namespace of that vocabulary?

The cim prefix is http://cim.ucaiug.io/ns#. Can we also map this to http://cim.ucaiug.io/ and then we would understand that StandardInterconnections is a vocabulary from cim grid part?

then instead of defining this as a package we can describe the metadata for that vocabulary

[VladimirAlexiev]

12 finds these packages in DY:

• dy:Package_AsynchronousMachineDynamics
• dy:Package_Base
• dy:Package_Core
• dy:Package_DC
• dy:Package_DiscontinuousExcitationControlDynamics
• dy:Package_Domain
• dy:Package_Dynamics
• dy:Package_DynamicsProfile
• dy:Package_ExcitationSystemDynamics
• dy:Package_HVDCDynamics
• dy:Package_LoadDynamics
• dy:Package_MechanicalLoadDynamics
• dy:Package_OverexcitationLimiterDynamics
• dy:Package_PFVArControllerType1Dynamics
• dy:Package_PFVArControllerType2Dynamics
• dy:Package_PowerSystemStabilizerDynamics
• dy:Package_StandardInterconnections
• dy:Package_StandardModels
• dy:Package_StaticVarCompensatorDynamics
• dy:Package_SynchronousMachineDynamics
• dy:Package_TurbineGovernorDynamics
• dy:Package_TurbineLoadControllerDynamics
• dy:Package_UnderexcitationLimiterDynamics
• dy:Package_UserDefinedModels
• dy:Package_VoltageAdjusterDynamics
• dy:Package_VoltageCompensatorDynamics
• dy:Package_WindDynamics
• dy:Package_Wires

IMHO these packages fall into two kinds:

• common: Package_Base, Package_DC, Package_Wires etc. These don't belong to DY! DY uses (imports) such packages, but they are not defined by DY so these URLs are wrong. This is the same problem as https://github.com/Sveino/Inst4CIM-KG/issues/10
• specific: Package_Dynamics, Package_DynamicsProfile, Package_ExcitationSystemDynamics, etc. Let's define a URL policy for these specific packages only.

Here's a proposal:

• For the main (top-level) package of an ontology, use the ontology URL. I think that the ontology and its main package are the same thing. @Sveino and @griddigit-ci do you agree?
• For "sub-packages", add hierarchical parts to the ontology URL.

Assuming that http://cim.ucaiug.io/grid/Dynamics is the ontology URL, we can have:

• http://cim.ucaiug.io/grid/Dynamics: main package
• http://cim.ucaiug.io/grid/Dynamics/DynamicsProfile: ?? not sure what that is. I don't quite understand the difference between Profile and Package.
• http://cim.ucaiug.io/grid/Dynamics/ExcitationSystemDynamics: sub-package
• http://cim.ucaiug.io/grid/Dynamics/WindDynamics: sub-package

Can we remove the duplicated word "Dynamics" from the last part? Do these sound ok?

• http://cim.ucaiug.io/grid/Dynamics/ExcitationSystem: sub-package
• http://cim.ucaiug.io/grid/Dynamics/Wind: sub-package

At present, the URLs look like this. IMHO Package is unnecessary and Dynamics is again duplicated

• http://iec.ch/TC57/ns/CIM/Dynamics-EU#Package_Dynamics
• http://iec.ch/TC57/ns/CIM/Dynamics-EU#Package_DynamicsProfile
• http://iec.ch/TC57/ns/CIM/Dynamics-EU#Package_ExcitationSystemDynamics
• http://iec.ch/TC57/ns/CIM/Dynamics-EU#Package_WindDynamics

Chavdar, using _ or / in the fragment part (after #) is allowed. Using # is not allowed. But I like to use / both for the main namespace, and for its hierarchical subdivision.

Important: https://github.com/Sveino/Inst4CIM-KG/issues/57