1                                       ``:oss/
2                           `.+s+.     .+ys--yh+     `./ss+.
3                          -sh//yy+`   +yy   +yy    -+h+-oyy
4                          -yh- .oyy/.-sh.   .syo-.:sy-  /yh
5                 `.-.`    `yh+   -oyyyo.     `/syys:    oys      `.`
6               `/+ssys+-` `sh+      `                   oys`   .:osyo`
7               -yh- ./syyooyo`                          .sys+/oyo--yh/
8               `yy+    .-:-.                             `-/+/:`  -sh-
9                /yh.                                              oys
10          ``..---hho---------`   .---------..`      `.-----.`    -hd+---.
11       `./osmNMMMMMMMMMMMMMMMs. +NNMMMMMMMMNNmh+.   yNMMMMMNm-  oNMMMMMNmo++:`
12       +sy--/sdMMMhyyyyyyyNMMh- .oyNMMmyyyyyhNMMm+` -yMMMdyyo:` .oyyNMMNhs+syy`
13       -yy/   /MMM+.`-+/``mMMy-   `mMMh:`````.dMMN:` `MMMy-`-dhhy```mMMy:``+hs
14        -yy+` /MMMo:-mMM+`-oo/.    mMMh:     `dMMN/`  dMMm:`dMMMMy..MMMo-.+yo`
15         .sys`/MMMMNNMMMs-         mMMmyooooymMMNo:   oMMM/sMMMMMM++MMN//oh:
16          `sh+/MMMhyyMMMs- `-`     mMMMMMMMMMNmy+-`   -MMMhMMMsmMMmdMMd/yy+
17    `-/+++oyy-/MMM+.`/hh/.`mNm:`   mMMd+/////:-.`      NMMMMMd/:NMMMMMy:/yyo/:.`
18   +os+//:-..-oMMMo:--:::-/MMMo. .-mMMd+---`           hMMMMN+. oMMMMMo. `-+osyso:`
19   syo     `mNMMMMMNNNNNNNNMMMo.oNNMMMMMNNNN:`         +MMMMs:`  dMMMN/`     ``:syo
20   /yh`     :syyyyyyyyyyyyyyyy+.`+syyyyyyyyo:`         .oyys:`   .oyys:`        +yh
21   -yh-        ````````````````    `````````              ``        ``          oys
22   -+h/------------------------::::::::://////++++++++++++++++++++++///////::::/yd:
23   shdddddddddddddddddddddddddddddhhhhhhhhyyyyyssssssssssssssssyyyyyyyhhhhhhhddddh`
24
25 EPW v4 is part of the open-source Quantum ESPRESSO suite
26 for quantum simulation of materials; please cite
27     "P. Giannozzi et al., J. Phys.:Condens. Matter 21 395502 (2009);
28      URL http://www.quantum-espresso.org",
29 in publications or presentations arising from this work. More details at
30 http://www.quantum-espresso.org/quote
31
32 Please also consider citing the EPW papers:
33 1) F. Giustino, M. L. Cohen, and S. G. Louie, Phys. Rev. B 76, 165108 (2007)
34 2) S. Ponc\'e, E. R. Margine, C. Verdi and F. Giustino, Comput. Phys. Commun. 209, 116 (2016)
35
36 The software tree of EPW v4 is composed of
37 /bin ==> Contains the epw.x soft link to the EPW executable.
38 /examples  ==> Contains a lists of examples that are connected to the tutorials. The
39          tutorials can be found at http://epw.org.uk/Documentation/Tutorial
40 /src ==> Contains all the EPW source files.
41 /tests ==> Small tests useful for debugging and checking if the code works. Those tests are used
42          by the test farm. Do not expect physically relevant results out of it.
43
44 Installation
45 ------------
46 To compile the code you first need to issue ./configure in /espresso.
47 Indeed EPW rely on the make.sys file created by QE.
48 Then you can run ./make inside espresso/EPW.
49
50 EPW dedicated website and forum
51 -------------------------------
52 EPW has a dedicated website that you can access at http://epw.org.uk/
53
54 If you have any questions, please use the forum at http://epwforum.uk/
55
56 Initial release inside Quantum ESPRESSO
57 ---------------------------------------
58 SP, ERM, CV, FG, 1 March 2016
59
60
61
62
63
64
65
66
67
68