Skip to main content

Powerful, efficient trajectory analysis in scientific Python.

Project description

Citing freud PyPI conda-forge ReadTheDocs Binder GitHub-Stars

Overview

The freud Python library provides a simple, flexible, powerful set of tools for analyzing trajectories obtained from molecular dynamics or Monte Carlo simulations. High performance, parallelized C++ is used to compute standard tools such as radial distribution functions, correlation functions, order parameters, and clusters, as well as original analysis methods including potentials of mean force and torque (PMFTs) and local environment matching. The freud library supports many input formats and outputs NumPy arrays, enabling integration with the scientific Python ecosystem for many typical materials science workflows.

Resources

Citation

When using freud to process data for publication, please use this citation.

Installation

The easiest ways to install freud are using pip:

pip install freud-analysis

or conda:

conda install -c conda-forge freud

freud is also available via containers for Docker or Singularity. If you need more detailed information or wish to install freud from source, please refer to the Installation Guide to compile freud from source.

Examples

The freud library is called using Python scripts. Many core features are demonstrated in the freud documentation. The examples come in the form of Jupyter notebooks, which can also be downloaded from the freud examples repository or launched interactively on Binder. Below is a sample script that computes the radial distribution function for a simulation run with HOOMD-blue and saved into a GSD file.

import freud
import gsd.hoomd

# Create a freud compute object (RDF is the canonical example)
rdf = freud.density.RDF(bins=50, r_max=5)

# Load a GSD trajectory (see docs for other formats)
traj = gsd.hoomd.open('trajectory.gsd', 'rb')
for frame in traj:
    rdf.compute(system=frame, reset=False)

# Get bin centers, RDF data from attributes
r = rdf.bin_centers
y = rdf.rdf

Support and Contribution

Please visit our repository on GitHub for the library source code. Any issues or bugs may be reported at our issue tracker, while questions and discussion can be directed to our user forum. All contributions to freud are welcomed via pull requests!

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

freud-analysis-2.12.1.tar.gz (3.3 MB view details)

Uploaded Source

Built Distributions

freud_analysis-2.12.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.7 MB view details)

Uploaded CPython 3.11 manylinux: glibc 2.17+ x86-64

freud_analysis-2.12.1-cp311-cp311-macosx_11_0_arm64.whl (1.8 MB view details)

Uploaded CPython 3.11 macOS 11.0+ ARM64

freud_analysis-2.12.1-cp311-cp311-macosx_10_14_x86_64.whl (2.1 MB view details)

Uploaded CPython 3.11 macOS 10.14+ x86-64

freud_analysis-2.12.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.7 MB view details)

Uploaded CPython 3.10 manylinux: glibc 2.17+ x86-64

freud_analysis-2.12.1-cp310-cp310-macosx_11_0_arm64.whl (1.8 MB view details)

Uploaded CPython 3.10 macOS 11.0+ ARM64

freud_analysis-2.12.1-cp310-cp310-macosx_10_14_x86_64.whl (2.1 MB view details)

Uploaded CPython 3.10 macOS 10.14+ x86-64

freud_analysis-2.12.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.7 MB view details)

Uploaded CPython 3.9 manylinux: glibc 2.17+ x86-64

freud_analysis-2.12.1-cp39-cp39-macosx_11_0_arm64.whl (1.8 MB view details)

Uploaded CPython 3.9 macOS 11.0+ ARM64

freud_analysis-2.12.1-cp39-cp39-macosx_10_14_x86_64.whl (2.1 MB view details)

Uploaded CPython 3.9 macOS 10.14+ x86-64

freud_analysis-2.12.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.7 MB view details)

Uploaded CPython 3.8 manylinux: glibc 2.17+ x86-64

freud_analysis-2.12.1-cp38-cp38-macosx_11_0_arm64.whl (1.8 MB view details)

Uploaded CPython 3.8 macOS 11.0+ ARM64

freud_analysis-2.12.1-cp38-cp38-macosx_10_14_x86_64.whl (2.1 MB view details)

Uploaded CPython 3.8 macOS 10.14+ x86-64

freud_analysis-2.12.1-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.7 MB view details)

Uploaded CPython 3.7m manylinux: glibc 2.17+ x86-64

freud_analysis-2.12.1-cp37-cp37m-macosx_10_14_x86_64.whl (2.1 MB view details)

Uploaded CPython 3.7m macOS 10.14+ x86-64

freud_analysis-2.12.1-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.7 MB view details)

Uploaded CPython 3.6m manylinux: glibc 2.17+ x86-64

freud_analysis-2.12.1-cp36-cp36m-macosx_10_14_x86_64.whl (2.1 MB view details)

Uploaded CPython 3.6m macOS 10.14+ x86-64

File details

Details for the file freud-analysis-2.12.1.tar.gz.

File metadata

  • Download URL: freud-analysis-2.12.1.tar.gz
  • Upload date:
  • Size: 3.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.15

File hashes

Hashes for freud-analysis-2.12.1.tar.gz
Algorithm Hash digest
SHA256 8b4b9751a9644c3fbb4cd1534c7a8201b33c91e03f68dc04f2c6c795f8fff6c8
MD5 117525552aae9a451faea0c46344714d
BLAKE2b-256 99b0344a936c0a24f2086f0f04db38a57dac3bdf52725dc41df78e4f870c6c47

See more details on using hashes here.

File details

Details for the file freud_analysis-2.12.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for freud_analysis-2.12.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 41046344d6e9dd1dd2a1d14dff865cd879e19486fe0c7428b91d20f9d1da0a2b
MD5 4eb880397ec711b4d213f937c0832610
BLAKE2b-256 d190a3fdbe6aef2e132daba7664d75a80e4d3f5e25d22ecfb25508d4c48ff2eb

See more details on using hashes here.

File details

Details for the file freud_analysis-2.12.1-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for freud_analysis-2.12.1-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 88d7cdcaf6836a5eaf7a3ddf18e96e4cf57446e02ccbd315e4bca27c397f46e6
MD5 46d83ddf14f2a6420dc16d5f1cbbbcd8
BLAKE2b-256 2eac091f1ec2a91c27cdcbf1b5511aebb02e2b8b5a64ac2f3f4b6db98fc88835

See more details on using hashes here.

File details

Details for the file freud_analysis-2.12.1-cp311-cp311-macosx_10_14_x86_64.whl.

File metadata

File hashes

Hashes for freud_analysis-2.12.1-cp311-cp311-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 20a701136cf6c1850f5a1db9efeea05d1d5d4600bae991d8cf5f2f48914c24a5
MD5 654f482de9884c036a72b17d594b7e4e
BLAKE2b-256 43458722ed053709f89de5aae0f41ba7219d24f3d3fb4e96a41e90ca132ac686

See more details on using hashes here.

File details

Details for the file freud_analysis-2.12.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for freud_analysis-2.12.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 1daf366e9a0f2b57a79d6a98b20e8312647a7e38e5190c513eb053a99f8be2fd
MD5 536f7cacd88027131259db1528529ec8
BLAKE2b-256 c268dba5467ea2a321c27426e4606e6374fb903f1e2c31f9bfe696cc7e012cef

See more details on using hashes here.

File details

Details for the file freud_analysis-2.12.1-cp310-cp310-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for freud_analysis-2.12.1-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 c1cc38766c3a1928fe8f9a503a1a7c107485b3a7d9a08617f3c2d1eb5d79d311
MD5 b1772f1cf4f65bae0cc5ce565ac64f9d
BLAKE2b-256 95552ffe37fb6548bf63871fa5847711b87adb0690ac4c64c02f3ff0063cfaf8

See more details on using hashes here.

File details

Details for the file freud_analysis-2.12.1-cp310-cp310-macosx_10_14_x86_64.whl.

File metadata

File hashes

Hashes for freud_analysis-2.12.1-cp310-cp310-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 f64db3b1135aad40a1dad6540d642656112643e12590bb0206c8438381768be7
MD5 b939a7798265c99ca76b0ea49cc67b83
BLAKE2b-256 02a8573f9f943ccb1dae74ee8e076badbc37287ee18fd64c4ade9b2adb24a519

See more details on using hashes here.

File details

Details for the file freud_analysis-2.12.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for freud_analysis-2.12.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 507ac4e7f6aeb4bde5085b112cea127f01cec4863b45b00fbb04135b7105db77
MD5 cc2d4f65cb36b6c68f51f085a7ebdc7d
BLAKE2b-256 28eaee92814501b561b341aee2cf79620e7b67a20bc81be5e60fb24c1d7ff2e3

See more details on using hashes here.

