JUSTUS2/Software/Orca: Difference between revisions

From bwHPC Wiki
Jump to navigation Jump to search
 
(114 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Softwarepage|chem/orca}}
<!--{| align="right" {{Table|width=40%}} -->

{|{{Softwarebox}}
{| width=600px class="wikitable"
|-
|-
! Description !! Content
! colspan="2" style="text-align:center" | Name
|-
|-
| module load
| module load
| chem/orca/5.0.4
| category/name
<!-- Neben CIS auch bereits über Kategorien abgedeckt
|-
|-
| Availability
| Availability
| [[bwUniCluster]] &#124; [[JUSTUS2]]
| [[bwUniCluster]] [[bwForCluster ENM]], [[bwForCluster MLS/WISO]], [[bwForCluster Theochem]], [[bwForCluster BinAC]]
-->
|-
|-
| License
| License
| [https://orcaforum.kofo.mpg.de/app.php/privacypolicy/policy EULA]
| e.g. GPL
|-
|-
|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.
|
|-
|-
| Links
| Links
| [https://some.homepage.edu Homepage]; [https://some.other.page.edu Documentation]
| [https://orcaforum.kofo.mpg.de/app.php/portal Main ORCA Forum Portal] &#124; [https://www.kofo.mpg.de/970274/orca_manual_5_0_4.pdf Documentation]
|
|-
|-
| Graphical Interface
| Graphical Interface
| No
| No (Yes) <!-- Yes could link to some x11-forwarding/vnc instructions -->
|-
| Included in module
| <!-- mention if there is more than one software in the module, i.e. icc, ifort and debugger -->
|}
|}

== 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://www.kofo.mpg.de/970274/orca_manual_5_0_4.pdf Orca Manual 5.0.4]
[https://cis-hpc.uni-konstanz.de/prod.cis/?TS=1447847919&xAHILCAAAAAAAAAAAAAAAAADgezc_= Cluster Information System (CIS)]

{{#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>

== 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 ===
=== 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>

== Version-Specific Information ==
For information specific to a specific ORCA version, see the information available via the module system with the command
<pre>
$ module help category/softwarename
</pre>
<br>

----
[[Category:Chemistry software]][[Category:bwUniCluster]][[Category:bwForCluster_Chemistry]]

Latest revision as of 15:51, 29 February 2024

The main documentation is available via module help chem/orca on the cluster. Most software modules for applications provide working example batch scripts.


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


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


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.