Skip to content

About

Microrheology: particle-tracking and differential dynamic microscopy (DDM) — video in, moduli and viscosity out

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

🔬 microrheology

Video in, rheology out. Particle-tracking microrheology and differential dynamic microscopy (DDM) for extracting diffusion, viscosity, and viscoelastic moduli from microscopy movies of tracer particles.

import microrheology as mr

# --- DDM: works anywhere, including in the browser ---
video = mr.read_video(mr.data.water_video("high"), fps=100, muperpix=0.1)
mr.ddm.calculate_ddm(video, n_average=20, n_deltas=10)
eta = mr.ddm.viscosity_from_ddm(video, radius_um=0.2)   # Pa·s, water ≈ 1e-3

# --- particle tracking (desktop/Colab; needs trackpy) ---
video = mr.read_video(mr.data.water_video("low"), fps=100, muperpix=0.1)
features = mr.tracking.batch_locate(video, diameter=15, minmass=1000)
traj = mr.tracking.link_trajectories(features)
msd = mr.tracking.mean_squared_displacement(traj, muperpix=0.1, fps=100)
omega, Gstar = mr.gser.msd_to_moduli(msd.index, msd.values,
                                     radius_um=0.2, temperature_K=298.15)

Install

pip install rheopy-microrheology        # core (DDM without fitting: numpy/scipy/pandas/matplotlib)
pip install "rheopy-microrheology[ddm]"      # + lmfit for DDM fits
pip install "rheopy-microrheology[tracking]" # + trackpy, pims for particle tracking
pip install "rheopy-microrheology[all]"      # everything

Example data

Two water test videos (400 nm tracers, 0.1 µm/px, 100 fps) live in data/ and are fetched on demand by microrheology.data — never shipped inside the wheel:

  • low concentration → particle tracking
  • high concentration → DDM (tracking infeasible)

Full-fidelity Phantom .cin files are linked from microrheology.data.CIN_URLS.

Docs

Two walkthroughs follow the notebook workflow:

  1. 📍 Particle-tracking microrheology
  2. 🌊 Differential dynamic microscopy (browser-friendly)

Citations

License

MIT. The GSER implementation in microrheology/gser.py is an independent implementation of Mason's published method.

About

Microrheology: particle-tracking and differential dynamic microscopy (DDM) — video in, moduli and viscosity out

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages