Skip to main content

A library for analyzing potential energy surfaces (PESs) and using the resulting PES descriptors for constructing forcefield parameters.

Project description

https://github.com/nlesc-nano/auto-FOX/workflows/Tests/badge.svg https://readthedocs.org/projects/auto-fox/badge/?version=latest https://codecov.io/gh/nlesc-nano/auto-FOX/branch/master/graph/badge.svg?token=7IgHsRDVdo https://zenodo.org/badge/DOI/10.5281/zenodo.3988142.svg

https://img.shields.io/badge/python-3.7-blue.svg https://img.shields.io/badge/python-3.8-blue.svg https://img.shields.io/badge/python-3.9-blue.svg

Automated Forcefield Optimization Extension 0.10.0

Auto-FOX is a library for analyzing potential energy surfaces (PESs) and using the resulting PES descriptors for constructing forcefield parameters. Further details are provided in the documentation.

Currently implemented

This package is a work in progress; the following functionalities are currently implemented:

  • The MultiMolecule class, a class designed for handling and processing potential energy surfaces. (1)

  • A multi-XYZ reader. (2)

  • A radial and angular distribution generator (RDF & ADF). (3)

  • A root mean squared displacement generator (RMSD). (4)

  • A root mean squared fluctuation generator (RMSF). (5)

  • Tools for describing shell structures in, e.g., nanocrystals or dissolved solutes. (6)

  • A Monte Carlo forcefield parameter optimizer. (7)

Using Auto-FOX

  • An input file with some basic examples is provided in the FOX.examples directory.

  • An example MD trajectory of a CdSe quantum dot is included in the FOX.data directory.

    • The absolute path + filename of aforementioned trajectory can be retrieved as following:

>>> from FOX import example_xyz
  • Further examples and more detailed descriptions are available in the documentation.

Installation

Anaconda environments

  • While not a strictly required, it stronly recomended to use the virtual environments of Anaconda.

  • Anaconda comes with a built-in installer; more detailed installation instructions are available for a wide range of OSs.

  • Anaconda environments can be created, enabled and disabled by, respectively, typing:

    • Create environment: conda create -n FOX -c conda-forge python pip

    • Enable environment: conda activate FOX

    • Disable environment: conda deactivate

Installing Auto-FOX

  • If using Conda, enable the environment: conda activate FOX

  • Install Auto-FOX with PyPi: pip install auto-FOX --upgrade

  • Congratulations, Auto-FOX is now installed and ready for use!

Optional dependencies

  • The plotting of data produced by Auto-FOX requires Matplotlib. Matplotlib is distributed by both PyPi and Anaconda:

    • Anaconda: conda install --name FOX -y -c conda-forge matplotlib

    • PyPi: pip install matplotlib

  • Construction of the angular distribution function in parallel requires DASK.

    • Anaconda: conda install -name FOX -y -c conda-forge dask

  • RDKit is required for a number of .psf-related recipes.

    • Anaconda: conda install -name FOX -y -c conda-forge rdkit

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

Auto-FOX-0.10.0.tar.gz (164.2 kB view details)

Uploaded Source

Built Distribution

Auto_FOX-0.10.0-py3-none-any.whl (24.1 MB view details)

Uploaded Python 3

File details

Details for the file Auto-FOX-0.10.0.tar.gz.

File metadata

  • Download URL: Auto-FOX-0.10.0.tar.gz
  • Upload date:
  • Size: 164.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for Auto-FOX-0.10.0.tar.gz
Algorithm Hash digest
SHA256 fd18e86143ccd692d7552240777a1eda8d41739e9a6082023ad0e73106da670c
MD5 c757e030e9c7b864530707f553fedb07
BLAKE2b-256 6d0b8ac3ea1918c8a31e502547d2f43531409305f34959f43b0cfbb3e2df75d6

See more details on using hashes here.

File details

Details for the file Auto_FOX-0.10.0-py3-none-any.whl.

File metadata

  • Download URL: Auto_FOX-0.10.0-py3-none-any.whl
  • Upload date:
  • Size: 24.1 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for Auto_FOX-0.10.0-py3-none-any.whl
Algorithm Hash digest
SHA256 18778575edc97e4a342d7fcb6a476c37fddd5aa889c22404731b2546363a03a6
MD5 30d4256e4eea265f7dbb91c2684322aa
BLAKE2b-256 6e20d2c3599e862c6f63bb8ec6562ab2ad292ac6fff6832fb5671a0d50b0a218

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