Keywords: user_guide

Next: 2.2 Prerequisites Up: 2 Installation Previous: 2 Installation Contents

## 2.1 Download

Presently, QUANTUM ESPRESSO is distributed in source form; some precompiled executables (binary files) are provided for `PWgui`. Packages for the Debian Linux distribution are however made available by `debichem` developers. Stable releases of the QUANTUM ESPRESSO source package (current version is 5.0.2) can be downloaded from the Download section of `www.quantum-espresso.org`. If you plan to run on GPU machines, download the GPU-enabled version, also reachable from the same link.

Uncompress and unpack the base distribution using the command:

         tar zxvf espresso-X.Y.Z.tar.gz

(a hyphen before "zxvf" is optional) where `X.Y.Z` stands for the version number. If your version of `tar` doesn't recognize the "z" flag:

         gunzip -c espresso-X.Y.Z.tar.gz | tar xvf -

A directory `espresso-X.Y.Z/` will be created. Given the size of the complete distribution, you may need to download more packages. If the computer you expect to install QUANTUM ESPRESSO is always connected to the internet, the `Makefile`'s will automatically download, unpack and install the required packages on demand. If not, you can download each required package into subdirectory `archive` but not unpacked or uncompressed: command `make` will take care of this during installation.

Package `GWL` needs a manual download and installation: please follow the instructions given at `gww.qe-forge.org`.

The bravest may access the development version via anonymous access to the Subversion (SVN) repository: `qe-forge.org/gf/project/q-e/scmsvn`, link ''Access Info'' on the left. See also the Developer Manual (`Doc/developer_man.pdf`), section ''Using SVN''. Beware: the development version is, well, under development: use at your own risk!

The QUANTUM ESPRESSO distribution contains several directories. Some of them are common to all packages:

`Modules/` | source files for modules that are common to all programs
`include/` | files *.h included by fortran and C source files
`clib/` | external libraries written in C
`flib/` | external libraries written in Fortran
`install/` | installation scripts and utilities
`pseudo`/ | pseudopotential files used by examples
`upftools/` | converters to unified pseudopotential format (UPF)
`Doc/` | general documentation
`archive/` | contains plug-ins in .tar.gz form

while others are specific to a single package:

`PW/` | `PWscf` package
`NEB/` | `PWneb` package
`PP/` | `PostProc` package
`PHonon/` | `PHonon` package
`PWCOND/` | `PWcond` package
`CPV/` | `CP` package
`atomic/` | `atomic` package
`GUI/` | `PWGui` package

Next: 2.2 Prerequisites Up: 2 Installation Previous: 2 Installation Contents