alchemlyb

Estimate free energy from molecular simulation results using TI, MBAR, or BAR.

API/CLI tool ID: alchemlyb

Understanding inputs and outputs

Uses dhdl.xvg files already produced by GROMACS simulations to estimate the free-energy difference (ΔG) between two states. Free energy accounts for both energy and the number of possible states. Interpret the result together with the definition and order of the states being compared.

BAR compares neighboring state pairs; MBAR uses energy data from multiple states together. TI integrates the energy derivative along a parameter that changes the state. This input accepts 2–32 GROMACS files with the same temperature and column layout, one per sampled state.

dg_error is the estimator’s statistical error. It is not the total error, including how well the simulation represents the experiment. A missing error value must not be read as zero.

Input settings

SettingFormatRequiredDefaultDescription and constraints
dataFilesfileRequired—2-32 GROMACS dhdl.xvg files (upload uncompressed, one file per state, at least two sampled states), all at one temperature with the same columns. NAMD and AMBER formats are not supported — Extensions xvg, JSON array
estimatordropdownOptional"mbar"Free-energy estimator — Allowed values mbar · bar · ti
temperatureKnumberOptional—Temperature used for estimation (K). If omitted, the temperature in the file subtitle is used; if given, it must equal the file temperature — Minimum 1, Maximum 1000

Output metrics

ColumnDisplay nameRangeUnitDescription
dgΔG—kcal/molEstimated free-energy difference: a computed estimate relative to the defined states and ligands, not an experimental value
dg_errorΔG error—kcal/molStatistical error reported by the estimator. Blank for state pairs BAR doesn't provide.

See Reading results for metric definitions and interpretation. A range shows possible values; whether higher or lower is better depends on the metric.

Execution availability

Open an execution plan in your project to see available tool versions and costs. Review and approve the inputs, settings, and terms before running.

License

Code, model weights, and accompanying data have their own terms. The table summarizes terms from official sources; check your execution plan for the configuration you will use. License texts are available in Third-party notices.

ComponentLicenseCommercial useSourceNotes
CodeBSD-3-ClauseAllowed, subject to notice requirementsLicense text—

Checked on 2026-10-26.

References

On this page