跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
其他技能

chem-dft-orca-optimization

Run DFT geometry optimization (minimization or TS search) on a molecular structure using ORCA via SCINE/ReaDuct wrapper.

learningmatter-mit · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add learningmatter-mit/AtomisticSkills --skill chem-dft-orca-optimization

技能说明


name: chem-dft-orca-optimization description: Run DFT geometry optimization (minimization or TS search) on a molecular structure using ORCA via SCINE/ReaDuct wrapper. category: [chemistry]

DFT Geometry Optimization with ORCA

Goal

Optimize the geometry of a molecular structure at the DFT level using the ORCA quantum chemistry program. Supports two modes: minimization (finding the nearest local minimum) and transition state (TS) optimization (single-ended saddle point search). The calculation uses the SCINE/ReaDuct wrapper for robust optimizer management.

[!IMPORTANT] This skill provides single-ended TS optimization only. For reaction pathway methods (NEB, IRC), consider using the MLIP-based NEB skill or IRC skill with MLIP pre-screening, then refine with DFT. For advanced ORCA features, use the advanced ORCA skill.

Background

Geometry optimization iteratively adjusts nuclear positions to minimize (or, for TS search, to find a first-order saddle point of) the potential energy surface $E(\mathbf{R})$. The SCINE/ReaDuct optimizer handles step control, coordinate transformations, and convergence criteria internally.

  • Minimization seeks a stationary point where $\nabla E = 0$ and the Hessian has all positive eigenvalues.
  • TS optimization seeks a first-order saddle point where $\nabla E = 0$ and the Hessian has exactly one negative eigenvalue.

1. Prerequisites

  • Conda environment: orca-agent with scine_utilities, scine_readuct, and ase installed
  • ORCA binary: The environment variable ORCA_BINARY_PATH must point to the ORCA executable
    export ORCA_BINARY_PATH=/path/to/orca
    
  • Input structure: A molecular structure file readable by ASE (.xyz, .cif, .mol, etc.)
  • For TS optimization: Provide a reasonable TS guess geometry. Poor initial guesses will likely fail to converge to the correct saddle point.

2. Parameters

ParameterDefaultDescription
--structure(required)Path to input structure file
--opt_typeminmin for minimization, ts for transition state search
--charge0Molecular charge
--spin_multiplicity1Spin multiplicity (2S+1)
--functionalPBEDFT functional (e.g. PBE, B3LYP, wB97X-V)
--basis_setdef2-SVPBasis set (e.g. def2-SVP, def2-TZVP)
--dispersionNoneDispersion correction (e.g. D3BJ, D4)
--solvationNoneImplicit solvation model: CPCM or SMD
--solventNoneSolvent name; required if --solvation is set
--special_optionNOSOSCFORCA special option passed to SCINE calculator. Set to empty string to disable.
--nprocs1Number of CPU cores for ORCA
--convergence_max_iterations200Maximum optimization steps
--calculate_final_hessianoffCompute Hessian at optimized geometry (for TS verification)
--calculator_settingsNoneExtra SCINE calculator settings as a JSON string (see below)
--optimizer_settingsNoneExtra ReaDuct optimizer kwargs as a JSON string (see below)
--output_dirautoOutput directory

3. Running an Optimization

Geometry minimization

# Env: orca-agent
python .agent/skills/chem-dft-orca-optimization/scripts/run_optimization.py \
    --structure molecule.xyz \
    --functional B3LYP \
    --basis_set def2-TZVP \
    --dispersion D3BJ \
    --nprocs 4 \
    --output_dir research/my_project/optimization

Transition state optimization

# Env: orca-agent
python .agent/skills/chem-dft-orca-optimization/scripts/run_optimization.py \
    --structure ts_guess.xyz \
    --opt_type ts \
    --functional B3LYP \
    --basis_set def2-TZVP \
    --dispersion D3BJ \
    --calculate_final_hessian \
    --nprocs 4 \
    --output_dir research/my_project/ts_optimization

With extra settings (calculator + optimizer)

For settings not exposed as dedicated flags, pass JSON strings. --calculator_settings applies to the SCINE/ORCA calculator, --optimizer_settings applies to the ReaDuct optimization task. SCINE is strict about types, so JSON ensures values are passed with the correct type (int, float, string).

# Env: orca-agent
python .agent/skills/chem-dft-orca-optimization/scripts/run_optimization.py \
    --structure molecule.xyz \
    --functional B3LYP \
    --basis_set def2-TZVP \
    --calculator_settings '{"max_scf_iterations": 128}' \
    --optimizer_settings '{"convergence_delta_value": 1e-6}' \
    --output_dir research/my_project/opt_custom

With implicit solvation

# Env: orca-agent
python .agent/skills/chem-dft-orca-optimization/scripts/run_optimization.py \
    --structure molecule.xyz \
    --functional PBE0 \
    --basis_set def2-TZVP \
    --solvation SMD \
    --solvent water \
    --nprocs 4 \
    --output_dir research/my_project/opt_solvated

4. Output Files

  • optimization_results.json: Structured results containing:
    • converged: Boolean indicating whether the optimization converged
    • final_energy_hartree, final_energy_eV: Final electronic energy
    • final_max_force_eV_per_Ang, final_rms_force_eV_per_Ang: Residual force information
    • opt_type: Whether this was a minimization or TS search
    • If --calculate_final_hessian was used: hessian_eV_per_Ang2, hessian_wave_numbers_cm-1, and n_imaginary_modes
    • All input parameters for reproducibility
  • initial_structure.xyz: Copy of the input structure
  • optimized_structure.xyz: The optimized geometry

5. Interpreting Results

Minimization

  • Check converged: true in the results JSON.
  • Residual forces should be small (max force < 0.01 eV/A for typical convergence).
  • If convergence fails, try increasing --convergence_max_iterations or improving the in
阅读完整来源 ↗