libcimpp

libcimpp is a deserialiser library for C++ objects from XML/RDF documents based on the Common Information Model (CIM) standards (i.e. IEC61970/61968/62325) for the energy sector. It is part of the CIM++ project. More on CIM++ can be found here and on the CIM++ HomePage.

Licensing

For non-commercial use this software is licensed under the terms in the included LICENSE file. In case of commercial use, you are asked to inform the Institute for Automation of Complex Power Systems at RWTH Aachen University. Therefore please write to acs-sek@eonerc.rwth-aachen.de.

General information

limcimpp uses arabica as cross platform wrapper around one of the XML parsers listed int the dependencies (see below). It is recommended to use libcimpp as cmake module.

Dependencies

You need following software packages for libcimpp:

• One of the following XML parsers:
  • libxml2 (usually chosen under Linux and often can be installed as a package of the used distribution)
  • expat
  • Xerces
  • Microsoft XML Parser (this one is used per default when building with MS Visual Studio)
• Build system:
  • cmake

Get the Git repository

git clone https://github.com/RWTH-ACS/libcimpp.git
cd libcimpp
git submodule update --init --recursive

Build instructions

The UNIX / Linux / MacOS way

After getting the Git repository, create a build subdirectory and change into it:

mkdir build
cd build

For building libcimpp with the default CIM version, type:

cmake ..
make -j 4

For building libcimpp with a certain CIM version (e.g. IEC61970_16v29a), type:

cmake .. -DUSE_CIM_VERSION=IEC61970_16v29a
make -j 4

All available CIM versions can be determined in the CMakeLists.txt

The Windows way with MS Visual Studio

1. After getting the Git repository, create a build subdirectory.
2. Run the Windows CMake (GUI)
3. Set the

• source code directory, e.g.: C:/git/libcimpp
• build directory, e.g.: C:/git/libcimpp/build

4. Click on Configure and choose the Visual Studio project version, e.g.: Visual Studio 15 2017
5. Click on Finish and wait while CMake is configuring the project.
6. Click on Generate to generate the Visual Studio project files.
7. Click on Open Project to open the project in Visual Studio.
8. In Visual Studio's main menu choose Build -> Build Solution. This will build the libcimpp library.

Build instructions for using libcimpp as a cmake module

To be continued...

Usage of the libcimpp library

For information how to use the library please see the cmake based example. Building of the example can be performed analogous to bulding the library itself (as described in the Build instructions above).
The pure make example is currently not supported due to the lack of an install target for arabica.