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 discussion board. 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-3.0.0.tar.gz (3.4 MB view details)

Uploaded Source

Built Distributions

freud_analysis-3.0.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.7 MB view details)

Uploaded CPython 3.12 manylinux: glibc 2.17+ x86-64

freud_analysis-3.0.0-cp312-cp312-macosx_11_0_arm64.whl (1.9 MB view details)

Uploaded CPython 3.12 macOS 11.0+ ARM64

freud_analysis-3.0.0-cp312-cp312-macosx_10_14_x86_64.whl (2.2 MB view details)

Uploaded CPython 3.12 macOS 10.14+ x86-64

freud_analysis-3.0.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.8 MB view details)

Uploaded CPython 3.11 manylinux: glibc 2.17+ x86-64

freud_analysis-3.0.0-cp311-cp311-macosx_11_0_arm64.whl (1.9 MB view details)

Uploaded CPython 3.11 macOS 11.0+ ARM64

freud_analysis-3.0.0-cp311-cp311-macosx_10_14_x86_64.whl (2.2 MB view details)

Uploaded CPython 3.11 macOS 10.14+ x86-64

freud_analysis-3.0.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.8 MB view details)

Uploaded CPython 3.10 manylinux: glibc 2.17+ x86-64

freud_analysis-3.0.0-cp310-cp310-macosx_11_0_arm64.whl (1.9 MB view details)

Uploaded CPython 3.10 macOS 11.0+ ARM64

freud_analysis-3.0.0-cp310-cp310-macosx_10_14_x86_64.whl (2.2 MB view details)

Uploaded CPython 3.10 macOS 10.14+ x86-64

freud_analysis-3.0.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.8 MB view details)

Uploaded CPython 3.9 manylinux: glibc 2.17+ x86-64

freud_analysis-3.0.0-cp39-cp39-macosx_11_0_arm64.whl (1.9 MB view details)

Uploaded CPython 3.9 macOS 11.0+ ARM64

freud_analysis-3.0.0-cp39-cp39-macosx_10_14_x86_64.whl (2.2 MB view details)

Uploaded CPython 3.9 macOS 10.14+ x86-64

freud_analysis-3.0.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.8 MB view details)

Uploaded CPython 3.8 manylinux: glibc 2.17+ x86-64

freud_analysis-3.0.0-cp38-cp38-macosx_11_0_arm64.whl (1.9 MB view details)

Uploaded CPython 3.8 macOS 11.0+ ARM64

freud_analysis-3.0.0-cp38-cp38-macosx_10_14_x86_64.whl (2.2 MB view details)

Uploaded CPython 3.8 macOS 10.14+ x86-64

File details

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

File metadata

  • Download URL: freud-analysis-3.0.0.tar.gz
  • Upload date:
  • Size: 3.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.8

File hashes

Hashes for freud-analysis-3.0.0.tar.gz
Algorithm Hash digest
SHA256 425a1372da7d94baa075b051554a0da0a263a965a0f5a15c31383dfd30cc536e
MD5 d27e31283fa1c66dea65b14b5541a277
BLAKE2b-256 b9b187401b075d8dfa4c12cbe03e0c0919445f19d8e3ec8472d6d855660004bb

See more details on using hashes here.

File details

Details for the file freud_analysis-3.0.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for freud_analysis-3.0.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 eeb4da7487fe434675bcb4b43d380680f1054e146680f82e9eab21e1fb89185f
MD5 228725bdcb4088cb1da4afe77abe9020
BLAKE2b-256 5865b99f211c1a32a06050f6f72018b6a5153e6ee961f2ddfec93662c3a2dee9

See more details on using hashes here.

File details

Details for the file freud_analysis-3.0.0-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for freud_analysis-3.0.0-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 3f56dc5e1d946c3bc69fc124e7d7102f988f661a06e1e84efc21210503ddd6c2
MD5 14222f6484ee919a8bc6d3ff6ccad1eb
BLAKE2b-256 6c26af181354908f444bec69232c56065cb8ead209f2f5129d89bd6282da8001

See more details on using hashes here.

File details

Details for the file freud_analysis-3.0.0-cp312-cp312-macosx_10_14_x86_64.whl.

File metadata

File hashes

