Skip to main content

Post-processing tools for particle simulations

Project description

Postprocessing

pypi version license pipeline coverage report

Post-processing tools to compute static and dynamic correlation functions from simulations of interacting particles, such as molecular dynamics or Monte Carlo simulations.

  • Real space: radial distribution function, mean square displacement, time-dependent overlap functions, non-Gaussian parameter
  • Fourier space: structure factor, intermediate scattering functions, four-point dynamic susceptibility

...and more.

This package relies on atooms to read trajectory files.

Quick start

Installation is easy (see Installation for more details)

pip install atooms-pp

We can now compute correlation functions from trajectories produced by particle simulation codes. Any trajectory format recognized by atooms can be processed, for instance most "xyz" files should work fine.

As an example, we compute the structure factor S(k) for the trajectory file trajectory.xyz contained in the data/ directory.

https://www-dft.ts.infn.it/~coslovich/anim.gif

In the example above, we used 20% of the available time frames to compute the averages using the --norigins flag. Without it, atooms-pp applies an heuristics to determine the number of time frames required to achieve a reasonable data quality.

The results of the calculation are stored in data/trajectory.xyz.pp.sk. If the system is a mixture of different types of particles, say A and B, the program will create additional files for partial correlations, named trajectory.xyz.pp.sk.A-A, trajectory.xyz.pp.sk.B-B and trajectory.xyz.pp.sk.A-B.

The same calculation can be done from python:

from atooms.trajectory import Trajectory
import atooms.postprocessing as pp

with Trajectory('data/trajectory.xyz') as t:
     p = pp.StructureFactor(t)
     p.do()

Checkout the tutorial and notebook for more details.

Requirements

  • numpy
  • atooms
  • [optional] argh (only needed when using pp.py)
  • [optional] tqdm (enable progress bars)
  • [optional] argcomplete (enable tab-completion for pp.py)

Installation

If you cannot install the package system-wide, you can still install it in the user space. Either from pypi

pip install --user atooms-pp

or cloning the project repo

git clone https://framagit.org/atooms/postprocessing.git
cd postprocessing
make user

The commands above will install pp.py under ~/.local/bin. Make sure this folder is in your $PATH. To install system-wide, sudo make install.

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

atooms-pp-2.7.0.tar.gz (44.3 kB view hashes)

Uploaded Source

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