Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
31 commits
Select commit Hold shift + click to select a range
88bfea9
Initial draft of Flexicle Tutorial Docs
kmjens Feb 13, 2025
63dd200
Update AUTHORS.md
kmjens Feb 13, 2025
260dbe9
rename active particle tutorial
kmjens Mar 19, 2025
78bf1b7
reorganize turoial files
kmjens Mar 19, 2025
8170bae
tester
Apr 30, 2025
2c0f581
tester part 2
kmjens Apr 30, 2025
070c3a0
Uploading Active Torque Tutorial
Jun 17, 2025
a08538f
quick edit clean up
kmjens Jun 24, 2025
e9dcb9d
update activity tutorials to slightly more coherent state. Complete 2…
kmjens Jun 25, 2025
9825b72
Commit quick changes from colloids review from meeting.
kmjens Sep 4, 2025
1223fad
implement 1st round of edits for activity tutorial
kmjens Sep 4, 2025
848e91c
make tutorials 2D, add beginner info on Pe number
kmjens Sep 4, 2025
096f1eb
last changes editting text
kmjens Feb 3, 2026
8bf8159
remove Run and Tumble, small tweaks
kmjens Feb 3, 2026
bc1ed17
Update 02-Active-Brownian-Particles.ipynb
zoecruse Feb 3, 2026
f6f6d4a
Update 02-Active-Brownian-Particles.ipynb
zoecruse Feb 3, 2026
5f96c75
edits to rigid body and torque
kmjens Feb 3, 2026
bf40549
Update AUTHORS.md
bws212 Feb 3, 2026
ffeaf3c
Merge branch 'activity-tutorial' of github.com:glotzerlab/hoomd-examp…
kmjens Feb 4, 2026
f45f002
Rewrite of introduction section of active matter tutorial (#203)
bws212 Feb 4, 2026
d6696d2
Update repository reference in test workflow
kmjens Feb 4, 2026
7be23f0
Add Zoe Cruse and Jared Shi to AUTHORS.md
kmjens Feb 4, 2026
d04f43d
Jared shi active tutorial (MIPS sections) (#204)
kmjens Feb 4, 2026
464cf7c
Move Pe definition to section 01. Final read through and edit. Rerun …
kmjens Feb 4, 2026
ac423c6
Jared shi abps 11 02 (#207)
Jared-Shi Feb 4, 2026
c0f5df3
Merge branch 'trunk' into activity-tutorial
kmjens Feb 4, 2026
6b241e8
precommit and ruff
kmjens Feb 4, 2026
28d22e5
retry prek
kmjens Feb 4, 2026
ec009df
manually add prek checks
kmjens Feb 4, 2026
e2c3ad2
new prek checks
kmjens Feb 4, 2026
03edd29
First round of review comments adressed; one more set left to address
kmjens Feb 25, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
63 changes: 63 additions & 0 deletions 11-Active-Particles-In-MD/00-index.ipynb
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
{
Copy link
Copy Markdown
Contributor

@SchoeniPhlippsn SchoeniPhlippsn Feb 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please keep the style of the previous tutorials. That means get rid of the introduction (especially as it is nearly identical to the one on the next page), and simply say something like: "This tutorial explains how to model active, self-propelled particles in MD simulations."

And then you say

"This tutorial assumes you are familiar with the concepts introduced in Introducing HOOMD-blue, Introducing Molecular Dynamics and Modelling Rigid Bodies."

Where are you confining particles?


Reply via ReviewNB

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

changes made in newest commit about to be pushed. Wording on confinement corrected to reference Intro HOOMD tutorial where box compression (not confinement via walls) is introduced.

Comment thread
kmjens marked this conversation as resolved.
"cells": [
{
"cell_type": "markdown",
"id": "0",
"metadata": {},
"source": [
"# Modelling Active Particles in MD\n",
"\n",
"This tutorial explains how to model **active, self-propelled particles** in MD simulations.\n",
"\n",
"**Prerequisites:**\n",
"\n",
"- This tutorial assumes you have some familiarity with the Python programming language.\n",
"- This tutorials assume basic understanding of the fundamentals of HOOMD-Blue.\n",
"- This tutorial uses an example with rod-shaped self-propelled particles which are made with Rigid Bodies in MD. Please refer to the [Modelling Rigid Bodies](../06-Modelling-Rigid-Bodies/00-index.ipynb) tutorial for more details as to how this is done.\n",
"- [Section 3](03-Motility-Induced-Phase-Separation-In-2D.ipynb) of this tutorial compresses the simualtion box as an example way to induce **Motility Induce Phase Separation (MIPS)**. Please refer to the [Introducing HOOMD-blue](../00-Introducing-HOOMD-blue/05-Compressing-the-System.ipynb) tutorial for more details as to how this is done."
]
},
{
"cell_type": "markdown",
"id": "1",
"metadata": {},
"source": [
"## Outline\n",
"\n",
"1. [Introduction to Active Particles](01-Introduction-to-Active-Particles.ipynb)\n",
"2. [Modelling Active Brownian Particles (ABP Model)](02-Active-Brownian-Particles.ipynb)\n",
"3. [Motility Induced Phase Separation (MIPS) in 2D Systems](03-Motility-Induced-Phase-Separation-In-2D.ipynb)\n",
"4. [Modelling Active Rigid Bodies with Active Applied Torques](04-Active-Torque-On-Rigid-Bodies.ipynb)"
]
},
{
"cell_type": "markdown",
"id": "2",
"metadata": {},
"source": [
"This tutorial is written with [jupyter](https://jupyter.org/). You can download the source from the [hoomd-examples](https://github.com/glotzerlab/hoomd-examples) repository."
]
}
],
"metadata": {
"kernelspec": {
"display_name": "Python 3 (ipykernel)",
"language": "python",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.13.7"
}
},
"nbformat": 4,
"nbformat_minor": 5
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,83 @@
{
Copy link
Copy Markdown
Contributor

@SchoeniPhlippsn SchoeniPhlippsn Feb 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Active particles are particles that can consume stored energy or energy from the environment and convert it into directed motion. There are many different types of active particles with different mechanisms for this realized self-propulsion. For example, a polystyrene bead coated with platinum on one side (i.e. an example of a simple Janus particle, a particle with 2 of more regions of distinct physical properties) will be propelled forward if submerged in a solution containing hydrogen peroxide. This occurs because the platinum catalyzes a chemical reaction that decomposes the hydrogen peroxide into oxygen gas and water. This localized reaction propels the particle forward. In this example, thermal and chemical energy is being consumed to generate the kinetic motion of the (now active) Janus particle."


Reply via ReviewNB

Copy link
Copy Markdown
Contributor

@SchoeniPhlippsn SchoeniPhlippsn Feb 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. You have to mention that we model dry active matter.
  2. Use the symbols for sigma $\sigma$ and gamma $\gamma$. Gamma is also not explained.
  3. Instead of mentioning all the details about ABPs, MIPS and rigid bodies here, I would put them into the respective following pages

Reply via ReviewNB

Copy link
Copy Markdown
Contributor Author

@kmjens kmjens Feb 25, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • dry active matter mention added.
  • I believe there is already a brief one sentence explanation of gamma in the text that might have been missed (plz let me know if you still think this is insufficient):
In HOOMD-blue, the propulsion velocity is controlled by applying an active force to particles in the system. The relationship between these quantities is $v_{0} = F_{active} / \gamma$ where $\gamma$ is the translational drag coefficient (often = 1 in overdamped Brownian dynamics). 
  • explanations moved to the appropriate sections

"cells": [
{
"cell_type": "markdown",
"id": "0",
"metadata": {},
"source": [
"# Introduction to Active Particle Systems\n",
"\n",
"## Overview\n",
"\n",
"### Questions\n",
"\n",
"* How can we model particles with self-induced **active forces**?\n",
"* What types of information can we learn from **non-equilibrium** systems?\n",
"\n",
"### Objectives\n",
"\n",
"* Introduce the **Active Brownian Particle (ABP) model** \n",
"* Define **Motility-Induced Phase Separation (MIPS)**. \n",
"* Discuss the mechanics of **rigid bodies responding to active forces** using torque as an example."
]
},
{
"cell_type": "markdown",
"id": "1",
"metadata": {},
"source": [
"## Introduction to Active Particles\n",
"\n",
"**Active particles** are particles that can consume stored energy or energy from the environment and convert it into directed motion. There are many different types of active particles with different mechanisms for this realized self-propulsion. For example, a polystyrene bead coated with platinum on one side (i.e. an example of a simple **Janus particle**, a particle with 2 of more regions of distinct physical properties) will be propelled forward if submerged in a solution containing hydrogen peroxide. This occurs because the platinum catalyzes a chemical reaction that decomposes the hydrogen peroxide into oxygen gas and water. This localized reaction propels the particle forward. In this example, thermal and chemical energy is being consumed to generate the kinetic motion of the (now active) Janus particle.\n",
"\n",
"In the previous HOOMD-blue tutorials, most of the systems have been models with which one could investigate **equilibrium properties** where the steady state is independent of kinetic parameters. When studying **active matter**, however, we are no longer considering equilibrium processes, and we shift our attention to **non-equilibrium dynamics**. Regardless, we can set up the initial state of the simulation in a very similar manner to previous methods we have used in [earlier hoomd MD simulation tutorials](../01-Introducing-Molecular-Dynamics/00-index.ipynb). "
]
},
{
"cell_type": "markdown",
"id": "1bf55e0d-a51e-4782-a6bb-1145a4de5391",
"metadata": {},
"source": [
"### Active Particles and their Phenomena:\n",
"There are a few categories of active particles. Here we introduce the commonly discussed **Active Brownian Particle (ABP)**. Cates and Tailleur have a helpful figure distinguishing this active particle type from others their [2015 Annual Review Condensed Matter Physics Paper](https://www.annualreviews.org/content/journals/10.1146/annurev-conmatphys-031214-014710). The left image shows an example cartoon trajectory of an alternate type of active particle called a Run-and-Tumble particle (Fig. a), and the right shows an example cartoon trajectory for an ABP (Fig. b). This tutorial focuses on modeling **dry active matter** with ABPs. \n"
]
},
{
"cell_type": "code",
"execution_count": null,
"id": "0fe709c5-c4da-47a7-8258-800d548ca347",
"metadata": {},
"outputs": [],
"source": []
},
{
"cell_type": "code",
"execution_count": null,
"id": "c76f129c-4027-4219-8030-781b733ffe55",
"metadata": {},
"outputs": [],
"source": []
}
],
"metadata": {
"kernelspec": {
"display_name": "Python 3 (ipykernel)",
"language": "python",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.13.7"
}
},
"nbformat": 4,
"nbformat_minor": 5
}
Loading
Loading