Skip to content
/ pele Public
forked from pele-python/pele

Python energy landscape explorer

License

Unknown, GPL-3.0 licenses found

Licenses found

Unknown
LICENSE
GPL-3.0
COPYING
Notifications You must be signed in to change notification settings

farrelljd/pele

 
 

Repository files navigation

pele : Python Energy Landscape Explorer

Tools for global optimization and energy landscape exploration.

Source code: https://github.com/pele-python/pele

Documentation: http://pele-python.github.io/pele/

./images/lj38_gmin_dgraph.png

Images: The global minimum energy structure of a 38 atom Lennard-Jones cluster. On the right is a disconnectivity graph showing a visualization of the energy landscape. The competing low energy basins are shown in color.

pele is a python partial-rewriting of GMIN, OPTIM, and PATHSAMPLE: fortran programs written by David Wales of Cambridge University and collaborators (http://www-wales.ch.cam.ac.uk/software.html).

Description

pele has tools for energy minimization, global optimization, saddle point (transition state) search, data analysis, visualization and much more. Some of the algorithms implemented are:

  1. Basinhopping global optimization
  2. LBFGS minimization (plus other minimizers)
  3. Single ended saddle point search:
    • Hybrid Eigenvector Following
    • Dimer method
  1. Double ended saddle point search
    • Nudged Elastic Band (NEB)
    • Doubly Nudged Elastic Band (DNEB)
  2. Disconnectivity Graph visualization
  3. Structure alignment algorithms
  4. Thermodynamics (e.g. heat capacity) via the Harmonic Superposition Approximation
  5. Transition rates analysis

Installation

The tried and tested method is to install via conda and pip. In this directory:

conda env create -f environment.yml
conda activate pele
pip install . --no-build-isolation

Alternatively, you can install with pip directly:

pip install .

(requires a c++ and FORTRAN compiler to be on the path).

Testing

To make tests available, replace . with .[testing], e.g.:

pip install .[testing]

and then, outside of this source tree, run:

nosetests pele

We also have tests for our c++ code writen in pure c++. These are stored in the folder cpp_tests/ and can be compiled using CMake. These tests have not been tested recently.

Running

You can find examples of how to run pele in the examples folder. More information can be found in the documentation at

http://pele-python.github.com/pele/

Notes

In the long-long-ago, pele was known as pygmin.

About

Python energy landscape explorer

Resources

License

Unknown, GPL-3.0 licenses found

Licenses found

Unknown
LICENSE
GPL-3.0
COPYING

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 66.9%
  • C++ 18.7%
  • Fortran 4.8%
  • Cython 4.3%
  • C 3.7%
  • Meson 1.3%
  • Other 0.3%