CIM-CGMES

The CMGES (Common Grid Model Exchange Specification) is an IEC technical specification (TS) based on the IEC CIM (Common Information Model) family of standards. It was developed to meet necessary requirements for TSO data exchanges in the areas of system development and system operation.

• Format specification
• Import
  • Inconsistency checks
  • From CGMES to IIDM
  • Extensions
  • Options
• Export
• Triple stores
  • Rdf4j
  • Jena
  • Blazegraph
• Examples

Format specification

Current supported version of CGMES is 2.4.15, that is based on CIM 16. We can note that this importer is also compatible with CIM 14.

To learn more about CGMES files, read the complete CMGES format specification.

Import

Inconsistency checks

TODO

From CGMES to IIDM

TODO

Extensions

TODO

Options

These properties can be defined in the configuration file in the import-export-parameters-default-value module.

iidm.import.cgmes.allow-unsupported-tap-changers
The iidm.import.cgmes.allow-unsupported-tap-changers property is an optional property that determines if every tap changer is read in order to be converted in best effort or if only supported tap changers are read and converted. By default, its value is true.

iidm.import.cgmes.boundary-location
The iidm.import.cgmes.boundary-location property is an optional property that defines the directory path where the CGMES importer can find the boundary files if they are not present in the imported zip file. By default, its value is <ITOOLS_CONFIG_DIR>/CGMES/boundary.

iidm.import.cgmes.change-sign-for-shunt-reactive-power-flow-initial-state
The iidm.import.cgmes.change-sign-for-shunt-reactive-power-flow-initial-state property is an optional property that defines if the CGMES importer inverts the sign of reactive power flows for shunt compensators. Its default value is false.

iidm.import.cgmes.convert-boundary
The iidm.import.cgmes.convert-boundary property is an optional property that defines if the CGMES importer imports equipments inside the boundaries or not. Its default value is false.

iidm.import.cgmes.create-busbar-section-for-every-connectivity-node
The iidm.import.cgmes.create-busbar-section-for-every-connectivity-node property is an optional property that defines if the CGMES importer creates an IIDM Busbar Section for each CGMES connectivity node. Its default value is false.

iidm.import.cgmes.powsybl-triplestore
The iidm.import.cgmes.powsybl-triplestore property is an optional property that defines which triplestore implementation is used. PowSyBl supports the RDF4J, Jena and Blazegraph triplestore implementations. This property has rdf4j as default value.

iidm.import.cgmes.store-cgmes-model-as-network-extension
The iidm.import.cgmes.store-cgmes-model-as-network-extension property is an optional property that defines if the CGMES model is stored in the imported IIDM network as an extension. Its default value is true.

Deprecated properties

changeSignForShuntReactivePowerFlowInitialState
The changeSignForShuntReactivePowerFlowInitialState property is deprecated since v2.4.0. Use iidm.import.cgmes.change-sign-for-shunt-reactive-power-flow-initial-state instead.

convertBoundary
The convertBoundary property is deprecated since v2.4.0. Use iidm.import.cgmes.convert-boundary instead.

createBusbarSectionForEveryConnectivityNode
The createBusbarSectionForEveryConnectivityNode property is deprecated since v2.4.0. Use iidm.import.cgmes.create-busbar-section-for-every-connectivity-node instead.

powsyblTripleStore
The powsyblTripleStore property is deprecated since v2.4.0. Use iidm.import.cgmes.powsybl-triplestore instead.

storeCgmesModelAsNetworkExtension
The storeCgmesModelAsNetworkExtension property is deprecated since v2.4.0. Use iidm.import.cgmes.store-cgmes-model-as-network-extension instead.

Export

TODO

Triple stores

Rdf4j

TODO

Jena

TODO

Blazegraph

TODO

Examples

Have a look to the CGMES sample files from ENTSO-E Test Configurations for Conformity Assessment Scheme v2.0.