Skip to main content

Atomic and Molecular Cluster Energy Surface Sampler

Project description



Atomic and Molecular Cluster Energy Surface Sampler (AMCESS)

Exploration of the Potential Energy Surface (PES) of molecular or atomic clusters is a crucial step in analyzing physical–chemistry properties and processes. The Atomic and Molecular Energy Surface Sampler (AMCESS) is an end-to-end package implemented in Python 3.9 to generate candidate structures for the critical points sampling of the PES. The amcess main purpose is to be a user-friendly package, easy to install, import, and run, available on most platforms and open-source. As a Python module, amcess can be integrated into any workflow. This package has code reviews with unit testing and continuous integration, code coverage tools, and automatically keeps documentation up–to–date.


Molecular cluster of ibuprofen and six water molecules [doi: 10.1063/1.4874258]

Description

The amcess package uses simple input files and automates common procedures to explore the PES using the Simulated Annealing, Simplicial Homology Global Optimization (SHGO), and Bayesian Optimization to generate candidate structures for any kind of critical points, such as local minima or transition states. The package also allows the user to perform local searches around defined regions. The PES is generated by computing the electronic energy using standard and powerful quantum chemistry packages such as PySCF and Psi4, also implemented in Python.

Read more about the project in the documentation.

Technical Documentation

Technical documents behind this project can be accessed here.

Requirements

First, you should install the required Python packages

  attrs>=23.2.0
  scipy>=1.12.0
  numpy==1.23.1
  pyscf>=2.5.0
  h5py>=3.1.0
  pyberny>=0.6.3
  geomeTRIC>=0.9.7.2
  GPyOpt>=1.2.6
  pyDOE>=0.3.8
  matplotlib>=3.8.3
  matplotlib-inline>=0.1.6

To use Jupyter Notebook

  py3Dmol>=2.0.4
  notebook>=6.5.6
  notebook_shim>=0.2.4
  jupyter>=1.0.0
  ipykernel>=6.29.3
  rise>=5.7.1

check the file requirements.txt. For developers, you should install requirements_dev.txt.

Installation

AMCESS is a Python 3.9 package

  1. Install virtual environment:

    python -m venv <VirtualEnvName>

  2. Activate virtual environment:

    source <VirtualEnvName>/bin/activate`

  3. Install the packages:

    1. after cloning this repository

      pip install .

    2. or directly from PyPI

      pip install amcess

  4. Run AMCESS (check some examples below). Additionally, you can install requirements.txt to use Jupyter notebooks.

For developers,

  1. install dependencies:

    pip install -r requirements.txt -r requirements_dev.txt

  2. Run all test:

    tox

Usage

A detailed workflow is provided in the workflow directory. It has a list of Jupyter notebooks with detailed examples of AMCESS tools and capabilities.

Workflow (Binder):

  1. Getting started with atoms and molecules properties.
    • 01_importing_atoms_and_molecules.ipynb
  2. Translating and rotating atoms and molecules.
    • 02_move_rotate_molecules.ipynb
  3. Moving Molecules randomly from a Cluster.
    • 03_move_rotate_cluster.ipynb
  4. Freezing any molecule and redefining its sphere center.
    • 04_freeze_molecule_redefine_center.ipynb
  5. Initialize a cluster avoiding atomic overlapping
    • 05_initialize_cluster_and_move_molecule.ipynb

Roadmap

Some of the ideas to keep growing are:

  • Integration with RDKit (multiple format input)
  • Results: geometrical analysis (clustering, k-nearest, k-means, etc.)

Contributing

The easiest way to get help with the project is to join the #amcess channel on Discord.

We hang out there and you can get real-time help with your projects.

License

GNU General Public License v3 (GLPv3)

Authors and Acknowledgment

Main authors: Alejandra Mendez, Juan Jose Aucar, Daniel Bajac, César Ibargüen, Andy Zapata, Edison Florez (edisonffh@mail.com)

Project Status

Under development


ASCEC (FORTRAN 77 version)

A previous version of AMCESS, called ASCEC [1] (Spanish acronym Annealing Simulado con Energía Cuántica) was written in FORTRAN77 and was successfully used in a wide range of research and academic applications. From atomic cluster to molecular cluster, the ASCEC package has produced novel results (structure never seen before) published in the literature. Read more on ASCEC publications.

You could check the directory ASCECV3

ASCECV3/
|---papers/
|---p_ascec/
|---examples/
      |---adf
      |---dalton
      |---g03
      |---gamess
      |---nwchem

References

[1] J Pérez and A Restrepo. Ascec v–02: annealing simulado con energía cuántica. Property, development and implementation: Grupo de Química–Física Teórica, Instituto de Química, Universidad de Antioquia: Medellín, Colombia, 2008.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

amcess2024-0.1.2a20.tar.gz (40.2 kB view details)

Uploaded Source

Built Distribution

amcess2024-0.1.2a20-py3-none-any.whl (37.8 kB view details)

Uploaded Python 3

File details

Details for the file amcess2024-0.1.2a20.tar.gz.

File metadata

  • Download URL: amcess2024-0.1.2a20.tar.gz
  • Upload date:
  • Size: 40.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.10.12

File hashes

Hashes for amcess2024-0.1.2a20.tar.gz
Algorithm Hash digest
SHA256 9b815f39c0eef92c422630dcda11791d23a1e401c32af9818609ca505872597b
MD5 0517b14b75d6e665c4c70662da3d7464
BLAKE2b-256 baa15c2bdb8e4733a1f048b326fd0e45c02817397fbd12019449b93112f2ebe1

See more details on using hashes here.

File details

Details for the file amcess2024-0.1.2a20-py3-none-any.whl.

File metadata

File hashes

Hashes for amcess2024-0.1.2a20-py3-none-any.whl
Algorithm Hash digest
SHA256 576d05ca9a541c67a24bbd634c539ea81305e7b7e476b02a653ad77c5d4829c8
MD5 4ced17a71976fa8ffd7e7446da994f3f
BLAKE2b-256 8f4b548c8e6187ca63f292dd72e1152c4e75448bc87321c061d099dd6cfad24a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page