obminimize(1)

obminimize1

Optimize the geometry, minimize the energy for a molecule

Usage

obminimize [OPTIONS] filename

Overview

The obminimize tool can be used to minimize the energy for molecules inside (multi-)molecule files (e.g., MOL2, etc.)

Options

If no filename is given, obminimize will give all options including the available forcefields.

-c criteria

Set convergence criteria (default=1e-6)

-cg

Use conjugate gradients algorithm (default)

-sd

Use steepest descent algorithm

-newton

Use Newton2Num linesearch (default=Simple)

-ff forcefield

Select the forcefield

-o format

Select the output file format

-h

Add hydrogen atoms

-n steps

Specify the maximum number of steps (default=2500)

-cut

Use cut-off (default=don't use cut-off)

-rvdw rvdw

Specify the VDW cut-off distance (default=6.0)

-rele rele

Specify the Electrostatic cut-off distance (default=10.0)

-pf freq

Specify the frequency to update the non-bonded pairs (default=10)

Examples

View the possible options, including available forcefields:

obminimize

Minimize the energy for the molecule(s) in file test.mol2:

obminimize test.mol2

Minimize the energy for the molecule(s) in file test.mol2 using the Ghemical forcefield:

obminimize -ff Ghemical test.mol2

Minimize the energy for the molecule(s) in file test.mol2 by taking at most 300 geometry optimization steps

obminimize -n 300 test.mol2

Minimize the energy for the molecule(s) in file test.mol2 using the steepest descent algorithm and convergence criteria 1e-5:

obminimize -sd -c 1e-5 test.mol2

Releases

10 releases since Debian 5.0 (Lenny); the text changed 3 times.

  1. 5.0
  2. 6.0–10
  3. 11–13
  4. Arch

-cut since Arch Linux 2026-11-01; -h since Arch Linux 2026-11-01; -newton since Arch Linux 2026-11-01; -o since Arch Linux 2026-11-01; -pf since Arch Linux 2026-11-01; -rele since Arch Linux 2026-11-01; -rvdw since Arch Linux 2026-11-01.

Authors

The minimize program was contributed by Tim Vandermeersch.

Open Babel is developed by a cast of many, including current maintainers Geoff Hutchison, Chris Morley, Michael Banck, and innumerable others who have contributed fixes and additions. For more contributors to Open Babel, see <https://openbabel.org/docs/Introduction/thanks.html>

From openbabel 3.2.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's mdoc source.