freud

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

Reference Documentation: Examples, tutorials, topic guides, and package Python APIs.
Installation Guide: Instructions for installing and compiling freud.
freud discussion board: Ask the freud user community for help.
GitHub repository: Download the freud source code.
Issue tracker: Report issues or request features.

Citation

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

Installation

freud is available on conda-forge for the linux-64, linux-aarch64, linux-ppc64le, osx-64, osx-arm64 and win-64 architectures. Install with:

mamba install freud

freud is also available on PyPI:

python3 -m pip install freud-analysis

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!

Release files for freud-analysis 3.6.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for freud-analysis 3.6.1
File	Size	Uploaded
freud_analysis-3.6.1.tar.gz	5.8 MB	Sep 22, 2026	Details

Built distributions (wheels)

Table of built distributions (wheels) for freud-analysis 3.6.1
File	Interpreter	ABI	Platform	Reset
freud_analysis-3.6.1-cp312-abi3-win_amd64.whl 1.8 MB Sep 22, 2026	CPython 3.12	abi3	Windows x86-64	Details
freud_analysis-3.6.1-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl 2.0 MB Sep 22, 2026	CPython 3.12	abi3	Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64	Details
freud_analysis-3.6.1-cp312-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl 1.8 MB Sep 22, 2026	CPython 3.12	abi3	Linux glibc 2.27+ ARM64, Linux glibc 2.28+ ARM64	Details
freud_analysis-3.6.1-cp312-abi3-macosx_11_0_arm64.whl 1.4 MB Sep 22, 2026	CPython 3.12	abi3	macOS 11.0+ ARM64	Details

Total release size: 12.8 MB

Release files / freud_analysis-3.6.1.tar.gz

Download URL	freud_analysis-3.6.1.tar.gz
Size	5.8 MB
Tags	Source
SHA-256 checksum How to use checksums	`94c57c7e9773bd70b7de35a1088f5db29b10b6b946f67fa91c31aeafc57e7296`
BLAKE2b-256 checksum How to use checksums	`a2acd2eeb1d17ffe43c80b132a31aac5a72c74ce0fde82a4d0d93dfd9bd0312f`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/glotzerlab/freud
Publishing commit: github.com/glotzerlab/freud/tree/6204c0322473cce295a7d2f58c3de15a183e9f17

Workflow

Publishing configuration: github.com/glotzerlab/freud/blob/6204c0322473cce295a7d2f58c3de15a183e9f17/.github/workflows/release.yaml
Publishing logs: github.com/glotzerlab/freud/actions/runs/35750980493/attempts/1

Artifact

Subject: freud_analysis-3.6.1.tar.gz
SHA-256 checksum: 94c57c7e9773bd70b7de35a1088f5db29b10b6b946f67fa91c31aeafc57e7296 Verifying attestations

Release files / freud_analysis-3.6.1-cp312-abi3-win_amd64.whl

Download URL	freud_analysis-3.6.1-cp312-abi3-win_amd64.whl
Size	1.8 MB
Tags	CPython 3.12 Windows x86-64 abi3
SHA-256 checksum How to use checksums	`48aa914d63f7d576d83fe9cd91609ae0e45cd16f0f497f0a1b023f89b25d7151`
BLAKE2b-256 checksum How to use checksums	`adb17a5f8c1481237253d80c3901a9d2dfcffacd5476a258608330849ab05035`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/glotzerlab/freud
Publishing commit: github.com/glotzerlab/freud/tree/6204c0322473cce295a7d2f58c3de15a183e9f17

Workflow

Publishing configuration: github.com/glotzerlab/freud/blob/6204c0322473cce295a7d2f58c3de15a183e9f17/.github/workflows/release.yaml
Publishing logs: github.com/glotzerlab/freud/actions/runs/35750980493/attempts/1

Artifact

Subject: freud_analysis-3.6.1-cp312-abi3-win_amd64.whl
SHA-256 checksum: 48aa914d63f7d576d83fe9cd91609ae0e45cd16f0f497f0a1b023f89b25d7151 Verifying attestations

Release files / freud_analysis-3.6.1-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL	freud_analysis-3.6.1-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size	2.0 MB
Tags	CPython 3.12 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum How to use checksums	`cecdd33ab3e1679cb3238088f9f5cee7b887db3a1e3d17e2a80886b7e912d2e9`
BLAKE2b-256 checksum How to use checksums	`f703b4537837f28422c56b1d0e453cd18bbe348780450e88bc25d037eb27c629`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/glotzerlab/freud
Publishing commit: github.com/glotzerlab/freud/tree/6204c0322473cce295a7d2f58c3de15a183e9f17

Workflow

Publishing configuration: github.com/glotzerlab/freud/blob/6204c0322473cce295a7d2f58c3de15a183e9f17/.github/workflows/release.yaml
Publishing logs: github.com/glotzerlab/freud/actions/runs/35750980493/attempts/1

Artifact

Subject: freud_analysis-3.6.1-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
SHA-256 checksum: cecdd33ab3e1679cb3238088f9f5cee7b887db3a1e3d17e2a80886b7e912d2e9 Verifying attestations

Release files / freud_analysis-3.6.1-cp312-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl

Download URL	freud_analysis-3.6.1-cp312-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
Size	1.8 MB
Tags	CPython 3.12 Linux glibc 2.27+ ARM64 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum How to use checksums	`2bf0f41340ad4037628e3724572d1730a74752bdb92026dab16674ff166ad579`
BLAKE2b-256 checksum How to use checksums	`c004e363091c8e2bc530495bc96b655b488f3f5733baee122051d760b6808e7e`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/glotzerlab/freud
Publishing commit: github.com/glotzerlab/freud/tree/6204c0322473cce295a7d2f58c3de15a183e9f17

Workflow

Publishing configuration: github.com/glotzerlab/freud/blob/6204c0322473cce295a7d2f58c3de15a183e9f17/.github/workflows/release.yaml
Publishing logs: github.com/glotzerlab/freud/actions/runs/35750980493/attempts/1

Artifact

Subject: freud_analysis-3.6.1-cp312-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
SHA-256 checksum: 2bf0f41340ad4037628e3724572d1730a74752bdb92026dab16674ff166ad579 Verifying attestations

Release files / freud_analysis-3.6.1-cp312-abi3-macosx_11_0_arm64.whl

Download URL	freud_analysis-3.6.1-cp312-abi3-macosx_11_0_arm64.whl
Size	1.4 MB
Tags	CPython 3.12 abi3 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`0f5f6e8bf8da3e2eaa6d459bec9d193257eab931fc2c19b6bb5a0185c33df532`
BLAKE2b-256 checksum How to use checksums	`94ad51f5026fb64614d10b2bedf022eb83707950694dcc28671ec208b64eca41`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/glotzerlab/freud
Publishing commit: github.com/glotzerlab/freud/tree/6204c0322473cce295a7d2f58c3de15a183e9f17

Workflow

Publishing configuration: github.com/glotzerlab/freud/blob/6204c0322473cce295a7d2f58c3de15a183e9f17/.github/workflows/release.yaml
Publishing logs: github.com/glotzerlab/freud/actions/runs/35750980493/attempts/1

Artifact

Subject: freud_analysis-3.6.1-cp312-abi3-macosx_11_0_arm64.whl
SHA-256 checksum: 0f5f6e8bf8da3e2eaa6d459bec9d193257eab931fc2c19b6bb5a0185c33df532 Verifying attestations