PowerGrid - install - Installation

Installation

Building PowerGrid

Building PowerGrid

Building PowerGrid requires several dependencies, depending on the features you want to use or develop. For testing or algorithm development without GPU acceleration, fewer dependencies are required. Testing with GPU support, distributed memory support (MPI), or ISMRMRD support requires additional dependencies.

Required Dependencies

Supported OSes:

  • Linux (CPU, GPU, MPI) - Ubuntu 14.04 and 16.04 have been tested by the developers
  • Mac OS X (CPU, MPI) - El Capitan has been tested by the developers

Dependencies for CPU execution

  • CMake - Version 2.8 or higher required.
  • libarmadillo - Version 6.x required, 6.700.7 recommended, Version 7.x not supported yet.
  • FFTW - We only support FFTW3 and need a reasonably recent version.
  • Xerces-C++ - Version 3.1.0 or greater.
  • XSD - Version 4.0 or greater

Dependencies for Experimental ISMRMRD Support

  • libismrmrd - We are using the master branch in the repository but not version 2.0 yet.

Dependencies for GPU execution

  • cufft library - The version accompanying CUDA 7.0 has been tested
  • C++ compiler supporting OpenACC

We have experience with PGC++ 15.7 from NVIDIA/The Portland Group as the version we have used most extensively. There is a free license available as part of the OpenACC Toolkit for academic users.

GCC 6.1 has OpenACC support but has not yet been tested by the developers, we welcome reports of anyone trying to compile with it. We hope to support it alongside PGI compilers in the near future.

For those lucky enough to have access to Cray supercomputers, the Cray compiler does support OpenACC, but we have not tried to build with it. Because the Cray compilers are not available on desktops, workstations, or non-Cray branded clusters, we have not dedicated resources to testing PowerGrid on it.

Download PowerGrid

You can get a copy of PowerGrid either by cloning the Git repository or by downloading a copy of the repository.

Clone Git Repository from GitHub

git clone git@github.com:mrfil/PowerGrid.git

Download archive from GitHub

To download PowerGrid, go to PowerGrid GitHub page and click “Download Zip” on the right side of the page.

If you would like to use git to host your website on GitHub Pages you can also click “Clone on Desktop” given that you’ve got git installed.

Download Zip or Clone

If you want to contribute code back to the project, we recommend forking the project.