The program package Wien2k performs electronic structure calculations of solids using density functional theory (DFT). It is based on the full-potential (linearized) augmented plane-waves ((L)APW) + local orbitals (lo) method, one among the most accurate schemes for band structure calculations. Wien2k is an all-electron scheme including relativistic effects. Wien2k was developed at the Institute for Materials Chemistry at the Technical University, Vienna and is available on LRZ platforms with both serial and parallel versions.
Leibniz Supercomputing Centre has licensed Wien2k under an installation and maintenance agreement; under this agreement, usage of the software is only allowed for licensed users of Wien2k.
Before using Wienn2k on the LRZ HPC systems, the following steps must be performed:
The user applies by contacting LRZ HPC support, providing the following information: name, affiliation (working group), Wien2k license number and the user account(s) under which you access the LRZ systems.
LRZ checks back with the Wien2k team whether the license information is valid.
Upon positive feedback, access to the software is given by LRZ.
Setup and access for Wien2k
The module package controls access to the software. Please load the appropriate module environment first after login to the system, in order to use the latest Wien2k version 11.1 or include the line in your script:
module load wien2k
To see where the Wien2k executables reside (such as the bin directory) and what environment variables are added to the PATH, type
module show wien2k
Follow the instruction in chapter "Quick start" in the usersguide to set up correctly your calculation. The registered user site provides further useful information.
Running Wien2k at LRZ
You can run Wien2k on the LRZ platforms using a script driven job and you can perform small test runs using an interactive shell. Sample scripts for the different platforms are provided below which you can modify according to your needs. Here you can find further scripts. Note that for parallel execution you need a ".machines" file in your working directory and to set the "-p" switch. Fine grained MPI parallel version of the programs lapw0, lapw1, and lapw2 are available.
A ".machines" file template is provided by Wien2k and is accessible here:
If the ".machines" file does not exist, or if the "-p" switch is omitted, the serial versions of the programs are executed.
Linux-Cluster (SLURM): MPP2 and MPP3
Start an interactive shell with:
salloc -N 1
module load wien2k
loads the Wien2k environment
Now modify your ".machines" file and start your calculation, e.g. with:
run_lapw -p -NI
Sample job script files for Linux-Cluster and SuperMUC
Linux-Cluster or SuperMUC-NG (SLURM)
#!/bin/bash #SBATCH -o /home/cluster/group/userID/mydir/job%j.out #SBATCH -D /home/cluster/group/userID/mydir/ #SBATCH -J jobname #SBATCH --time=01:00:00 #SBATCH --ntasks=32 #SBATCH --get-user-env #SBATCH --clusters=mpp1 %ice1 for ICE, uv1 for UV
Then submit the job script using sbatch (SLURM) or llsubmit (loadLeveler) commands.
Job control using SLURM
For more information concerning job submission using SLURM, see also here.
Check status of submitted jobs of user:
squeue -u user-ID
Job control using LoadLeveler
For more information concerning job submission using LoadLeveler, see also here.
Check status of submitted jobs of user
llq -u user-ID
Cancel submitted job
The Wien2k Users Manual is particularly useful.
The Wien2k Textbooks website has a detailed description of the electronic structure methods available in Wien2k, and a set of technical notes.
For trouble shooting the keyword search in the Wien2k mailing list is very helpful.
If you have any questions or problems with Wien2k on the different LRZ platforms, please don't hesitate to contact LRZ HPC support staff .