Docs are under construction. Content may be incomplete or change.

Molecule Tutorial: Optimize Water and Run Vibrations

Page type: Tutorial
On this page

You will optimize a water molecule, verify that the result is a minimum rather than an arbitrary geometry, and run a molecular vibration calculation on the relaxed structure. The final artifacts include the optimization trajectory, frequencies, modes, and IR/Raman spectra.

Water IR spectrum with the bending and O–H stretching region

Before you start

RequirementWhat to expect
ExperienceComplete the ethanol tutorial or know how to start a calculation
TimeAbout 10–20 minutes including first GFN2 download
CalculatorGFN2+D4 for both stages
Starting structureWater from the bundled Library
Success criteriaOptimization converged; no large imaginary molecular mode

Using one calculator for optimization and vibration keeps the stationary point and its curvature on the same potential-energy surface.

Step 1: Load water

Action. Open File → Library, type water into the search box, choose Insert on the Water entry, and click the viewport to place the molecule.

Library panel before searching: the unfiltered list of all 24 bundled entries (CsCl, Graphite, Carbon, Hexagonal BN, 2H MoS2, BaTiO3 Perovskite, and more) with an empty, unfocused search box showing only its example hint text. Type "water" into the search box to filter down to the Water entry.

Expected state. The active tab contains one oxygen and two hydrogens in a bent geometry.

Checkpoint. Confirm the formula and atom count before calculating. A malformed or duplicated structure will produce a real calculation of the wrong system.

Step 2: Optimize the structure

Action. Switch to Calc, choose Optimization, set Level of theory to GFN2-xTB, and leave Dispersion on Default - D4. Keep the cell fixed, use the default optimizer for a sensible Library geometry, and start the run.

Optimization setup with GFN2+D4 selected

Expected state. A new optimization folder appears in Explorer with log.txt, result.json, an energy trace, and a trajectory. The active structure updates to the final geometry when the run completes.

Checkpoint. Open the final result and confirm converged: true. Inspect the trajectory if energy or geometry changes unexpectedly. A water minimum should remain bent, with O–H distances around 1 Å; exact values depend on the method and settings.

Step 3: Verify the minimum

Optimization only finds a stationary geometry under its convergence rule. Before treating the geometry as a minimum:

  1. Confirm the calculation did not merely exhaust its step budget.
  2. Confirm the final maximum force satisfies the requested threshold.
  3. Use the final structure, not the initial Library geometry, for the next stage.

If you changed tabs during the run, open the final trajectory frame or optimized structure as the active structure before continuing.

Step 4: Calculate vibrations

Action. Choose Vibration. Confirm GFN2-xTB and Default - D4 are selected, keep a 0.01 Å displacement and two-point finite differences for this tutorial, and request frequencies plus IR and Raman outputs.

Vibration setup with frequencies, IR, and Raman enabled

Expected state. The calculation folder contains frequency/mode data and spectrum artifacts such as vibrations.json, vibrations.traj, ir_spectrum.json, and raman_spectrum.json.

Checkpoint. Open the IR spectrum. The three internal modes should consist of a lower-frequency H–O–H bend and two higher-frequency O–H stretches. Translation/rotation modes can appear near zero because of finite-difference noise.

Check your result

CheckPass conditionIf it fails
Optimizationconverged: true and force target metIncrease steps, improve geometry, or adjust optimizer
Structure transferVibration input is the optimized geometryReopen the final optimization structure
Mode countThree chemically meaningful internal modesVerify atom count and artifact
StabilityNo large imaginary internal modeTighten optimization and repeat vibration
OrderingBend below the two O–H stretchesVerify units, calculator, and plotted artifact

A small near-zero negative mode can be numerical translation/rotation noise. A large imaginary internal mode indicates the structure is not a minimum on this model surface.

Common problems

SymptomLikely causeFix
Many large imaginary modesVibration used an unrelaxed or malformed structureOptimize and verify the active final geometry
GFN2 fields are absentAn MLIP remained selectedChoose GFN2+D4 in both dialogs
Frequencies differ from a referenceModel, geometry, stencil, or scaling differsCompare like-for-like settings and state the method
Spectrum appears dominated by zeroTranslation/rotation noise is included in the plot rangeFocus on the three internal modes
Result folder is redCalculation failed or was canceledRead the end of log.txt before using artifacts

For periodic relaxation, phonons, and electronic DOS, continue with Crystal Tutorial: Silicon. The convergence theory behind this calculation is documented in Geometry Optimization.