File details

Details for the file freud_analysis-2.12.1-cp39-cp39-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for freud_analysis-2.12.1-cp39-cp39-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 1958d45bff32a8ba63eede71fdec4338b9a6116bbc3b011917bb87a4ddd8dc58
MD5 933531b0a3d196e3d349220c4c609fee
BLAKE2b-256 3aac2c32ca48f5343c7422048d2de0c760a053ea696e5e16be9b03666fec9d76

See more details on using hashes here.

File details

Details for the file freud_analysis-2.12.1-cp39-cp39-macosx_10_14_x86_64.whl.

File metadata

File hashes

Hashes for freud_analysis-2.12.1-cp39-cp39-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 f67a7cfc3589f710703afef73821215f2465aceafc82e4eb65c3e182c00d157f
MD5 677731562c6b61cc6e14d68ed3ad4682
BLAKE2b-256 566ee7a50ff55350ef46bad7b7df521cd5eefd19ea48065be29e8b7164290040

See more details on using hashes here.

File details

Details for the file freud_analysis-2.12.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for freud_analysis-2.12.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 330c3aea5e7106351060236c8c46de004c49d73315273e789469e92ef3e612ee
MD5 0ab821715dc4a280adaf63dcc4aa0ba8
BLAKE2b-256 2a777c831f271c953d16ad55f51ba377c71b2efe67889315875abba77052f336

See more details on using hashes here.

File details

Details for the file freud_analysis-2.12.1-cp38-cp38-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for freud_analysis-2.12.1-cp38-cp38-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 2efc4b9be9f5945a50eb3c20073ce8c5ade92ff3675069e04454a5dc2e7c199a
MD5 7098d371b64e53dfdea9a904624682a5
BLAKE2b-256 50905c31f5f72af9386d8548c514948a3f5759681d923497efcd52767977e702

See more details on using hashes here.

File details

Details for the file freud_analysis-2.12.1-cp38-cp38-macosx_10_14_x86_64.whl.

File metadata

File hashes

Hashes for freud_analysis-2.12.1-cp38-cp38-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 fcbbbc5d1f66ac0c335db6db1de0c52ced2bfee4dc62e8960689a5260319736f
MD5 2365dcc1f6aaaf17b261064c5c877458
BLAKE2b-256 ceac620994504160cb0f13e8c97609bf479f9dd5cc6d2831daaac14b34b3c681

See more details on using hashes here.

File details

Details for the file freud_analysis-2.12.1-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for freud_analysis-2.12.1-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 0ec0abff9a3f44f9e3b244898c3acf263c9d6b830ab05f6fee16288ba689eac4
MD5 79568678f037cea6b8d4329fb6ba4845
BLAKE2b-256 b1ec1b3cbe4e47fbb29324a81e2414f53c7cce75168efacb958c457a81b14822

See more details on using hashes here.

File details

Details for the file freud_analysis-2.12.1-cp37-cp37m-macosx_10_14_x86_64.whl.

File metadata

File hashes

Hashes for freud_analysis-2.12.1-cp37-cp37m-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 648fc85930eadf25894aed84d6799dbdba397d0d8783d35cde3839e37bbecba1
MD5 f55611dd90027233b05dc5cf86c3f5ed
BLAKE2b-256 525ac1ffc6c36ea79803d81c21e84b102c6873f08719e7d987dad849b3bdb857

See more details on using hashes here.

File details

Details for the file freud_analysis-2.12.1-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for freud_analysis-2.12.1-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 8a6c821a2fcd613db324d061598a56dc996fd0b00b3c646bc6162a41eafd85ca
MD5 cd47ee34844cf4aa51045b9e34e4f706
BLAKE2b-256 7dce4ecb1162deb9dc3f07e9ce4b37b07dbc1ba5fa1768512200366f1be29ef5

See more details on using hashes here.

File details

Details for the file freud_analysis-2.12.1-cp36-cp36m-macosx_10_14_x86_64.whl.

File metadata

File hashes

Hashes for freud_analysis-2.12.1-cp36-cp36m-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 07a54384ed2292bcaeeb84b2b6b4f4c873b3114d559305ade3f38729a3cdfb03
MD5 192457eaf278edb92e96bce04775a62c
BLAKE2b-256 d286558f90c1ff921cc078c490368dcb5622046e153eba44d477e405a11b28e4

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