This file is indexed.

/usr/share/doc/quantum-espresso/html/node23.html is in quantum-espresso 4.3.2-1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">

<!--Converted with LaTeX2HTML 2008 (1.71)
original version by:  Nikos Drakos, CBLU, University of Leeds
* revised and updated by:  Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>4.3 Format of arrays containing charge density, potential, etc.</TITLE>
<META NAME="description" CONTENT="4.3 Format of arrays containing charge density, potential, etc.">
<META NAME="keywords" CONTENT="user_guide">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">

<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">

<LINK REL="STYLESHEET" HREF="user_guide.css">

<LINK REL="next" HREF="node24.html">
<LINK REL="previous" HREF="node22.html">
<LINK REL="up" HREF="node20.html">
<LINK REL="next" HREF="node24.html">
</HEAD>

<BODY >
<!--Navigation Panel-->
<A NAME="tex2html644"
  HREF="node24.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
<A NAME="tex2html640"
  HREF="node20.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
<A NAME="tex2html634"
  HREF="node22.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
<A NAME="tex2html642"
  HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
<BR>
<B> Next:</B> <A NAME="tex2html645"
  HREF="node24.html">4.4 Pseudopotential files</A>
<B> Up:</B> <A NAME="tex2html641"
  HREF="node20.html">4 Using QUANTUM ESPRESSO</A>
<B> Previous:</B> <A NAME="tex2html635"
  HREF="node22.html">4.2 Data files</A>
 &nbsp; <B>  <A NAME="tex2html643"
  HREF="node1.html">Contents</A></B> 
<BR>
<BR>
<!--End of Navigation Panel-->

<H2><A NAME="SECTION00053000000000000000">
4.3 Format of arrays containing charge density, potential, etc.</A>
</H2>

<P>
The index of arrays used to store functions defined on 3D meshes is
actually a shorthand for three indices, following the FORTRAN convention 
("leftmost index runs faster"). An example will explain this better. 
Suppose you have a 3D array <TT>psi(nr1x,nr2x,nr3x)</TT>. FORTRAN 
compilers store this array sequentially  in the computer RAM in the following way:
<PRE>
        psi(   1,   1,   1)
        psi(   2,   1,   1)
        ...
        psi(nr1x,   1,   1)
        psi(   1,   2,   1)
        psi(   2,   2,   1)
        ...
        psi(nr1x,   2,   1)
        ...
        ...
        psi(nr1x,nr2x,   1)
        ...
        psi(nr1x,nr2x,nr3x)
etc
</PRE>
Let <TT>ind</TT> be the position of the <TT>(i,j,k)</TT> element in the above list: 
the following relation
<PRE>
        ind = i + (j - 1) * nr1x + (k - 1) *  nr2x * nr1x
</PRE>
holds. This should clarify the relation between 1D and 3D indexing. In real
space, the <TT>(i,j,k)</TT> point of the FFT grid with dimensions 
<TT>nr1</TT> (<IMG
 WIDTH="19" HEIGHT="35" ALIGN="MIDDLE" BORDER="0"
 SRC="img9.png"
 ALT="$ \le$"><TT>nr1x</TT>), 
<TT>nr2</TT>  (<IMG
 WIDTH="19" HEIGHT="35" ALIGN="MIDDLE" BORDER="0"
 SRC="img9.png"
 ALT="$ \le$"><TT>nr2x</TT>), , <TT>nr3</TT> (<IMG
 WIDTH="19" HEIGHT="35" ALIGN="MIDDLE" BORDER="0"
 SRC="img9.png"
 ALT="$ \le$"><TT>nr3x</TT>), is
<P><!-- MATH
 \begin{displaymath}
r_{ijk}=\frac{i-1}{nr1} \tau_1  +  \frac{j-1}{nr2} \tau_2 +
\frac{k-1}{nr3} \tau_3
\end{displaymath}
 -->
</P>
<DIV ALIGN="CENTER">
<I>r</I><SUB>ijk</SUB> = <IMG
 WIDTH="48" HEIGHT="61" ALIGN="MIDDLE" BORDER="0"
 SRC="img10.png"
 ALT="$\displaystyle {\frac{{i-1}}{{nr1}}}$"><IMG
 WIDTH="20" HEIGHT="35" ALIGN="MIDDLE" BORDER="0"
 SRC="img11.png"
 ALT="$\displaystyle \tau_{1}^{}$"> + <IMG
 WIDTH="50" HEIGHT="61" ALIGN="MIDDLE" BORDER="0"
 SRC="img12.png"
 ALT="$\displaystyle {\frac{{j-1}}{{nr2}}}$"><IMG
 WIDTH="20" HEIGHT="35" ALIGN="MIDDLE" BORDER="0"
 SRC="img13.png"
 ALT="$\displaystyle \tau_{2}^{}$"> + <IMG
 WIDTH="52" HEIGHT="61" ALIGN="MIDDLE" BORDER="0"
 SRC="img14.png"
 ALT="$\displaystyle {\frac{{k-1}}{{nr3}}}$"><IMG
 WIDTH="20" HEIGHT="35" ALIGN="MIDDLE" BORDER="0"
 SRC="img15.png"
 ALT="$\displaystyle \tau_{3}^{}$">
</DIV><P></P>
where the <IMG
 WIDTH="18" HEIGHT="35" ALIGN="MIDDLE" BORDER="0"
 SRC="img16.png"
 ALT="$ \tau_{i}^{}$"> are the basis vectors of the Bravais lattice. 
The latter are stored row-wise in the <TT>at</TT> array:
<IMG
 WIDTH="20" HEIGHT="35" ALIGN="MIDDLE" BORDER="0"
 SRC="img17.png"
 ALT="$ \tau_{1}^{}$"> = <TT>at(:, 1)</TT>, 
<IMG
 WIDTH="20" HEIGHT="35" ALIGN="MIDDLE" BORDER="0"
 SRC="img18.png"
 ALT="$ \tau_{2}^{}$"> = <TT>at(:, 2)</TT>, 
<IMG
 WIDTH="20" HEIGHT="35" ALIGN="MIDDLE" BORDER="0"
 SRC="img19.png"
 ALT="$ \tau_{3}^{}$"> = <TT>at(:, 3)</TT>.

<P>
The distinction between the dimensions of the FFT grid,
<TT>(nr1,nr2,nr3)</TT> and the physical dimensions of the array,
<TT>(nr1x,nr2x,nr3x)</TT> is done only because it is computationally
convenient in some cases that the two sets are not the same.
In particular, it is often convenient to have <TT>nrx1</TT>=<TT>nr1</TT>+1
to reduce memory conflicts.

<P>
<HR>
<!--Navigation Panel-->
<A NAME="tex2html644"
  HREF="node24.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
<A NAME="tex2html640"
  HREF="node20.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
<A NAME="tex2html634"
  HREF="node22.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
<A NAME="tex2html642"
  HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
<BR>
<B> Next:</B> <A NAME="tex2html645"
  HREF="node24.html">4.4 Pseudopotential files</A>
<B> Up:</B> <A NAME="tex2html641"
  HREF="node20.html">4 Using QUANTUM ESPRESSO</A>
<B> Previous:</B> <A NAME="tex2html635"
  HREF="node22.html">4.2 Data files</A>
 &nbsp; <B>  <A NAME="tex2html643"
  HREF="node1.html">Contents</A></B> 
<!--End of Navigation Panel-->
<ADDRESS>
Build Daemon user
2011-10-18
</ADDRESS>
</BODY>
</HTML>