Skip to content

Commit

Permalink
Small changes, markdown rendered correctly
Browse files Browse the repository at this point in the history
  • Loading branch information
fspiga committed Jun 12, 2017
1 parent b29beb5 commit c8fbe5b
Showing 1 changed file with 43 additions and 15 deletions.
58 changes: 43 additions & 15 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,44 +6,72 @@

## GPU-accelerated Quantum ESPRESSO (QE-GPU)

This is an open-source custom version of Quantum ESPRESSO v6.x with embedded GPU support based on CUDA FORTRAN. This product has been made possible thanks to the effort of the [NVIDIA](http://www.nvidia.com/page/home.html) HPC Software and Benchmarks Group. This version is maintained by [Filippo Spiga](https://github.com/fspiga) and hosted on University of Cambridge Research Software Engineering GitHub page. Partial support was provided by E4 Computer Engineering SpA via the European PRACE Pre-Commercial Procurement project (Phase 3).

To contribute please refer to the guidelines in [CONTRIBUTING.md](CONTRIBUTING.md)
This is an open-source custom version of Quantum ESPRESSO with embedded GPU
support based on CUDA FORTRAN. This product has been made possible thanks to
the effort of the [NVIDIA](http://www.nvidia.com/page/home.html) HPC Software
and Benchmarks Group. This version is maintained by
[Filippo Spiga](https://github.com/fspiga) and hosted on the University of
Cambridge Research Software Engineering GitHub page. Partial support was
provided by [E4 Computer Engineering SpA](https://www.e4company.com/en/) via
the European PRACE Pre-Commercial Procurement project (Phase 3). To contribute
please refer to the guidelines in [CONTRIBUTING.md](CONTRIBUTING.md)


### Requirements

The feely available compiler suite [PGI Community Edition 17.4](http://www.pgroup.com/products/community.htm) is required to use QE-GPU. It containes CUDA SDK 8.0 and pre-built Open MPI for parallel execution (follow the [PGI Instalation Guide](http://www.pgroup.com/doc/pgiinstall174.pdf) how to install it). **No other compilers are supported**.
The freely available compiler suite
[PGI Community Edition](http://www.pgroup.com/products/community.htm) is
required to use QE-GPU. It containes CUDA SDK 8.0 and pre-built Open MPI for
parallel execution (check the
[PGI Instalation Guide](http://www.pgroup.com/doc/pgiinstall174.pdf) how to
install it). **No other compilers are supported**.

You need data-centre grade NVIDIA TESLA Kepler (K20, K20, K40, K80) and NVIDIA TESLA Pascal (P100) compute GPUs. No other cards are supported. NVIDIA TESLA P100 is strongly recommend for its memory capacity and performance.
You need data-centre grade NVIDIA TESLA Kepler (K20, K40, K80) or NVIDIA TESLA
Pascal (P100) compute GPUs. No other cards are supported. NVIDIA TESLA P100 is
strongly recommend for its memory capacity and performance.

This version of QE-GPU run **exclusively** in parallel, Open MPI is required and also Intel MKL.
This version of QE-GPU runs **exclusively** in parallel, Open MPI is required
and also Intel MKL.

### Installation

Installation process follow the same procedure as Quantum ESPRESSO suite:
The installation process follows the same procedure as Quantum ESPRESSO suite:

```
./configure --enable-gpu
make pw
```

"make" alone prints a list of acceptable targets with GPU acceleration. Binaries go in "bin/". Additional configure options are made available to customize the building process:
"make" alone prints a list of acceptable targets with various level of GPU
support. Binaries go in "bin/". Additional configure options are made
available to customize the building process:

* `--enable-gpu=<kepler|pascal>` to enable GPU support (default: on, "pascal" architecture selected)
* `--enable-gpu=<kepler|pascal>` to enable GPU support (default: on, "pascal"
architecture selected)

The QE-GPU package has been reduced in size to the minimum essential. For more information, please refer to the general documentation provided with the Quantum ESPRESSO suite or visit the web site [http://www.quantum-espresso.org/](http://www.quantum-espresso.org/)
The QE-GPU package has been reduced in size to the minimum essential. For more
information, please refer to the general documentation provided with the full
Quantum ESPRESSO suite or visit the official web site
[http://www.quantum-espresso.org/](http://www.quantum-espresso.org/)


### Cite as:
### Citation

A Zenodo citation will be uploaded soon
A Zenodo citation will be uploaded soon.


### License

All the material included in this distribution is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
All the material included in this distribution is free software; you can
redistribute it and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version.

These programs are distributed in the hope that they will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
These programs are distributed in the hope that they will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 675 Mass
Ave, Cambridge, MA 02139, USA.

0 comments on commit c8fbe5b

Please sign in to comment.