Difference between revisions of "JUSTUS2/Software/Orca"
(→Versions and Availability) |
K Siegmund (talk | contribs) (→Miscellaneous Notes to Usage) |
||
| (100 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
| + | {{Softwarepage|chem/orca}} |
||
| − | <!--{| align="right" {{Table|width=50%}} --> |
||
| + | |||
| − | {|{{Softwarebox}} |
||
| + | {| width=600px class="wikitable" |
||
| − | {| align="left" {{Table|width=50%}} |
||
|- |
|- |
||
| + | ! Description !! Content |
||
| − | ! colspan="2" style="text-align:center" | Name |
||
|- |
|- |
||
| module load |
| module load |
||
| − | | chem/orca |
+ | | chem/orca/5.0.4 |
| − | <!-- Neben CIS auch bereits über Kategorien abgedeckt |
||
|- |
|- |
||
| Availability |
| Availability |
||
| + | | [[bwUniCluster]] | [[JUSTUS2]] |
||
| − | | [[bwUniCluster]] [[bwForCluster ENM]], [[bwForCluster MLS/WISO]], [[bwForCluster Theochem]], [[bwForCluster BinAC]] |
||
| − | --> |
||
|- |
|- |
||
| License |
| License |
||
| − | | [https://orcaforum. |
+ | | [https://orcaforum.kofo.mpg.de/app.php/privacypolicy/policy EULA] |
|- |
|- |
||
|Citing |
|Citing |
||
| + | | As described in the [https://www.kofo.mpg.de/970274/orca_manual_5_0_4.pdf manual]. Refer to Chapter 'Publications Related to ORCA' for guidance on citation. |
||
| − | | [https://orcaforum.cec.mpg.de/OrcaManual.pdf As described in the manual] |
||
|- |
|- |
||
| Links |
| Links |
||
| − | | [https://orcaforum. |
+ | | [https://orcaforum.kofo.mpg.de/app.php/portal Main ORCA Forum Portal] | [https://www.kofo.mpg.de/970274/orca_manual_5_0_4.pdf Documentation] |
| − | | |
||
|- |
|- |
||
| Graphical Interface |
| Graphical Interface |
||
| No |
| No |
||
| − | |- |
||
| − | | Included in module |
||
| − | | mpi/openmpi/1.8-gnu-4.8 mpi/openmpi/1.6.5-gnu-4.8 |
||
|} |
|} |
||
| − | |||
| − | == Description == |
||
| − | '''ORCA''' is a modern electronic structure program package. It is a flexible, efficient and easy-to-use general purpose tool for quantum chemistry with specific emphasis on spectroscopic properties of open-shell molecules. |
||
<br> |
<br> |
||
| + | = Description = |
||
| + | '''ORCA''' is a comprehensive, fully parallelized quantum chemistry package designed for advanced electronic structure methods. It encompasses density functional theory, many-body perturbation theory, coupled cluster methods, multireference methods, and semi-empirical quantum chemistry approaches. ORCA is capable of computing a wide range of molecular properties and serves as a fully integrated system for multi-level calculations, including QM/MM, ONIOM, and embedded crystals. |
||
| − | ORCA is able to carry out geometry optimizations and to predict a large number of spectroscopic parameters at different levels of theory. Besides the use of Hartee Fock theory, density functional theory (DFT) and semiempirical methods, high level ab initio quantum chemical methods, based on the configuration interaction and coupled cluster methods, are included into ORCA to an increasing degree. |
||
| + | Additionally, ORCA offers several advanced features to improve computational efficiency and accuracy. These include local correlation methods, starting with PNOs and expanded to DLPNO to reduce the computational cost of coupled cluster calculations. It also incorporates RIJCOSX for efficient handling of Hartree-Fock based methods. |
||
| − | Implemented Methods: |
||
| − | * Semiempirical INDO/S, MNDO, AM1, PM3, NDDO/1 |
||
| − | * Hartee Fock theory (RHF, UHF, ROHF and CASSCF) all in direct, semidirect, or conventional mode, different RI approximations |
||
| − | * DFT including a reasonably large number of exchange and correlation functionals including hybrid DFT and the most recent double hybrid functionals (see below). |
||
| − | * High level single reference correlation models: CCSD(T), QCISD(T), CEPA, CPF (with and without RI, Local) |
||
| − | * High level ab-initio individual selecting multireference methods (MRCI, MRMP2, MRMP3, MRMP4, MRACPF, MRAQCC, SORCI, DDCI) for ground- and excited-states. |
||
| − | * Geometry optimization in redundant internal coordinates using analytical gradient techniques for all SCF methods as well as MP2. |
||
| − | * Excited state calculations via TD-DFT and CI-singles (CIS). For CIS an analytic gradient is also available. The doubles correction is available for CIS(D) in an efficient implementation. |
||
| − | * Scalar relativistic ZORA, IORA and Douglas-Kroll-Hess (DKH) approaches, picture change effects, all-electron basis sets, effective core potentials |
||
| − | * The COSMO model is available throughout the package for continuum dielectric modeling of the environment. |
||
| − | * QM/MM interface to GROMACS |
||
| − | * Double hybrid functionals including a fraction of nonlocal correlation. Analytic gradients are also available (these methods were invented by the Grimme group). |
||
| − | * Van der Waals correct density functionals. |
||
| + | Furthermore, ORCA provides NEB-TS for studying reaction pathways and offers various methods for accurately calculating excited states, such as TD-DFT, EOM-CCSD, STEOM-CCSD, CASSCF with NEVPT2 or CASPT2, as well as molecular dynamics and multi-scale QM-MM models. |
||
| − | For more information on features please visit the ORCA-Portal [https://orcaforum.cec.mpg.de/ ''The ORCA Portal of the Max-Planck Institute''] web page. |
||
| + | Please refer to documentation provided by the ORCA developers in the first place for more detailed information, e.g.: |
||
| − | = Versions and Availability = |
||
| − | A list of versions currently available on the bwUniCluster and bwForCluster Chemistry can be obtained from the |
||
| − | [https://cis-hpc.uni-konstanz.de/prod.cis/?TS=1447847919&xAHILCAAAAAAAAAAAAAAAAADgezc_= Cluster Information System (CIS)] |
||
| + | [https://www.kofo.mpg.de/970274/orca_manual_5_0_4.pdf Orca Manual 5.0.4] |
||
| − | {{#widget:Iframe |
||
| − | |url=https://cis-hpc.uni-konstanz.de/prod.cis/bwUniCluster/chem/orca |
||
| − | |width=99% |
||
| − | |height=200 |
||
| − | |border=1 |
||
| − | }} |
||
<br> |
<br> |
||
| + | [https://wires.onlinelibrary.wiley.com/doi/full/10.1002/wcms.1606 Article Overview by Frank Nesse] |
||
<br> |
<br> |
||
| + | [https://wires.onlinelibrary.wiley.com/doi/10.1002/wcms.81 Article about main improvement in the version 5.0] |
||
| − | On the command line interface of any bwHPC cluster, a list of the available i versions using |
||
| − | <pre> |
||
| − | $ module avail chem/orca |
||
| − | </pre> |
||
<br> |
<br> |
||
| + | = Miscellaneous Notes to Usage = |
||
| − | == License == |
||
| + | * ORCA utilizes MPI parallelization, specifically backed by OpenMPI. When configuring parallel jobs in the Slurm sbatch script, use appropriate directives such as --nodes and --ntasks-per-node.<br>Avoid using the --cpus-per-task directive. All the ORCA modules load the appropriate OpenMPI module automatically. |
||
| − | |||
| + | * To ensure successful parallel runs, it is necessary to call ORCA with the full path, i.e. '$ORCA_BIN_DIR/orca <input_file>' |
||
| − | The ORCA license is considered as a "Research group" license. Thus anyone who directly associated with your research group is covered by the license and may share your copy of ORCA on all computer resources of your group. |
||
| + | * Due to potential large I/O operations, especially for post HF methods, it is advisable to place temporary files a local scratch directory.<br>To learn more about local disk space on [[JUSTUS2]], please refer to the [[JUSTUS2/Hardware#$SCRATCH and $TMPDIR|$SCRATCH and $TMPDIR]] section on the "JUSTUS2 Hardware" page. |
||
| − | |||
| + | * The most preferable way to load ORCA is with the specific version included, i.e., 'module load chem/orca/<version>'.<br>The default version, which may change over time, can be loaded simply with the command 'module load chem/orca'. |
||
| − | This license only applies to academic users. Commercial use of ORCA is prohibited under the terms of this license. |
||
| + | * The module includes the loading of all additional modules, especially an appropriate OpenMPI module in the case of ORCA, necessary for the proper functioning of the program, so there's no need to load additional modules separately. However, loading additional modules may be counterproductive. |
||
| − | |||
| − | [https://orcaforum.cec.mpg.de/license.html Complete ORCA Users License Agreement] |
||
<br> |
<br> |
||
| − | <br> |
||
| − | |||
| − | == Usage == |
||
| − | === Loading the module === |
||
| − | You can load the default version of ''ORCA'' with the command |
||
| − | <pre> |
||
| − | $ module load chem/orca |
||
| − | </pre> |
||
| − | |||
| − | The module will try to load modules it needs to function (e.g. compiler/intel). If loading the module fails, check if you have already loaded one of those modules, but not in the version needed for ''software name''. |
||
| − | If you wish to load a specific (older) version, you can do so using e.g. |
||
| − | ''$ module load chem/chem/'version''' to load the version you desires. |
||
| − | <pre> |
||
| − | $ module avail chem/orca |
||
| − | ------------------------ /opt/bwhpc/common/modulefiles ------------------------- |
||
| − | chem/orca/3.0.1 chem/orca/3.0.3 |
||
| − | $ module load chem/orca/3.0.1 |
||
| − | </pre> |
||
| − | <br> |
||
| − | |||
| − | === Program Binaries === |
||
| − | You can find the ORCA binaries in the main folder of the ORCA system. |
||
| − | After loading the ORCA module (''module load chem/orca/'version''') this path is also set to the local $PATH- and $ORCA_BIN_DIR environments. |
||
| − | |||
| − | <pre> |
||
| − | $ls -x $ORCA_BIN_DIR |
||
| − | bwhpc-examples manual modulefiles orca orca_2aim orca_2mkl |
||
| − | orca_anoint orca_anoint_mpi orca_asa orca_casscf orca_casscf_mpi orca_chelpg |
||
| − | orca_ciprep orca_cis orca_cis_mpi orca_cleanup orca_cleanup_mpi orca_cpcasscf |
||
| − | orca_cpscf orca_cpscf_mpi orca_eca orca_ecplib orca_eprnmr orca_eprnmr_mpi |
||
| − | orca_euler orca_fci orca_fitpes orca_gstep orca_gtoint orca_gtoint_mpi |
||
| − | orca_loc orca_mapspc orca_md orca_mdci orca_mdci_mpi orca_mergefrag |
||
| − | orca_mp2 orca_mp2_mpi orca_mrci orca_mrci_mpi orca_ndoint orca_numfreq |
||
| − | orca_pc orca_pc_mpi orca_plot orca_pltvib orca_pop orca_rel |
||
| − | orca_rocis orca_rocis_mpi orca_scf orca_scfgrad orca_scfgrad_mpi orca_scfhess |
||
| − | orca_scfhess_mpi orca_scf_mpi orca_soc orca_soc_mpi orca_vib orca_vpot |
||
| − | otool_cosmo otool_gcp otool_smd |
||
| − | $ |
||
| − | </pre> |
||
| − | Only the programs with the suffix '''*_mpi''' are compiled including OPENMPI functionality. |
||
| − | <br> |
||
| − | <br> |
||
| − | |||
| − | === Disk Usage === |
||
| − | Scratch files are written to the current directory by default. |
||
| − | Please change to a local directory or to '''your local workspace''' (preferred) before starting your calculations. |
||
| − | |||
| − | 'calc_repo' is an example name of a repository you created by using the command 'ws_allocate'. |
||
| − | |||
| − | <pre> |
||
| − | $ cd $(ws_find calc_repo) |
||
| − | kn_pop123456-calc_repo-0]$ pwd |
||
| − | /work/workspace/scratch/kn_pop123456-calc_repo-0 |
||
| − | kn_pop123456-calc_repo-0]$ |
||
| − | </pre> |
||
| − | <br> |
||
| − | |||
| − | == Examples == |
||
| − | You can copy a simple interactive example to your home directory and run it, using: |
||
| − | <pre> |
||
| − | $ cd $(ws_find calc_repo) |
||
| − | $ cp $ORCA_EXA_DIR/bwhpc-orca-example.moab . |
||
| − | $ cp bwhpc-orca-example.moab myorcajob.moab |
||
| − | § vi myorcajob.moab # do your own modifications |
||
| − | $ msub myorcajob.moab # start job submission |
||
| − | </pre> |
||
| − | <br> |
||
| − | |||
| − | == ORCA-Specific Environments == |
||
| − | To see a list of all ORCA environments set by the 'module load'-command use: |
||
| − | |||
| − | <pre> |
||
| − | $ module load chem/orca/3.0.3 |
||
| − | $ env | grep ORCA |
||
| − | ORCA_VERSION=3.0.3 |
||
| − | ORCA_MAN_DIR=/opt/bwhpc/common/chem/orca/3.0.3/manual |
||
| − | ORCA_EXA_DIR=/opt/bwhpc/common/chem/orca/3.0.3/bwhpc-examples |
||
| − | ORCA_BIN_DIR=/opt/bwhpc/common/chem/orca/3.0.3 |
||
| − | ORCA_HOME=/opt/bwhpc/common/chem/orca/3.0.3 |
||
| − | $ |
||
| − | </pre> |
||
| − | <br> |
||
| − | |||
| − | == Version-Specific Information == |
||
| − | For a more detailed information specific to a specific ORCA version, see the information available via the module system with the command |
||
| − | <pre> |
||
| − | $ module help chem/orca/'version' |
||
| − | </pre> |
||
| − | <br> |
||
| − | For a small abstract what ORCA is about use the command |
||
| − | <pre> |
||
| − | $ module whatis chem/orca/'version' |
||
| − | </pre> |
||
| − | <br> |
||
| − | |||
| − | Example |
||
| − | |||
| − | <pre> |
||
| − | $ module avail chem/orca |
||
| − | ------------------------------ /opt/bwhpc/common/modulefiles --------------------------------------- |
||
| − | chem/orca/3.0.1 chem/orca/3.0.3 |
||
| − | |||
| − | $ module whatis chem/orca/3.0.1 |
||
| − | chem/orca/3.0.1 : Quantum chemistry package ORCA, version 3.0.1 (command '/opt/bwhpc/common/chem/orca/3.0.1/orca') |
||
| − | |||
| − | $ module help chem/orca/3.0.1 |
||
| − | ----------- Module Specific Help for 'chem/orca/3.0.1' ------------ |
||
| − | |||
| − | This module provides the quantum chemistry package ORCA version 3.0.1 |
||
| − | via command '/opt/bwhpc/common/chem/orca/3.0.1/orca' |
||
| − | |||
| − | IMPORTANT: Read this license agreement: 'https://cec.mpg.de/forum/license.html' |
||
| − | if you plan to use it for research. |
||
| − | |||
| − | [...] |
||
| − | Documentation: |
||
| − | |||
| − | * Max-Planck-Institut fuer Chemische Energiekonversion |
||
| − | https://cec.mpg.de/forum/portal.php |
||
| − | |||
| − | * New features for version 3.0.1 |
||
| − | https://cec.mpg.de/forum/portal.php#a3 |
||
| − | |||
| − | * Manuals in pdf format: |
||
| − | /opt/bwhpc/common/chem/orca/3.0.1/manual |
||
| − | |||
| − | * Example data and a Moab example script can be found here: |
||
| − | /opt/bwhpc/common/chem/orca/3.0.1/bwhpc-examples |
||
| − | |||
| − | WARNING: Do not execute '/usr/bin/orca'! |
||
| − | This is _not_ our software! See: rpm -qi orca |
||
| − | |||
| − | [...] |
||
| − | |||
| − | $ |
||
| − | </pre> |
||
| − | ---- |
||
| − | [[Category:Chemistry software]][[Category:bwUniCluster]][[Category:bwForCluster_Chemistry]] |
||
Latest revision as of 15:51, 29 February 2024
|
The main documentation is available via |
| Description | Content |
|---|---|
| module load | chem/orca/5.0.4 |
| Availability | bwUniCluster | JUSTUS2 |
| License | EULA |
| Citing | As described in the manual. Refer to Chapter 'Publications Related to ORCA' for guidance on citation. |
| Links | Main ORCA Forum Portal | Documentation |
| Graphical Interface | No |
1 Description
ORCA is a comprehensive, fully parallelized quantum chemistry package designed for advanced electronic structure methods. It encompasses density functional theory, many-body perturbation theory, coupled cluster methods, multireference methods, and semi-empirical quantum chemistry approaches. ORCA is capable of computing a wide range of molecular properties and serves as a fully integrated system for multi-level calculations, including QM/MM, ONIOM, and embedded crystals.
Additionally, ORCA offers several advanced features to improve computational efficiency and accuracy. These include local correlation methods, starting with PNOs and expanded to DLPNO to reduce the computational cost of coupled cluster calculations. It also incorporates RIJCOSX for efficient handling of Hartree-Fock based methods.
Furthermore, ORCA provides NEB-TS for studying reaction pathways and offers various methods for accurately calculating excited states, such as TD-DFT, EOM-CCSD, STEOM-CCSD, CASSCF with NEVPT2 or CASPT2, as well as molecular dynamics and multi-scale QM-MM models.
Please refer to documentation provided by the ORCA developers in the first place for more detailed information, e.g.:
Orca Manual 5.0.4
Article Overview by Frank Nesse
Article about main improvement in the version 5.0
2 Miscellaneous Notes to Usage
- ORCA utilizes MPI parallelization, specifically backed by OpenMPI. When configuring parallel jobs in the Slurm sbatch script, use appropriate directives such as --nodes and --ntasks-per-node.
Avoid using the --cpus-per-task directive. All the ORCA modules load the appropriate OpenMPI module automatically. - To ensure successful parallel runs, it is necessary to call ORCA with the full path, i.e. '$ORCA_BIN_DIR/orca <input_file>'
- Due to potential large I/O operations, especially for post HF methods, it is advisable to place temporary files a local scratch directory.
To learn more about local disk space on JUSTUS2, please refer to the $SCRATCH and $TMPDIR section on the "JUSTUS2 Hardware" page. - The most preferable way to load ORCA is with the specific version included, i.e., 'module load chem/orca/<version>'.
The default version, which may change over time, can be loaded simply with the command 'module load chem/orca'. - The module includes the loading of all additional modules, especially an appropriate OpenMPI module in the case of ORCA, necessary for the proper functioning of the program, so there's no need to load additional modules separately. However, loading additional modules may be counterproductive.
