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

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.ensure-id-alias-unicity The iidm.import.cgmes.ensure-id-alias-unicity property is an optional property that defines if IDs and aliases’ unicity is ensured during CGMES import. If it is set to true, identical CGMES IDs will be modified to be unique. If it is set to false, identical CGMES IDs will throw an exception. Its default value is false.

iidm.import.cgmes.post-processors The iidm.import.cgmes.post-processors property is an optional property that defines all the CGMES post-processors which are to be activated after import. By default, it is an empty list.

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.profile-used-for-initial-state-values The iidm.import.cgmes.profile-used-for-initial-state-values property is an optional property that defines which profile is used in priority for initial state values. It can be SSH or SV. Its default value is SSH.

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.

iidm.import.cgmes.store-cgmes-conversion-context-as-network-extension The iidm.import.cgmes.store-cgmes-conversion-context-as-network-extension property is an optional property that defines if the CGMES Conversion context will be stored as an extension of the IIDM output network. Its default value is false.

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.