Hashes for freud_analysis-3.0.0-cp312-cp312-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 d0ff24fff86dc4fb91f7673237ff1860d48560e47de6b5139427e036a665b875
MD5 45defd30e59a8bcbe2fc290b79c79dee
BLAKE2b-256 db6e046562bad98357633d1a01c08880e4c1f62c57d6981099a5ee1e58fecadf

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for freud_analysis-3.0.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 bcc6ad19836d464fb6c00a685729f61b2e6284d0ffa384fa8e9dec4822822b54
MD5 46f091225aa860d3def6ed570027ab31
BLAKE2b-256 9721d0137fb4218c74daf963f0589ec439738b2343e4c6b2c2a27af2925b967d

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for freud_analysis-3.0.0-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 d40c68a31164b70775feec856b065b31674a11dcd3e5b95d83b189cb25cf1162
MD5 e9d9e17524413a031e17dc7487d0f5b0
BLAKE2b-256 4ce01c19682bbc3bf69ebf65488617911434a99444c7112c96706f691698ff71

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for freud_analysis-3.0.0-cp311-cp311-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 826574ae30e9760925a86c28a0f19fb6f35d3d82fee222e096c595b43723cea7
MD5 7486e779f069538bb446f437aa6662bb
BLAKE2b-256 b09c8fc7b156d1547d8b3acd3a5583714c9a8553f6887f4f2d73e521f43007af

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for freud_analysis-3.0.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 13691febaf550e41861486612f83a636ca364fb62d7aa537368decd8cf26190e
MD5 f8b31dea2310e146159af4647a73e503
BLAKE2b-256 65af588b705246eb09bff91ddcf09c80503dd0b1e7f7bc8e14ac97f2a2f8447b

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for freud_analysis-3.0.0-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 20da544dcdbdeb36e24e338c8d9bdd87e3e6a933d58eadf46af7a13c8db02103
MD5 a5d8114f4298375008996c51dabcba58
BLAKE2b-256 285a5c4deca4ca2bccbb86fa8adfb4a1465dc3240804419d5be0f63eb8e069ce

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for freud_analysis-3.0.0-cp310-cp310-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 9712f2673de909ce0db2fa6560326afd753b5b1cdf564ba70d7d882e6328f33e
MD5 59dbe59cefd16fcdfb31fbb5481a842d
BLAKE2b-256 84fd9d15202a20b55eca21279c4e0d23796cfb157c6d4285227cee8331e4c7e9

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for freud_analysis-3.0.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 dc8fb7021932c37a4cb029b539727eb379808bfd58e08c0249b3c94fa39f2c95
MD5 8e3e9fb3fe2087211211ab2dd43b9165
BLAKE2b-256 db95c86b897deab0c8f5a9862b6a2d177723082af5a68e41ece920761001fdbf

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for freud_analysis-3.0.0-cp39-cp39-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 350adae13f6f0ff046562749db7a5f45021072c9ababa76399d39934fd43c65d
MD5 4ffc68927989d0e7fda570227a2d6ab5
BLAKE2b-256 0ac32ff2667dbe3229aecf442aaf1d74997520af8e5467095dacb9344558aee8

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for freud_analysis-3.0.0-cp39-cp39-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 a65677d6899a2ed18be7f84e4ce3f32bcbf338f6e6418bf5ae09c70820f797c7
MD5 d9ff16eabeee6e8522eb802f84dfb2b4
BLAKE2b-256 fb69ee98ab3ff3a3a32291fba674091aafbb38aa913e4fa2f5da4b87965fde92

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for freud_analysis-3.0.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 bd2d0c8152a21feea310c1654468c15269ea6d5bc1de20600ef9ecb7cde4b2f1
MD5 9d20d22d50d38eec467a00752f9a0733
BLAKE2b-256 fd5bb6b7e7cdec28ba2e3c866b50b2bfd6c81b02b34b619f024db10853264591

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for freud_analysis-3.0.0-cp38-cp38-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 a67bf423ad28e1a6d1f40ba719992a9a19376e89f0de6e6a95bca408b6287951
MD5 a816cc13a295134dff571af028c6affa
BLAKE2b-256 51f3bc8e2c9a25f9aeb338b63eca34c1967834544a02543498757465270e00d0

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for freud_analysis-3.0.0-cp38-cp38-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 7a0c6a266756a3b61fe40bff20e7a1714628583e3d127a970c788682288e6da3
MD5 93e1a1cafd3635217cc8c8b257521ceb
BLAKE2b-256 929807c050a03bcb9ea5db4766d61edb3dd0c98d78ee66189230837307cd04cc

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