{"id":3723,"date":"2017-03-24T15:12:11","date_gmt":"2017-03-24T15:12:11","guid":{"rendered":"http:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/?page_id=3723"},"modified":"2017-03-24T15:16:39","modified_gmt":"2017-03-24T15:16:39","slug":"qe","status":"publish","type":"page","link":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/software\/applications\/qe\/","title":{"rendered":"Quantum ESPRESSO"},"content":{"rendered":"

Overview<\/h2>\n

Qunatum ESPRESSO<\/a> (QE) is an integrated suite of Open-Source computer codes for electronic-structure calculations and materials modeling at the nanoscale. It is based on density-functional theory, plane waves, and pseudopotentials.<\/p>\n

Version 6.1 is installed on the CSF.<\/p>\n

Restrictions on use<\/h2>\n

There are no access restrictions on the CSF. The software is released under the GNU GPL<\/a>.<\/p>\n

You are requested to cite use of the software using the citation given in the online documentation<\/a>. <\/p>\n

Set up procedure<\/h2>\n

To access the software you must first load one<\/em> of the following modulefiles:<\/p>\n

\r\n# For serial and single-node MPI parallel jobs\r\nmodule load apps\/intel-15.0\/quantum-espresso\/6.1-mpi\r\n\r\n# For multi-node MPI parallel jobs\r\nmodule load apps\/intel-15.0\/quantum-espresso\/6.1-mpi-ib\r\n\r\n# For serial and single-node OpenMP parallel jobs\r\napps\/intel-15.0\/quantum-espresso\/6.1-omp\r\n<\/pre>\n
Note that quantum espresso MPI versions have been compiled with OpenMP. But the version of MPI on the CSF (OpenMPI) does not support multiple threads. So we automatically limit the OpenMP threads to 1 when using the MPI versions.<\/p>\n
Running the application<\/h2>\n
Please do not run QE on the login node. Jobs should be submitted to the compute nodes via batch.<\/p>\n
There are various executables provided by QE available for use. These are named app<\/em>.x<\/code> where app<\/em><\/code> is the name of the tool – for example bands.x<\/code> or pw.x<\/code>. These should be used in your jobscript as shown below.<\/p>\n
Serial batch job submission<\/h3>\n
Make sure you have the modulefile loaded then create a batch submission script, for example:<\/p>\n
\r\n#!\/bin\/bash\r\n#$ -S \/bin\/bash\r\n#$ -cwd             # Job will run from the current directory\r\n#$ -V               # Job will inherit current environment settings\r\n\r\napp<\/em>.x -inp myinput.in<\/em> > myinput<\/em>.out\r\n  #\r\n  # where app<\/em> is the name of your QE executable (e.g., bands.x)\r\n<\/pre>\n
Submit the jobscript using: <\/p>\n
qsub scriptname<\/em><\/pre>\n
where scriptname<\/em> is the name of your jobscript.<\/p>\n
Single-node MPI Parallel batch job submission<\/h3>\n
For a single-node (small) MPI parallel job use the smp.pe<\/code> parallel environment as shown.<\/p>\n
Make sure you have the correct modulefile loaded then create a batch submission script, for example:<\/p>\n
\r\n#!\/bin\/bash\r\n#$ -S \/bin\/bash\r\n#$ -cwd             # Job will run from the current directory\r\n#$ -V               # Job will inherit current environment settings\r\n#$ -pe smp.pe 24    # Number of cores (must be between 2 and 24)\r\n\r\n# $NSLOTS is automatically set to the number on the -pe line above\r\nmpirun -n $NSLOTS app<\/em>.x -inp myinput.in<\/em> > myinput<\/em>.out\r\n                    #\r\n                    # where app<\/em> is the name of your QE executable (e.g., bands.x)\r\n<\/pre>\n
Submit the jobscript using: <\/p>\n
qsub scriptname<\/em><\/pre>\n
where scriptname<\/em> is the name of your jobscript.<\/p>\n
Multi-node MPI Parallel batch job submission<\/h3>\n
For a multi-node (large) parallel job use the orte-24-ib.pe<\/code> parallel environment as shown.<\/p>\n
Make sure you have the correct modulefile loaded then create a batch submission script, for example:<\/p>\n
\r\n#!\/bin\/bash\r\n#$ -S \/bin\/bash\r\n#$ -cwd                    # Job will run from the current directory\r\n#$ -V                      # Job will inherit current environment settings\r\n#$ -pe orte-24-ib.pe 48    # Number of cores (must be at least 48 and a multiple of 24)\r\n\r\n# $NSLOTS is automatically set to the number on the -pe line above\r\nmpirun -n $NSLOTS app<\/em>.x -inp myinput.in<\/em> > myinput<\/em>.out\r\n                    #\r\n                    # where app<\/em> is the name of your QE executable (e.g., bands.x)\r\n<\/pre>\n
Submit the jobscript using: <\/p>\n
qsub scriptname<\/em><\/pre>\n
where scriptname<\/em> is the name of your jobscript.<\/p>\n
Single-node OpenMP Parallel batch job submission<\/h3>\n
For a single-node (small) OpenMP parallel job use the smp.pe<\/code> parallel environment as shown.<\/p>\n
Make sure you have the correct modulefile loaded then create a batch submission script, for example:<\/p>\n
\r\n#!\/bin\/bash\r\n#$ -S \/bin\/bash\r\n#$ -cwd             # Job will run from the current directory\r\n#$ -V               # Job will inherit current environment settings\r\n#$ -pe smp.pe 24    # Number of cores (must be between 2 and 24)\r\n\r\n# $NSLOTS is automatically set to the number on the -pe line above.\r\n# We must set OMP_NUM_THREADS to indicate how many CPU cores to use\r\nexport OMP_NUM_THREADS=$NSLOTS\r\napp<\/em>.x -inp myinput.in<\/em> > myinput<\/em>.out\r\n  #\r\n  # where app<\/em> is the name of your QE executable (e.g., bands.x)\r\n<\/pre>\n
Submit the jobscript using: <\/p>\n
qsub scriptname<\/em><\/pre>\n
where scriptname<\/em> is the name of your jobscript.<\/p>\n
Further info<\/h2>\n