chem-dft-orca-advanced-calculation
Write and run custom ORCA input files for advanced electronic structure methods or settings not available through the SCINE wrapper, including multi-reference methods, excited states, relativistic effects, advanced SCF, NMR/EPR, and more.
learningmatter-mit · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add learningmatter-mit/AtomisticSkills --skill chem-dft-orca-advanced-calculation技能说明
name: chem-dft-orca-advanced-calculation description: Write and run custom ORCA input files for advanced electronic structure methods or settings not available through the SCINE wrapper, including multi-reference methods, excited states, relativistic effects, advanced SCF, NMR/EPR, and more. category: [chemistry]
Advanced ORCA Calculation
Goal
Enable advanced ORCA quantum chemistry calculations by constructing a custom ORCA input file from scratch. This skill covers methods and features not available through the SCINE wrapper, including multi-reference methods, excited states, relativistic effects, advanced SCF settings, NMR/EPR properties, and more.
[!IMPORTANT] For standard DFT single-point calculations (energy, gradients, Hessian), use the singlepoint skill instead. For geometry optimization, use the optimization skill. This skill is for cases where those wrappers do not expose the needed method or settings.
1. Prerequisites
- Conda environment:
orca-agentwithaseinstalled (SCINE not required for this skill) - ORCA binary: The environment variable
ORCA_BINARY_PATHmust point to the ORCA executableexport ORCA_BINARY_PATH=/path/to/orca - ORCA documentation: Consult the ORCA 6.1 tutorials for method-specific input syntax, keyword blocks, and recommended settings
2. Workflow
Step 1: Understand the user's request
Identify the target method, property, and system. Determine which ORCA keywords and blocks are needed. If unsure, consult the tutorials linked above for the specific method.
Step 2: Write the ORCA input file
Create a .inp file following ORCA input syntax. Every input file should include:
Mandatory elements:
- A keyword line starting with
!specifying the method, basis set, and job type - A
*xyzfileentry referencesing an external .xyz file
Strongly recommended elements:
%pal nprocs N end: parallelization (always set this to avoid single-core runs)%maxcore M: memory per core in MB (e.g. 4000 for 4 GB per core)
Example — TD-DFT excited states:
! B3LYP def2-TZVP TightSCF
%pal nprocs 4 end
%maxcore 4000
%tddft
NRoots 10
MaxDim 5
end
* xyzfile 0 1 molecule.xyz
Example: DLPNO-CCSD(T) single point:
! DLPNO-CCSD(T) def2-TZVPP def2-TZVPP/C TightSCF
%pal nprocs 8 end
%maxcore 4000
* xyzfile 0 1 molecule.xyz
Example: Geometry optimization with frequency calculation:
! B3LYP def2-TZVP D3BJ Opt Freq TightSCF
%pal nprocs 4 end
%maxcore 4000
* xyzfile 0 1 molecule.xyz
Example: CASSCF multi-reference:
! CASSCF def2-TZVP
%pal nprocs 4 end
%maxcore 8000
%casscf
nel 6
norb 6
nroots 3
end
* xyzfile 0 1 molecule.xyz
[!TIP] When using an external
.xyzfile with* xyzfile charge mult filename.xyz, the.xyzfile must be placed in the same directory where ORCA runs (the--output_dir).
Step 3: Run the calculation
# Env: orca-agent
python .agent/skills/chem-dft-orca-advanced-calculation/scripts/run_orca_input.py \
--input_file calculation.inp \
--output_dir research/my_project/advanced_calc
The script will:
- Validate basic input structure and warn about missing
%pal/%maxcore - Copy the input file to the output directory
- Execute ORCA and capture all output
- Parse the final electronic energy from the output
- Save a
calculation_results.jsonsummary
Step 4: Parse results
For standard energies, the runner script already extracts the final energy. For other properties, use the dedicated parser:
# Env: orca-agent
python .agent/skills/chem-dft-orca-advanced-calculation/scripts/parse_orca_output.py \
--output_file research/my_project/advanced_calc/calculation.out \
--property energy orbitals
Available --property options in the parser:
energy: Final energy, nuclear repulsion, dispersion correctionorbitals: Orbital energies, HOMO/LUMO, gapfrequencies: Vibrational frequencies, imaginary modes, IR intensitiesthermochemistry: ZPE, enthalpy, Gibbs energy, entropyall: Parse everything available
Step 5: Manual output inspection
For properties not covered by the built-in parser (excited-state energies, NMR shifts, spin populations, natural orbitals, etc.), read the ORCA calculation.property.txt file directly.
3. Common Use Cases
| Method | Key ORCA Keywords | Notes |
|---|---|---|
| Multi-step SCF convergence | ! GuessMode=CMatrix | Some SCFs are difficult to converge, solving it multiple steps, converging first on a small basis set and loose criterion and launching it again with the desired parameters |
| TD-DFT excited states | ! B3LYP def2-TZVP, %tddft NRoots N end | Use TDA for faster approximation |
| CASSCF/NEVPT2 | ! CASSCF def2-TZVP, %casscf nel N norb M end | Active space selection is critical |
| DFT + NMR | ! B3LYP def2-TZVP NMR | Shielding tensors in output |