1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
|
\contentsline {section}{\numberline {1}Introduction}{3}{section.1}
\contentsline {subsection}{\numberline {1.1}Who should read (and who should {\em write}) this guide}{3}{subsection.1.1}
\contentsline {subsection}{\numberline {1.2}Who may read this guide but will not necessarily profit from it}{3}{subsection.1.2}
\contentsline {subsection}{\numberline {1.3}How to contribute to {\sc Quantum ESPRESSO}\ as a user}{3}{subsection.1.3}
\contentsline {section}{\numberline {2}{\sc Quantum ESPRESSO}\ as a distribution}{4}{section.2}
\contentsline {section}{\numberline {3}How to become a developer}{5}{section.3}
\contentsline {subsection}{\numberline {3.1}About \texttt {qe-forge.org}}{5}{subsection.3.1}
\contentsline {subsection}{\numberline {3.2}{\sc Quantum ESPRESSO}\ on \texttt {qe-forge.org}}{5}{subsection.3.2}
\contentsline {subsection}{\numberline {3.3}Contributing new developments}{6}{subsection.3.3}
\contentsline {subsection}{\numberline {3.4}Hints, Caveats, Do's and Dont's for developers}{7}{subsection.3.4}
\contentsline {subsection}{\numberline {3.5}Guidelines for reporting bugs}{8}{subsection.3.5}
\contentsline {section}{\numberline {4}Stable releases and development cycle}{8}{section.4}
\contentsline {paragraph}{Preparing a release}{9}{section*.2}
\contentsline {paragraph}{Updating web site}{9}{section*.3}
\contentsline {section}{\numberline {5}Structure of the distribution}{9}{section.5}
\contentsline {subsection}{\numberline {5.1}Installation Mechanism}{10}{subsection.5.1}
\contentsline {paragraph}{make.sys}{10}{section*.4}
\contentsline {paragraph}{Makefile}{11}{section*.5}
\contentsline {paragraph}{PW/Makefile}{11}{section*.6}
\contentsline {paragraph}{PW/src/Makefile}{12}{section*.7}
\contentsline {subsubsection}{\numberline {5.1.1}Preprocessing}{13}{subsubsection.5.1.1}
\contentsline {subsubsection}{\numberline {5.1.2}How to edit the \texttt {configure}\ script}{14}{subsubsection.5.1.2}
\contentsline {subsubsection}{\numberline {5.1.3}How to add support for a new architecture}{15}{subsubsection.5.1.3}
\contentsline {subsection}{\numberline {5.2}Libraries}{19}{subsection.5.2}
\contentsline {section}{\numberline {6}Algorithms}{20}{section.6}
\contentsline {subsection}{\numberline {6.1}Gamma tricks}{20}{subsection.6.1}
\contentsline {subsection}{\numberline {6.2}Restart}{20}{subsection.6.2}
\contentsline {section}{\numberline {7}Format of arrays containing charge density, potential, etc.}{21}{section.7}
\contentsline {section}{\numberline {8}Parallelization}{22}{section.8}
\contentsline {subsubsection}{\numberline {8.0.1}Usage of \#ifdef \_\_MPI}{22}{subsubsection.8.0.1}
\contentsline {subsection}{\numberline {8.1}Tricks and pitfalls}{22}{subsection.8.1}
\contentsline {subsection}{\numberline {8.2}Data distribution}{23}{subsection.8.2}
\contentsline {section}{\numberline {9}File Formats}{23}{section.9}
\contentsline {subsection}{\numberline {9.1}Data file(s)}{23}{subsection.9.1}
\contentsline {subsubsection}{\numberline {9.1.1}Rationale}{23}{subsubsection.9.1.1}
\contentsline {subsubsection}{\numberline {9.1.2}General structure}{24}{subsubsection.9.1.2}
\contentsline {subsubsection}{\numberline {9.1.3}Structure of file "data-file.xml"}{25}{subsubsection.9.1.3}
\contentsline {subsubsection}{\numberline {9.1.4}Sample}{26}{subsubsection.9.1.4}
\contentsline {subsection}{\numberline {9.2}Restart files}{31}{subsection.9.2}
\contentsline {section}{\numberline {10}Modifying/adding/extending {\sc Quantum ESPRESSO}}{31}{section.10}
\contentsline {subsection}{\numberline {10.1}Programming style (or lack of it)}{31}{subsection.10.1}
\contentsline {subsection}{\numberline {10.2}Adding or modifying input variables}{32}{subsection.10.2}
\contentsline {section}{\numberline {11}Using SVN}{33}{section.11}
\contentsline {subsection}{\numberline {11.1}SVN operations}{34}{subsection.11.1}
\contentsline {subsection}{\numberline {11.2}Removing conflicts}{34}{subsection.11.2}
\contentsline {subsection}{\numberline {11.3}Merging branch and trunk}{35}{subsection.11.3}
\contentsline {subsection}{\numberline {11.4}Including a repository into the trunk}{35}{subsection.11.4}
\contentsline {section}{\numberline {12}Bibliography}{36}{section.12}
|
