Fix links

parent a37be742
......@@ -25,6 +25,7 @@ MANIFEST
N.LDA
*.gpw
*.npy
theme.css
# If you run the tests, these may write out files
*.gpw
......
......@@ -116,7 +116,7 @@ ASE interface
=============
The code has been designed to work together with the atomic
simulation environment (:ase:`ASE <>`). ASE provides:
simulation environment (ASE_). ASE provides:
* Structure optimization.
* Molecular dynamics.
......@@ -130,7 +130,7 @@ Open Software
=============
GPAW is released under the `GNU Public License <http://xkcd.com/225>`_
version 3 or any later version. See the file :trac:`COPYING` which
version 3 or any later version. See the file :git:`COPYING` which
accompanies the downloaded files, or see the license at GNU's web
server at http://www.gnu.org/licenses/. Everybody is invited to
participate in using and :ref:`developing the code <devel>`.
......
......@@ -18,7 +18,7 @@ default_role = 'math'
pygments_style = 'sphinx'
autoclass_content = 'both'
imodindex_common_prefix = ['gpaw.']
ntersphinx_mapping = {
intersphinx_mapping = {
'ase': ('http://wiki.fysik.dtu.dk/ase', None),
'numpy': ('http://docs.scipy.org/doc/numpy', None),
'mayavi': ('http://docs.enthought.com/mayavi/mayavi', None)}
......
......@@ -18,11 +18,13 @@ The mailing lists below are of interest for active GPAW developers only:
* gpaw-developers_
* gpaw-svncheckins_
.. _gpaw-developers: https://listserv.fysik.dtu.dk/mailman/listinfo/
gpaw-developers
.. _gpaw-svncheckins: https://listserv.fysik.dtu.dk/mailman/listinfo/
gpaw-svncheckins
.. _gpaw-users: https://listserv.fysik.dtu.dk/mailman/listinfo/gpaw-users
You should consider also subscribing to the ASE :ref:`ase:mail lists`.
For topics before Oct 20 2009 browse gridpaw-developer_.
The list is inactive and serves as an archive only.
Note that you can search the mailing list archives: click on the
mailing list above, then choose the archive, and search from that page.
.. _irc:
......@@ -33,7 +35,19 @@ Internet Relay Chat
We have the IRC channel ``#gpaw`` on FreeNode. Please join us if you
have any questions. For easy access, you can use this webclient_.
.. _webclient: http://webchat.freenode.net/?randomnick=0&channels=gpaw
Note: While IRC is much more interactive than e-mail, there are not as
many people as on the mailing list, and those present are not
continually reading it. Therefore if you don't receive an answer
quickly you can either send an e-mail instead, or simply stay online
till the day after. This is particularly true if you ask your
question at 04:00 at night (in Europe) and/or during the weekend.
Finally, to save time, state your complete question immediately
instead of asking whether someone might be able to answer a question
related to some topic.
Logs from the IRC channel:
* irc-logs_
GitLab
......@@ -41,3 +55,14 @@ GitLab
Feel free to create Merge Requests and Issues on our GitLab page:
https://gitlab.com/gpaw/gpaw
.. _webclient: http://webchat.freenode.net/?randomnick=0&channels=gpaw
.. _irc-logs: http://dcwww.fys.dtu.dk/~jensj/gpaw-stuff
.. _gpaw-developers: https://listserv.fysik.dtu.dk/mailman/listinfo/
gpaw-developers
.. _gpaw-svncheckins: https://listserv.fysik.dtu.dk/mailman/listinfo/
gpaw-svncheckins
.. _gpaw-users: https://listserv.fysik.dtu.dk/mailman/listinfo/gpaw-users
.. _gridpaw-developer: http://listserv.fysik.dtu.dk/mailman/listinfo/
gridpaw-developer
......@@ -30,7 +30,7 @@ and "N/A" denotes an optimization failure.
Only the systems that fail to converge or converge to a
total energy above the threshold are given in the tables.
Calculator used: GPAW mode='lcao' (see :svn:`~doc/devel/ase_optimize/g2_dzp.py`)
Calculator used: GPAW mode='lcao' (see :git:`~doc/devel/ase_optimize/g2_dzp.py`)
Limit of optimizer steps: 100
......@@ -48,7 +48,7 @@ The PBE optimization starts from LDA unit cells.
Description of plots and tables: see the section above.
Calculator used: GPAW mode=PW() (see :svn:`~doc/devel/ase_optimize/htb_pw.py`)
Calculator used: GPAW mode=PW() (see :git:`~doc/devel/ase_optimize/htb_pw.py`)
Limit of optimizer steps: 50
......
......@@ -515,7 +515,7 @@ potential and 2 full SCF steps.
All the stages are timed separately, due to their different scaling.
**Note** that the size of the system can be changed easily by modifying
just one variable in :svn:`~doc/devel/256H2O/b256H2O.py`::
just one variable in :git:`~doc/devel/256H2O/b256H2O.py`::
r = [2, 2, 2]
......@@ -670,7 +670,7 @@ potential and 2 full SCF steps.
All the stages are timed separately, due to their different scaling.
**Note** that the size of the system can be changed easily by modifying
just one variable in :svn:`~doc/devel/Au_cluster/Au_cluster.py`::
just one variable in :git:`~doc/devel/Au_cluster/Au_cluster.py`::
r = [1, 1, 1]
......
......@@ -7,7 +7,8 @@ Coding Conventions
Python Coding Conventions
=========================
Follow :ase:`ASE's rules <development/python_codingstandard.html>`.
Follow ASE's :ref:`ase:coding conventions`.
C-code
======
......
......@@ -20,17 +20,17 @@ This object is the central object for a GPAW calculation::
^ / +-----------+
| ---- +---------------+
| / ---->|InputParameters|
+-----+ +-----+ / +---------------+
|Atoms|<-------------| PAW |-----
+-----+ +-----+ \
+-----+ +-----+ / +---------------+
|Atoms|<-------------| PAW |-----
+-----+ +-----+ \
/ | \ \ +-----------+
+-------------+ / | --- ----------->|Occupations|
|WaveFunctions|<-- v \ +-----------+
+-------------+ +-------+ \ +-------+
|Density| -->|SCFLoop|
+-------------+ +-------+ \ +-------+
|Density| -->|SCFLoop|
+-------+ +-------+
The implementation is in :svn:`gpaw/paw.py`. The
The implementation is in :git:`gpaw/paw.py`. The
:class:`~gpaw.paw.PAW` class doesn't do any part of the actual
calculation - it only handles the logic of parsing the input
parameters and setting up the necessary objects for doing the actual
......@@ -47,12 +47,10 @@ A PAW instance has the following attributes: ``atoms``,
GPAW
====
The :class:`~gpaw.aseinterface.GPAW` class
(:svn:`gpaw/aseinterface.py`), which implements the :ase:`ASE calculator
interface <ase/calculators/calculators.html#calculator-interface>`,
inherits from the PAW class, and does unit conversion between GPAW's
internal atomic units (`\hbar=e=m=1`) and :ase:`ASE's units <ase/units.html>`
(Angstrom and eV)::
The :class:`~gpaw.aseinterface.GPAW` class (:git:`gpaw/aseinterface.py`),
which implements the ASE :ref:`ase:calculator interface`, inherits from the
PAW class, and does unit conversion between GPAW's internal atomic units
(`\hbar=e=m=1`) and ASE's :mod:`~ase.units` (Angstrom and eV)::
gpaw | ase
......@@ -172,10 +170,10 @@ objects.
|BasisFunctions| | +-------+ | +----------+
+--------------+ | |Overlap| | |Projectors|
v +-------+ | +----------+
+------------------+ v
|TwoCenterIntegrals| +---------------------+
+------------------+ |KineticEnergyOperator|
+---------------------+
+------------------+ v
|TwoCenterIntegrals| +---------------------+
+------------------+ |KineticEnergyOperator|
+---------------------+
Attributes of the wave function object: ``gd``, ``nspins``,
``nbands``, ``mynbands``, ``dtype``, ``world``,
......@@ -316,7 +314,7 @@ Naming convention for arrays
A few examples:
=========== =================== ===========================================
name shape
name shape
=========== =================== ===========================================
``spos_c`` ``(3,)`` **S**\ caled **pos**\ ition vector
``nt_sG`` ``(2, 24, 24, 24)`` Pseudo-density array
......@@ -334,21 +332,21 @@ Commonly used indices:
======= ==================================================
``a`` Atom number
``c`` Unit cell axis-index (0, 1, 2)
``v`` *xyz*-index (0, 1, 2)
``v`` *xyz*-index (0, 1, 2)
``k`` **k**-point index
``q`` **k**-point index (local, i.e. it starts at 0 on each processor)
``s`` Spin index (:math:`\sigma`)
``s`` Spin index (:math:`\sigma`)
``u`` Combined spin and **k**-point index (local)
``G`` Three indices into the coarse 3D grid
``g`` Three indices into the fine 3D grid
``G`` Three indices into the coarse 3D grid
``g`` Three indices into the fine 3D grid
``M`` LCAO orbital index (:math:`\mu`)
``n`` Principal quantum number *or* band number
``n`` Principal quantum number *or* band number
``l`` Angular momentum quantum number (s, p, d, ...)
``m`` Magnetic quantum number (0, 1, ..., 2*l - 1)
``L`` ``l`` and ``m`` (``L = l**2 + m``)
``j`` Valence orbital number (``n`` and ``l``)
``i`` Valence orbital number (``n``, ``l`` and ``m``)
``q`` ``j1`` and ``j2`` pair
``m`` Magnetic quantum number (0, 1, ..., 2*l - 1)
``L`` ``l`` and ``m`` (``L = l**2 + m``)
``j`` Valence orbital number (``n`` and ``l``)
``i`` Valence orbital number (``n``, ``l`` and ``m``)
``q`` ``j1`` and ``j2`` pair
``p`` ``i1`` and ``i2`` pair
``r`` CPU-rank
======= ==================================================
......@@ -392,14 +390,14 @@ When using parallelization over spins, **k**-points, bands and domains,
four different :ref:`MPI communicators <communicators>` are used:
* *mpi.world*
Communicator containing all processors.
Communicator containing all processors.
* *domain_comm*
One *domain_comm* communicator contains the whole real space
One *domain_comm* communicator contains the whole real space
domain for a selection of the spin/k-point pairs and bands.
* *kpt_comm*
One *kpt_comm* communicator contains all k-points and spin
* *kpt_comm*
One *kpt_comm* communicator contains all k-points and spin
for a selection of bands over part of the real space domain.
* *band_comm*
* *band_comm*
One *band_comm* communicator contains all bands for a selection
of k-points and spins over part of the real space domain.
......@@ -412,7 +410,7 @@ a *domain_comm* rank of zero signifies that the processor is first in
the group, hence it functions as a domain master.
For an example on how to use an MPI communicator to perform simple
data communication, please refer to :svn:`~doc/devel/parallelization.py`.
data communication, please refer to :git:`~doc/devel/parallelization.py`.
To investigate the way GPAW distributes calculated quantities across the
various MPI groups, simulating an MPI run can be done using ``gpaw-mpisim``::
......@@ -446,7 +444,7 @@ various MPI groups, simulating an MPI run can be done using ``gpaw-mpisim``::
For the case of a :math:`\Gamma`-point calculation without band-parallelization,
all parallel communication is done in the one *domain_comm* communicator,
all parallel communication is done in the one *domain_comm* communicator,
which in this case is equal to *mpi.world*.
.. [1] J J. Mortensen and L. B. Hansen and K. W. Jacobsen,
......
......@@ -21,4 +21,4 @@ Presently and in the future we will expand on this work by considering:
* self-interaction correction methods, e.g., +U, non-Koopman corrections, etc.
Most of the GPAW code related to this project is in
:svn:`~gpaw/gpaw/xc/bee.py` and :svn:`~gpaw/c/ensemble_gga.c`.
:git:`~gpaw/gpaw/xc/bee.py` and :svn:`~gpaw/c/ensemble_gga.c`.
......@@ -6,10 +6,10 @@ Hybrid functionals
Currently we have two implementation of exact exchange:
1) :svn:`~gpaw/xc/hybrid.py`: Can handle Gamma-point only
1) :git:`~gpaw/xc/hybrid.py`: Can handle Gamma-point only
calculations self-consistently (for molecules and large cells).
2) :svn:`~gpaw/xc/hybridk.py`: Can handle k-points, but not
2) :git:`~gpaw/xc/hybridk.py`: Can handle k-points, but not
self-consitently.
Things to work on:
......
......@@ -12,5 +12,5 @@ old collection of PAW setups we will focus on:
* faster convergence of energy with number of grid-points - if possible
* tesing the setups more carfully against a bigger set of all-electron results
The code is in :svn:`~gpaw/gpaw/atom/generator2.py` and it is based on
a new and more robust atomic solver: :svn:`~gpaw/gpaw/atom/aeatom.py`.
The code is in :git:`~gpaw/gpaw/atom/generator2.py` and it is based on
a new and more robust atomic solver: :git:`~gpaw/gpaw/atom/aeatom.py`.
......@@ -52,7 +52,7 @@ Splitting the integral in radial and angular parts, we get:
where `G_{\ell m,\ell'm'}^{\ell''m''}` are Gaunt coefficents and the
last angular integral has been calculated as ``Y_LLv`` in the
:svn:`~gpaw/gaunt.py` module.
:git:`~gpaw/gaunt.py` module.
More stuff
......
......@@ -85,7 +85,7 @@ Important setup problems to fix
* Improve Ru setup. Problem with nitrogen adsorption energy on
Ru(0001) surface: Improved f-scattering, do we need 4p semi-core
states? This problem has been fixed in the 0.9 release of the
setups and covered by the following test :svn:`~gpaw/test/big/Ru001`.
setups and covered by the following test :git:`~gpaw/test/big/Ru001`.
* Improve Mn setup. Problem with strange states in the band-gap for
AFM-II MnO.
* Fine-tune Fourier filtering of projector functions. There is still
......
......@@ -122,7 +122,7 @@ chemisorbed on transition metals. In such cases the
traditional Delta Self-Consistent Field breaks down since the orbital
to be occupied is no longer well described by a single Kohn-Sham state.
The script :svn:`~doc/documentation/dscf/homo.py` calculates
The script :git:`~doc/documentation/dscf/homo.py` calculates
the HOMO energy of CO adsorbed on-top Pt(111). The script starts
from scratch, but usually one would start from an optimized configuration
saved in a file ``gs.gpw``. The script only calculates the total energy of
......@@ -134,7 +134,7 @@ HOMO pseudo-wavefunctions and the projector overlaps are saved. The
energy range [-100.0, 0.0] means we only include states below the Fermi
level (default is states above).
The script :svn:`~doc/documentation/dscf/lumo.py` calculates
The script :git:`~doc/documentation/dscf/lumo.py` calculates
the LUMO energy of the same system, but is slightly more complicated due to
the degeneracy of the `2\pi` orbital. We would like to occupy the `2\pi_y`
orbital and we need to figure out which band (5 or 6) this orbital
......
......@@ -23,4 +23,4 @@ Examples
Your own potential
------------------
See an example here: :svn:`gpaw/test/harmonic.py`.
See an example here: :git:`gpaw/test/harmonic.py`.
......@@ -5,13 +5,13 @@ Manual
======
GPAW calculations are controlled through scripts written in the
programming language Python_. GPAW relies on the :ase:`Atomic
Simulation Environment <>` (ASE), which is a Python package that helps
programming language Python_. GPAW relies on the `Atomic
Simulation Environment <ASE>`_ (ASE), which is a Python package that helps
us describe our atoms. The ASE package also
handles molecular dynamics, analysis, visualization, geometry
optimization and more. If you don't know anything about ASE, then it
might be a good idea to familiarize yourself with it before continuing
(at least read the :ase:`ASE introduction <intro.html>`).
(at least read the :ref:`ase:about` section).
Below, there will be Python code examples starting with ``>>>`` (and
``...`` for continuation lines). It is a good idea to start the
......@@ -19,10 +19,11 @@ Python interpreter and try some of the examples below.
.. _Python: http://www.python.org
The units used by the GPAW calculator correspond to the :ase:`ASE
conventions <ase/units.html>`, most importantly electron volts and
The units used by the GPAW calculator correspond to the :mod:`ASE
conventions <ase.units>`, most importantly electron volts and
angstroms.
-----------------------
Doing a PAW calculation
-----------------------
......
......@@ -71,7 +71,7 @@ system.
Submit tool on Niflheim
-----------------------
At CAMd, we use this submit tool: :svn:`~doc/documentation/parallel_runs/gpaw-qsub`.
At CAMd, we use this submit tool: :git:`~doc/documentation/parallel_runs/gpaw-qsub`.
Examples::
......
......@@ -102,7 +102,7 @@ calculated by
The example below calculates the density of states for CO adsorbed on
a Pt(111) slab and the density of states projected onto the gas phase
orbitals of CO. The ``.gpw`` files can be generated with the script
:svn:`~doc/documentation/pdos/top.py`
:git:`~doc/documentation/pdos/top.py`
PDOS script::
......
......@@ -24,7 +24,7 @@ and "N/A" denotes a convergence failure.
Only the systems that fail to converge or converge to a
total energy above the threshold are given in the tables.
Calculator used: GPAW mode='fd' (see :svn:`gpaw/test/big/scf/g2_1_pbe0_fd.py`)
Calculator used: GPAW mode='fd' (see :git:`gpaw/test/big/scf/g2_1_pbe0_fd.py`)
.. image:: scf_g2_1_pbe0_fd_calculator_steps.png
......@@ -45,7 +45,7 @@ The runs marked with "initial cg iter N" perform N ``eigensolver=cg``
iterations before switching to the selected eigensolver.
Those initial iterations are included in the final reported number.
Calculator used: GPAW mode=PW() (see :svn:`gpaw/test/big/scf/dcdft_pbe_pw.py`)
Calculator used: GPAW mode=PW() (see :git:`gpaw/test/big/scf/dcdft_pbe_pw.py`)
.. image:: scf_dcdft_pbe_pw_calculator_steps.png
......
......@@ -21,7 +21,7 @@ The current implementation *lacks* the following features:
* Speed.
Inclusion of Fock exchange is exceedingly slow. The bottleneck is solving the poisson integrals of the Fock operator, which is currently done using an iterative real-space solver with a zero initial guess for the potential at each SCF cycle. This should be optimized.
One way to speed up an exact-exchange (or hybrid) calculation is to use the coarse grid (used for wave functions) instead of the finegrid (used for for densities) for the Fock potentials. This should give a speed-up factor of 8. This can be specified in the ``xc`` keyword like in this example :svn:`~gpaw/test/exx_coarse.py`
One way to speed up an exact-exchange (or hybrid) calculation is to use the coarse grid (used for wave functions) instead of the finegrid (used for for densities) for the Fock potentials. This should give a speed-up factor of 8. This can be specified in the ``xc`` keyword like in this example :git:`~gpaw/test/exx_coarse.py`
Parallelization using domain decomposition is fully supported.
......
......@@ -42,7 +42,7 @@ plane-waves used. You can conveniently monitor some variables by using the
$ grep iter Al-fcc.txt
you see the progress of the iteration cycles including convergence of
wave functions, density and total energy. If the ``txt`` keyword is omitted
wave functions, density and total energy. If the ``txt`` keyword is omitted
the log output will be printed directly in the terminal.
.. highlight:: python
......@@ -104,13 +104,12 @@ bulk Aluminum.
Then choose :menuselection:`Tools --> Bulk Modulus`.
Another alternative is to use the :ase:`Equation of state module
<ase/utils.html#equation-of-state>` (see this :ase:`tutorial
<tutorials/eos/eos.html>`).
Another alternative is to use the :mod:`Equation of state module
<ase.utils.eos>` (see this :ref:`tutorial <ase:eos>`).
* Compare your results to the experimental values `a_0` = 4.05 Å and `B`
= 76 GPa. Mind the units when you calculate the bulk modulus (read
about ASE-units :ase:`here <ase/units.html>`).
about ASE-units :mod:`here <ase.units>`).
What are the possible error sources?
.. note::
......
......@@ -6,8 +6,7 @@ Diffusion of gold atom on Al(100) surface
In this ASE-tutorial:
* :ase:`Diffusion of gold atom on Al(100) surface
<tutorials/constraints/diffusion.html>`
* :ref:`ase:constraints diffusion tutorial`
the energy barrier for diffusion of a gold atom on an Al(100) surface
......
......@@ -2,7 +2,7 @@
Density of states
=================
Take a look at the :svn:`~doc/exercises/dos/dos.py` program and try to
Take a look at the :git:`~doc/exercises/dos/dos.py` program and try to
get a rough idea of what it can do for you. Use it to plot the
density of states (DOS) for the three Fe configurations from the
:ref:`iron_exercise` exercise (on the *x*-axis you have the energy
......@@ -40,5 +40,5 @@ demonstrates how to construct the PDOS of Fe.
We will get a feel for the local density of states by plotting the
PDOS for the ferro-magnetic Fe crystal. Look at
:svn:`~doc/exercises/dos/pdos.py`. Use it to plot the s, p,
:git:`~doc/exercises/dos/pdos.py`. Use it to plot the s, p,
and d-states on one of the Fe atoms.
......@@ -11,12 +11,12 @@ Exercises
exercises.
In order to do the exercises, it helps with a little bit of knowledge
of :ase:`ASE <>` and Python_. Here are some useful resources:
of ASE_ and Python_. Here are some useful resources:
* Some :ref:`faeq`.
* The Python_ homepage.
* The :ase:`ASE <>` homepage.
* ASE's :ase:`introduction to Python <python.html>`.
* The ASE_ homepage.
* ASE's :ref:`ase:what is python` section.
.. _Python: http://www.python.org
......@@ -24,6 +24,7 @@ The exercises are used in the course `Electronic structure methods
in materials physics, chemistry and biology
<http://www.kurser.dtu.dk/10302.aspx>`_.
Introductory exercises
======================
Do these first...
......@@ -35,6 +36,7 @@ Do these first...
water/water
wavefunctions/wavefunctions
Intermediate exercises
======================
......@@ -45,6 +47,7 @@ Intermediate exercises
surface/surface
diffusion/diffusion
Advanced exercises
==================
......
......@@ -10,12 +10,12 @@ tools.
We will use GPAW to simulate an STM image. Start by doing an Al(100)
surface with hydrogen adsorbed in the ontop site:
:svn:`~doc/exercises/stm/HAl100.py`. This will produce a
:git:`~doc/exercises/stm/HAl100.py`. This will produce a
:file:`gpw` file containing the wave functions that are needed for
calculating local density of states.
The STM image can be calculated with the
:svn:`~doc/exercises/stm/stm.py` script::
:git:`~doc/exercises/stm/stm.py` script::
$ python stm.py HAl100.gpw
......
......@@ -102,7 +102,7 @@ Octopus
Octopus_ is installed on the 'q' opteron nodes on Niflheim. The way to
run jobs is the following: Create inp file in the working directory as
described in the tutorial_, and then run
:svn:`~doc/exercises/octopus_run.py`. To use various octopus utilities such
:git:`~doc/exercises/octopus_run.py`. To use various octopus utilities such
as ``oct-cross-section`` and ``oct-broad`` you need to do::
source /usr/local/openmpi-1.2.5-pathf90/bin/mpivars-1.2.5.sh
......
......@@ -28,8 +28,7 @@ whereas (110) is most open. Here we'll focus on (100).
s = fcc100('Al', (1, 1, 5))
view(s, repeat=(4, 4, 1))
Read more about the :func:`~ase.lattice.surface.fcc100` function
:ase:`here <ase/lattice.html>`.
Read more here: :func:`ase.lattice.surface.fcc100`.
* Answer the same questions for the (111) surface.
......@@ -62,11 +61,11 @@ the cohesive energy per bulk atom. For Aluminium we have `E_{coh}` = 3.34 eV.
.. math:: \sigma = \frac{NE_{N-1} - (N-1)E_N}{2A}
* The script :svn:`~doc/exercises/surface/Al100.py` defines
* The script :git:`~doc/exercises/surface/Al100.py` defines
an ``energy()`` function for calculating `E_N`. Use it to calculate
`\sigma` for `N` = 5. Use a two-dimensional Monkhorst-Pack
**k**-point sampling (``kpts=(k, k, 1)``) that matches the size of
your unit cell.
your unit cell.
.. hint::
......@@ -84,7 +83,7 @@ the cohesive energy per bulk atom. For Aluminium we have `E_{coh}` = 3.34 eV.
* How well is the EMT estimate satisfied?
.. note:: The experimental value of `\sigma` is 54 meV/Å\ :sup:`2`.
.. note:: The experimental value of `\sigma` is 54 meV/Å\ :sup:`2`.
However, this was obtained from the curvature of an aluminium drop and
is more likely to represent the value for a closepacked Al(111) surface.
......@@ -92,8 +91,8 @@ the cohesive energy per bulk atom. For Aluminium we have `E_{coh}` = 3.34 eV.
Work function
=============
Run the :svn:`~doc/exercises/surface/work_function.py`
Run the :git:`~doc/exercises/surface/work_function.py`
script and estimate the work function for a Al(100) surface (this
script does not run in parallel). A typical
experimental value for the work function of the Al(100) surface is
4.20 eV.
4.20 eV.
......@@ -10,22 +10,22 @@ Wannier functions. We have cheated a little bit and prepared a file
for bulk silicon and a Benzene molecule so that you only have to
concentrate on the wannier analysis of the molecules.
Start by running :svn:`~doc/exercises/wannier/si.py` and
Start by running :git:`~doc/exercises/wannier/si.py` and
make sure you agree with the way the diamond structure is set up. The
resulting :file:`.gpw` file is used as input to
:svn:`~doc/exercises/wannier/wannier-si.py` which
:git:`~doc/exercises/wannier/wannier-si.py` which
transforms the Kohn-Sham orbitals to maximally localized wannier
functions and plot the atoms along with the centers of the wannier
functions. Note that the wannier centers are treated as "X" atoms
which are plotted as small red spheres. How many covalent bonds do
you expect in a unit cell with 8 tetravalent Silicon atoms?
The script :svn:`~doc/exercises/wannier/benzene.py`
The script :git:`~doc/exercises/wannier/benzene.py`
produces a :file:`.gpw` that can be used as input to create wannier
functions. Convince yourself that the chosen number of bands matches
the number of occupied orbitals in the molecule. How many covalent
bonds do you expect in Benzene? Look at
:svn:`~doc/exercises/wannier/wannier-benzene.py` and figure
:git:`~doc/exercises/wannier/wannier-benzene.py` and figure
out what it does. Run it and look at the graphical representation.
Note in particular the alternating single/double bonds between the
carbon atoms. What happens if also you include one or two unoccupied
......
from ase.utils.sphinx import mol_role
from ase.utils.sphinx import git_role_tmpl
from ase.utils.sphinx import git_role_tmpl, epydoc_role_tmpl
from ase.utils.sphinx import create_png_files
......@@ -9,7 +9,14 @@ def git_role(role, rawtext, text, lineno, inliner, options={}, content=[]):
rawtext, text, lineno, inliner, options, content)
def epydoc_role(role, rawtext, text, lineno, inliner, options={}, content=[]):
return epydoc_role_tmpl('gpaw', 'http://wiki.fysik.dtu.dk/gpaw/epydoc/',
role,
rawtext, text, lineno, inliner, options, content)
def setup(app):
app.add_role('mol', mol_role)
app.add_role('git', git_role)
app.add_role('epydoc', epydoc_role)
create_png_files()
......@@ -27,8 +27,7 @@ and the major GPAW review:
__ http://stacks.iop.org/0953-8984/22/253202
together with :ase:`ASE <>` citation
(see :ase:`Citation: how should I cite ASE?<faq.html>`).
together with ASE_ citation (see :ref:`ase:cite`).
If you are using the time-dependent DFT part of the code, please cite also:
......@@ -70,7 +69,7 @@ If you use the :ref:`continuum_solvent_model`, please cite also:
__ http://dx.doi.org/10.1063/1.4900838
BibTex (:svn:`doc/GPAW.bib`):
BibTex (:git:`doc/GPAW.bib`):
.. literalinclude:: GPAW.bib
......@@ -130,12 +129,12 @@ How to switch between several GPAW versions
===========================================
For each GPAW installation use a separate, modified submit tool:
:svn:`~doc/documentation/parallel_runs/gpaw-qsub`.
:git:`~doc/documentation/parallel_runs/gpaw-qsub`.
Assuming that your :ref:`developer_installation` is under
:file:`~/gpaw.test`, and the :command:`gpaw-python` under
:file:`~/gpaw.test/build/bin.linux-x86_64-2.3/`, modify the submit
tool: :svn:`~doc/documentation/parallel_runs/gpaw-qsub`:
tool: :git:`~doc/documentation/parallel_runs/gpaw-qsub`:
* set the :envvar:`PYTHONPATH` and :envvar:`PATH` passed to :command:`mpirun`::
......@@ -149,7 +148,7 @@ tool: :svn:`~doc/documentation/parallel_runs/gpaw-qsub`:
os.system('%s gpaw-python JOB' % (mpirun))
Alternatively, instead of modifying
:svn:`~doc/documentation/parallel_runs/gpaw-qsub`
:git:`~doc/documentation/parallel_runs/gpaw-qsub`
create a bash function - see :ref:`Niflheim` for details.
Tests fail!
......
......@@ -47,6 +47,8 @@ Quick links to all features:
News
====
* :ref:`GPAW version 1.0 <releasenotes>` released (Mar 18 2016)
* :ref:`GPAW version 0.11 <releasenotes>` released (Jul 22 2015)
* :ref:`GPAW version 0.10 <releasenotes>` released (Apr 8 2014)
......@@ -143,14 +145,14 @@ News
algorithms
install
setups/setups
platforms/platforms
documentation/documentation
tutorials/tutorials
exercises/exercises
documentation/documentation
devel/benchmarks
setups/setups
releasenotes
contact
faq
mailinglists
devel/devel
bugs
\ No newline at end of file
devel/benchmarks
bugs
......@@ -12,7 +12,6 @@ Requirements
Optional:
* For extra functionality: SciPy_ (library for scientific computing)
* For :mod:`ase.gui`: PyGTK_ (GTK+ for Python) and Matplotlib_ (2D Plotting)
.. _Python: http://www.python.org/
......@@ -22,15 +21,13 @@ Optional:
.. _pygtk: http://www.pygtk.org/
3) Atomic Simulation Environment (:ase:`ASE <>`).
GPAW requires ASE. :ase:`Install ASE <download.html>`.
3) Atomic Simulation Environment (ASE_).
4) C compiler - preferably gcc.
5) Libxc version 2.0.1 or newer (libxc-download_).
6) BLAS and LAPACK libraries. Start with your system provided defaults or
e.g. acml_ or openblas_. Multithreading is not supported.
6) BLAS and LAPACK libraries.
7) SciPy_ 0.7.0 or newer
......@@ -95,7 +92,7 @@ Tar-file
--------
You can get the source as a tar-file for the
latest stable release (gpaw-3.9.1.4567.tar.gz_) or the latest
latest stable release (gpaw-1.0.0.tar.gz_) or the latest
development snapshot (`<snapshot.tar.gz>`_).
Unpack and make a soft link::
......@@ -103,8 +100,8 @@ Unpack and make a soft link::
$ tar -xf python-gpaw-3.9.1.4567.tar.gz
$ ln -s python-gpaw-3.9.1.4567 gpaw
.. _python-gpaw-3.9.1.4567.tar.gz:
https://wiki.fysik.dtu.dk/gpaw-files/python-gpaw-3.9.1.4567.tar.gz
.. _gpaw-1.0.0.tar.gz:
https://pypi.python.org/packages/source/g/gpaw/gpaw-1.0.0.tar.gz
Git clone
......@@ -125,7 +122,7 @@ folder is).
.. note::