Feature overview#
The AMEP Python library provides a unified framework for handling both particle-based and continuum simulation data. It is made for the analysis of molecular-dynamics (MD), Brownian-dynamics (BD), and continuum simulation data of condensed matter systems and active matter systems in particular. AMEP provides a huge variety of analysis methods for both data types that allow to evaluate various dynamic and static observables based on the trajectories of the particles or the time evolution of continuum fields. For fast and efficient data handling, AMEP provides a unified framework for loading and storing simulation data and analysis results in a compressed, HDF5-based data format. AMEP is written purely in Python and uses powerful libraries such as NumPy, SciPy, Matplotlib, and scikit-image commonly used in computational physics. Therefore, understanding, modifying, and building up on the provided framework is comparatively easy. All evaluation functions are optimized to run efficiently on HPC hardware to provide fast computations. To plot and visualize simulation data and analysis results, AMEP provides an optimized plotting framework based on the Matplotlib Python library, which allows to easily plot and animate particles, fields, and lines. Compared to other analysis libraries, the huge variety of analysis methods combined with the possibility to handle both most common data types used in soft-matter physics and in the active matter community in particular, enables the analysis of a much broader class of simulation data including not only classical molecular-dynamics or Brownian-dynamics simulations but also any kind of numerical solutions of partial differential equations. The following table gives an overview on the observables provided by AMEP and on their capability of processing particle-based and continuum simulation data.
We try to keep the following table up to date, but please check the API Reference for the full documentation and all features of AMEP
Observable |
Particles |
Fields |
|---|---|---|
Spatial Correlation Functions: |
||
RDF (radial pair distribution function) |
✔ |
➖ |
PCF2d (2d pair correlation function) |
✔ |
➖ |
PCFangle (angular pair correlation function) |
✔ |
➖ |
SFiso (isotropic static structure factor) |
✔ |
✔ |
SF2d (2d static structure factor) |
✔ |
✔ |
SpatialVelCor (spatial velocity correlation function) |
✔ |
➖ |
PosOrderCor (positional order correlation function) |
✔ |
➖ |
HexOrderCor (hexagonal order correlation function) |
✔ |
➖ |
Local Order: |
||
Voronoi tesselation |
✔ |
➖ |
Local density |
✔ |
✔ |
Local packing fraction |
✔ |
➖ |
k-atic bond order parameter |
✔ |
➖ |
Next/nearest neighbor search |
✔ |
➖ |
Time Correlation Functions: |
||
MSD (mean square displacement) |
✔ |
➖ |
VACF (velocity autocorrelation function) |
✔ |
➖ |
OACF (orientation autocorrelation function) |
✔ |
➖ |
Cluster Analysis: |
||
Clustersize distribution |
✔ |
✔ |
Cluster growth |
✔ |
✔ |
Radius of gyration |
✔ |
✔ |
Linear extension |
✔ |
✔ |
Center of mass |
✔ |
✔ |
Gyration tensor |
✔ |
✔ |
Inertia tensor |
✔ |
✔ |
Miscellaneous: |
||
Translational/rotational kinetic energy |
✔ |
➖ |
Kinetic temperature |
✔ |
➖ |