Atomistic Manipulation Toolkit
Project description
Atomistic Manipulation Toolkit
AtomMan: the Atomistic Manipulation Toolkit is a Python library for creating, representing, manipulating, and analyzing large-scale atomic systems of atoms. The focus of the package is to facilitate the rapid design and development of simulations that are fully documented and easily adaptable to new potentials, configurations, etc. The code has no requirements that limit which systems it can be used on, i.e. it should work on Linux, Mac and Windows computers.
Features:
Allows for efficient and fast calculations on millions of atoms, each with many freely defined per-atom properties.
Create dislocation monopoles and evaluate them with differential displacement and Nye tensor plots.
Generate point defects.
Call LAMMPS directly from Python and instantly retrieve the resulting data or LAMMPS error statement.
Easily convert systems to/from the other Python atomic environments of ASE and PyMatGen.
Can create systems based on CIF crystal structure files, and LAMMPS atom and dump files.
Built-in unit conversions.
Installation
As of version 1.2, the atomman package is Python 2/3 compatible. It makes heavy use of numpy, so it’s easiest to download a Python environment like Anaconda.
The latest release can be installed using pip:
pip install atomman
This pip command should install atomman and any other required packages, but occasionally a requirement may have to be installed separately. The list of required packages are given below.
Alternatively, all code and documentation can be downloaded from GitHub.
The stable releases are available at https://github.com/usnistgov/atomman.
The working development versions are at https://github.com/lmhale99/atomman.
Documentation
Web-based documentation for the atomman package is available at https://www.ctcms.nist.gov/potentials/atomman.
Source code for the documentation can be found in the github doc directory. The doc directory contains the information both as the source RestructuredText files and as unformatted HTML. If you download a copy, you can view the HTML version offline by
cd {atomman_path}/doc/html python -m http.server (for python 3) python -m SimpleHttpServer (for python 2)
Then, opening localhost:8000 in a web browser.
The documentation consists of two main components:
Tutorial Jupyter Notebooks: Online html version, Downloadable Notebook version. The tutorials starting with ##. provide a general overview/example of the various capabilities. The tutorials starting with ##.#. give more detailed descriptions and list options available to the tools mentioned in the overview tutorials.
Code Documentation: Online html version. This provides a rendering of the Python docstrings for the included functions and classes.
Required packages
This is a list of the required Python packages
Optional packages
This is a list of additional Python packages that can add functionality
cython: Allows for construction of c/Python hybrid code for faster calculations. Alternate cython versions of some of the calculation heavy functions can be built if cython is installed.
diffpy.Structure: CIF reader. Required for loading systems from CIF files.
ase: The Atomic Simulation Environment for interacting with small systems and DFT calculations. Required for converting to/from ase.Atoms objects.
pymatgen: The Python Materials Genomics package used by the Materials Project for DFT calculations. Required for converting to/from pymatgen.Structure objects.
spglib: A Python interface to the spglib spacegroup analysis code. spglib can be used to analyze and determine the spacegroup for an atomic system. Required for converting to/from spglib.cell objects.
lammps: The Python library interface for the LAMMPS molecular dynamics simulation code that allows for a LAMMPS session to be controlled directly from Python. Required for direct loading/dumping of a system to/from a LAMMPS session.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for atomman-1.2.3-cp36-cp36m-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ae6c6e77344f43627064ba230fa055a1fc6e4d61781ecfc393e56ccd2c44775d |
|
MD5 | 2f04edd7256fed604227203c1ad41c53 |
|
BLAKE2b-256 | 31fb6ef08c4894cf1eaefe505aeacb9968a19944108da45f212411f5adfbd433 |
Hashes for atomman-1.2.3-cp27-cp27m-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | abb69b52eb98db9c28941ce4cf6b6d1a197bf676f096f65dc602396f2c2df303 |
|
MD5 | e7afe1a6487f653f6ef9773616f4b892 |
|
BLAKE2b-256 | b6a29ad3b26b599305994921b1fcd05eb03f0eaa59fc580ad35ccff8af5a526d |