Perform various analyses of particle simulations.
Project description
freud
The freud library provides users the ability to analyze molecular dynamics and Monte Carlo simulation trajectories for advanced metrics such as the radial distribution function and various order parameters. Its modules work with and return NumPy arrays, and are able to process both 2D and 3D data. Features in freud include computing the radial distribution function, local density, hexagonal order parameter and local bond order parameters, potentials of mean force and torque (PMFTs), Voronoi tessellations, and more.
When using freud to process data for publication, please use this citation.
freud Community
If you have a question, please post to the freud-users mailing list. Please report issues and suggest feature enhancements via the Bitbucket issues page.
Documentation
The documentation is available online at https://freud.readthedocs.io. These pages include an installation guide, examples demonstrating many of freud's core modules, API reference, and development guides for adding new features.
Examples
Many core features are demonstrated in the freud documentation. Additional example Jupyter notebooks can be found in the freud-examples repository. These notebooks may be launched interactively on Binder or downloaded and run on your own system.
Installing freud
Install via conda
conda install -c conda-forge freud
Install via pip
pip install freud-analysis
Compiling freud
Please refer to the installation documentation for help compiling freud from source.
Simple example script
The freud library is called using Python scripts.
Here is a simple example.
import freud
# create a freud compute object (rdf is the canonical example)
rdf = freud.density.rdf(rmax=5, dr=0.1)
# load in your data (freud does not provide a data reader)
box_data = np.load("path/to/box_data.npy")
pos_data = np.load("path/to/pos_data.npy")
# create freud box
box = freud.box.Box(Lx=box_data[0]["Lx"], Ly=box_data[0]["Ly"], is2D=True)
# compute RDF
rdf.compute(box, pos_data[0], pos_data[0])
# get bin centers, rdf data
r = rdf.R
y = rdf.RDF
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
File details
Details for the file freud-analysis-0.11.4.tar.gz
.
File metadata
- Download URL: freud-analysis-0.11.4.tar.gz
- Upload date:
- Size: 3.9 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/40.5.0 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.1
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2b015267e7be4e80cd703ef2f3f3e75b907b86bb5a4429e6de1d56a5aeaa8561 |
|
MD5 | 286f38075a08612258c7867f35a4dd3a |
|
BLAKE2b-256 | 52d7a9ef9664f8c84e2dd8456d1047ea206650d61c80d11fed93bba996026e76 |
File details
Details for the file freud_analysis-0.11.4-cp37-cp37m-manylinux1_x86_64.whl
.
File metadata
- Download URL: freud_analysis-0.11.4-cp37-cp37m-manylinux1_x86_64.whl
- Upload date:
- Size: 18.2 MB
- Tags: CPython 3.7m
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/40.5.0 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.1
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | e66cc65742552f1d502efd4e119719ea50a60e242d6055d78491fcde0f914459 |
|
MD5 | bed9b0ed6a976c8abb3166a3a4824a7c |
|
BLAKE2b-256 | 127a3c8727cdb0606b97414bd14c763585755c342e1ac7acfd8a476383f97e48 |
File details
Details for the file freud_analysis-0.11.4-cp37-cp37m-macosx_10_12_x86_64.whl
.
File metadata
- Download URL: freud_analysis-0.11.4-cp37-cp37m-macosx_10_12_x86_64.whl
- Upload date:
- Size: 2.2 MB
- Tags: CPython 3.7m, macOS 10.12+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4a69942b251957df785dcca40c3ee4ae02d8b3e7350d3c06ce30f3e2457f45a6 |
|
MD5 | 2057b33ef833be3eab09999b723f60f7 |
|
BLAKE2b-256 | 7eb60ac98b1578028c98e151896ef7fb45a3a7df2f5dd67d8efcb2dad2102ff5 |
File details
Details for the file freud_analysis-0.11.4-cp36-cp36m-manylinux1_x86_64.whl
.
File metadata
- Download URL: freud_analysis-0.11.4-cp36-cp36m-manylinux1_x86_64.whl
- Upload date:
- Size: 18.3 MB
- Tags: CPython 3.6m
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/40.5.0 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.1
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | eb306648059b5fdf669676d8f34ae6588f7022ef6424db450b74d43a5cf8aa86 |
|
MD5 | fdce7dc8f313f88c19c812e49a0f6744 |
|
BLAKE2b-256 | fa6506d37b48fb6bfd3d97b036bd915cc7516cabb845f5cdcf6f22d5d09b1418 |
File details
Details for the file freud_analysis-0.11.4-cp36-cp36m-macosx_10_12_x86_64.whl
.
File metadata
- Download URL: freud_analysis-0.11.4-cp36-cp36m-macosx_10_12_x86_64.whl
- Upload date:
- Size: 2.2 MB
- Tags: CPython 3.6m, macOS 10.12+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0d6122614f742819a0bf6f6d4eea741eeae55e3d7e17198a3fdc919cbeb9a1e7 |
|
MD5 | 30c79c438f1c401a164fb5825f97defa |
|
BLAKE2b-256 | 2a70530422c3c564d7626ae0e3e7dec423d644d040a60dfe48de4336fa1c204c |
File details
Details for the file freud_analysis-0.11.4-cp35-cp35m-manylinux1_x86_64.whl
.
File metadata
- Download URL: freud_analysis-0.11.4-cp35-cp35m-manylinux1_x86_64.whl
- Upload date:
- Size: 18.1 MB
- Tags: CPython 3.5m
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/40.5.0 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.1
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | ebe356ec2154feffd700a9bd7196c57a2c61387b56388dd66932a29b1d22b919 |
|
MD5 | e7324b968a2ded75c52acdc3b2b8a1eb |
|
BLAKE2b-256 | 05b6b9cb44582f6f15c18b41f828c7e0bd541e80c2be8a5036f580b22e3a6d17 |
File details
Details for the file freud_analysis-0.11.4-cp35-cp35m-macosx_10_12_x86_64.whl
.
File metadata
- Download URL: freud_analysis-0.11.4-cp35-cp35m-macosx_10_12_x86_64.whl
- Upload date:
- Size: 2.2 MB
- Tags: CPython 3.5m, macOS 10.12+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4590a3e1eba5847f00f0cd35237be6b0813b12acc4e12f475685a78fe71e8879 |
|
MD5 | 49087de61da7eeb059aada8bc003bdc4 |
|
BLAKE2b-256 | 4024b7a4bbe0fc0d9a71b9a6e5b0fecff53a398f31cecbb11769b8ca173417cc |
File details
Details for the file freud_analysis-0.11.4-cp34-cp34m-manylinux1_x86_64.whl
.
File metadata
- Download URL: freud_analysis-0.11.4-cp34-cp34m-manylinux1_x86_64.whl
- Upload date:
- Size: 18.2 MB
- Tags: CPython 3.4m
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/40.5.0 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.1
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 006ca7625c33b896567ec8728ff6546ba722e931b3e3ac5031c5443772aaf889 |
|
MD5 | eb184ff1910f629e798c469348d1c4ed |
|
BLAKE2b-256 | 7f1321d81e80e77b5c7046af45e1b738fafed07a4c23b98774609e9f8daa6fa1 |
File details
Details for the file freud_analysis-0.11.4-cp27-cp27mu-manylinux1_x86_64.whl
.
File metadata
- Download URL: freud_analysis-0.11.4-cp27-cp27mu-manylinux1_x86_64.whl
- Upload date:
- Size: 17.9 MB
- Tags: CPython 2.7mu
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/40.5.0 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.1
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9211cbadd277e231e1cee6c1aa759f01aef87b90bdc4d697fe6c9f362f61ba24 |
|
MD5 | e8dfd927d38282210079910e09df4087 |
|
BLAKE2b-256 | d16f4084f161f224ccdd0ef44e536c506f2ea2309693ba54db08543a96aec55b |
File details
Details for the file freud_analysis-0.11.4-cp27-cp27m-manylinux1_x86_64.whl
.
File metadata
- Download URL: freud_analysis-0.11.4-cp27-cp27m-manylinux1_x86_64.whl
- Upload date:
- Size: 17.9 MB
- Tags: CPython 2.7m
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/40.5.0 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.1
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 948d0f80a0644abf2d484153d72cdf31fcd4403a6cdb2c0d561e1c345b90db33 |
|
MD5 | 7a393a3ba8cd2d6a95e00a6dd8f3f5d3 |
|
BLAKE2b-256 | 28cd32610b6d04f74a571b37b8d0a9fde8b9e1306a6b2cfbc7e2a578becc1770 |
File details
Details for the file freud_analysis-0.11.4-cp27-cp27m-macosx_10_12_x86_64.whl
.
File metadata
- Download URL: freud_analysis-0.11.4-cp27-cp27m-macosx_10_12_x86_64.whl
- Upload date:
- Size: 2.2 MB
- Tags: CPython 2.7m, macOS 10.12+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | c78b0292fadf77f17312d4bc421a7661ae05e126136356faaae92097bd5676f1 |
|
MD5 | 9c58201fcbbeafce24b4384b4a6c78a8 |
|
BLAKE2b-256 | e9601d02d4dc8dafd04d11caf115fa2cb2319b872cf6c91e44f7a815e5c76962 |