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.