This script demonstrates the relaxation of an ensemble of colliding particles towards the equilibrium, Maxwell-Boltzmann distribution of their speeds. Unlike this previous post, the collision detection and dynamics are handled using NumPy arrays without explicit python loops (except over collision pairs), which improves the performance greatly.

At the time of writing, Matplotlib does not provide an out-of-the-box way to animate histograms, so the code defines a `Histogram`

class to facilitate this, based on this Matplotlib example.

The particles are initialised with uniformly-random positions and a fixed speed (randomly-oriented in direction). After an initial relaxation period, their speed distribution is averaged incrementally and compared with the Maxwell-Boltzmann distribution function, $$ f(v) = \frac{mv}{k_\mathrm{B}T}\exp\left(-\frac{mv^2}{2k_\mathrm{B}T}\right). $$

```
import numpy as np
from scipy.spatial.distance import pdist, squareform
import matplotlib.pyplot as plt
import matplotlib.patches as patches
import matplotlib.path as path
from matplotlib.animation import FuncAnimation
X, Y = 0, 1
class MDSimulation:
def __init__(self, pos, vel, r, m):
"""
Initialize the simulation with identical, circular particles of radius
r and mass m. The n x 2 state arrays pos and vel hold the n particles'
positions in their rows as (x_i, y_i) and (vx_i, vy_i).
"""
self.pos = np.asarray(pos, dtype=float)
self.vel = np.asarray(vel, dtype=float)
self.n = self.pos.shape[0]
self.r = r
self.m = m
self.nsteps = 0
def advance(self, dt):
"""Advance the simulation by dt seconds."""
self.nsteps += 1
# Update the particles' positions according to their velocities.
self.pos += self.vel * dt
# Find indices for all unique collisions.
dist = squareform(pdist(self.pos))
iarr, jarr = np.where(dist < 2 * self.r)
k = iarr < jarr
iarr, jarr = iarr[k], jarr[k]
# For each collision, update the velocities of the particles involved.
for i, j in zip(iarr, jarr):
pos_i, vel_i = self.pos[i], self.vel[i]
pos_j, vel_j = self.pos[j], self.vel[j]
rel_pos, rel_vel = pos_i - pos_j, vel_i - vel_j
r_rel = rel_pos @ rel_pos
v_rel = rel_vel @ rel_pos
v_rel = 2 * rel_pos * v_rel / r_rel - rel_vel
v_cm = (vel_i + vel_j) / 2
self.vel[i] = v_cm - v_rel/2
self.vel[j] = v_cm + v_rel/2
# Bounce the particles off the walls where necessary, by reflecting
# their velocity vectors.
hit_left_wall = self.pos[:, X] < self.r
hit_right_wall = self.pos[:, X] > 1 - self.r
hit_bottom_wall = self.pos[:, Y] < self.r
hit_top_wall = self.pos[:, Y] > 1 - self.r
self.vel[hit_left_wall | hit_right_wall, X] *= -1
self.vel[hit_bottom_wall | hit_top_wall, Y] *= -1
# Number of particles.
n = 1000
# Scaling factor for distance, m-1. The box dimension is therefore 1/rscale.
rscale = 5.e6
# Use the van der Waals radius of Ar, about 0.2 nm.
r = 2e-10 * rscale
# Scale time by this factor, in s-1.
tscale = 1e9 # i.e. time will be measured in nanoseconds.
# Take the mean speed to be the root-mean-square velocity of Ar at 300 K.
sbar = 353 * rscale / tscale
# Time step in scaled time units.
FPS = 30
dt = 1/FPS
# Particle masses, scaled by some factor we're not using yet.
m = 1
# Initialize the particles' positions randomly.
pos = np.random.random((n, 2))
# Initialize the particles velocities with random orientations and random
# magnitudes around the mean speed, sbar.
theta = np.random.random(n) * 2 * np.pi
s0 = sbar * np.random.random(n)
vel = (s0 * np.array((np.cos(theta), np.sin(theta)))).T
sim = MDSimulation(pos, vel, r, m)
# Set up the Figure and make some adjustments to improve its appearance.
DPI = 100
width, height = 1000, 500
fig = plt.figure(figsize=(width/DPI, height/DPI), dpi=DPI)
fig.subplots_adjust(left=0, right=0.97)
sim_ax = fig.add_subplot(121, aspect='equal', autoscale_on=False)
sim_ax.set_xticks([])
sim_ax.set_yticks([])
# Make the box walls a bit more substantial.
for spine in sim_ax.spines.values():
spine.set_linewidth(2)
speed_ax = fig.add_subplot(122)
speed_ax.set_xlabel('Speed $v\,/m\,s^{-1}$')
speed_ax.set_ylabel('$f(v)$')
particles, = sim_ax.plot([], [], 'ko')
class Histogram:
"""A class to draw a Matplotlib histogram as a collection of Patches."""
def __init__(self, data, xmax, nbars, density=False):
"""Initialize the histogram from the data and requested bins."""
self.nbars = nbars
self.density = density
self.bins = np.linspace(0, xmax, nbars)
self.hist, bins = np.histogram(data, self.bins, density=density)
# Drawing the histogram with Matplotlib patches owes a lot to
# https://matplotlib.org/3.1.1/gallery/animation/animated_histogram.html
# Get the corners of the rectangles for the histogram.
self.left = np.array(bins[:-1])
self.right = np.array(bins[1:])
self.bottom = np.zeros(len(self.left))
self.top = self.bottom + self.hist
nrects = len(self.left)
self.nverts = nrects * 5
self.verts = np.zeros((self.nverts, 2))
self.verts[0::5, 0] = self.left
self.verts[0::5, 1] = self.bottom
self.verts[1::5, 0] = self.left
self.verts[1::5, 1] = self.top
self.verts[2::5, 0] = self.right
self.verts[2::5, 1] = self.top
self.verts[3::5, 0] = self.right
self.verts[3::5, 1] = self.bottom
def draw(self, ax):
"""Draw the histogram by adding appropriate patches to Axes ax."""
codes = np.ones(self.nverts, int) * path.Path.LINETO
codes[0::5] = path.Path.MOVETO
codes[4::5] = path.Path.CLOSEPOLY
barpath = path.Path(self.verts, codes)
self.patch = patches.PathPatch(barpath, fc='tab:green', ec='k',
lw=0.5, alpha=0.5)
ax.add_patch(self.patch)
def update(self, data):
"""Update the rectangle vertices using a new histogram from data."""
self.hist, bins = np.histogram(data, self.bins, density=self.density)
self.top = self.bottom + self.hist
self.verts[1::5, 1] = self.top
self.verts[2::5, 1] = self.top
def get_speeds(vel):
"""Return the magnitude of the (n,2) array of velocities, vel."""
return np.hypot(vel[:, X], vel[:, Y])
def get_KE(speeds):
"""Return the total kinetic energy of all particles in scaled units."""
return 0.5 * sim.m * sum(speeds**2)
speeds = get_speeds(sim.vel)
speed_hist = Histogram(speeds, 2 * sbar, 50, density=True)
speed_hist.draw(speed_ax)
speed_ax.set_xlim(speed_hist.left[0], speed_hist.right[-1])
# TODO don't hardcode the upper limit for the histogram speed axis.
ticks = np.linspace(0, 600, 7, dtype=int)
speed_ax.set_xticks(ticks * rscale/tscale)
speed_ax.set_xticklabels([str(tick) for tick in ticks])
speed_ax.set_yticks([])
fig.tight_layout()
# The 2D Maxwell-Boltzmann equilibrium distribution of speeds.
mean_KE = get_KE(speeds) / n
a = sim.m / 2 / mean_KE
# Use a high-resolution grid of speed points so that the exact distribution
# looks smooth.
sgrid_hi = np.linspace(0, speed_hist.bins[-1], 200)
f = 2 * a * sgrid_hi * np.exp(-a * sgrid_hi**2)
mb_line, = speed_ax.plot(sgrid_hi, f, c='0.7')
# Maximum value of the 2D Maxwell-Boltzmann speed distribution.
fmax = np.sqrt(sim.m / mean_KE / np.e)
speed_ax.set_ylim(0, fmax)
# For the distribution derived by averaging, take the abcissa speed points from
# the centre of the histogram bars.
sgrid = (speed_hist.bins[1:] + speed_hist.bins[:-1]) / 2
mb_est_line, = speed_ax.plot([], [], c='r')
mb_est = np.zeros(len(sgrid))
# A text label indicating the time and step number for each animation frame.
xlabel, ylabel = sgrid[-1] / 2, 0.8 * fmax
label = speed_ax.text(xlabel, ylabel, '$t$ = {:.1f}s, step = {:d}'.format(0, 0),
backgroundcolor='w')
def init_anim():
"""Initialize the animation"""
particles.set_data([], [])
return particles, speed_hist.patch, mb_est_line, label
def animate(i):
"""Advance the animation by one step and update the frame."""
global sim, verts, mb_est_line, mb_est
sim.advance(dt)
particles.set_data(sim.pos[:, X], sim.pos[:, Y])
particles.set_markersize(0.5)
speeds = get_speeds(sim.vel)
speed_hist.update(speeds)
# Once the simulation has approached equilibrium a bit, start averaging
# the speed distribution to indicate the approximation to the Maxwell-
# Boltzmann distribution.
if i >= IAV_START:
mb_est += (speed_hist.hist - mb_est) / (i - IAV_START + 1)
mb_est_line.set_data(sgrid, mb_est)
label.set_text('$t$ = {:.1f} ns, step = {:d}'.format(i*dt, i))
return particles, speed_hist.patch, mb_est_line, label
# Only start averaging the speed distribution after frame number IAV_ST.
IAV_START = 200
# Number of frames; set to None to run until explicitly quit.
frames = 1000
anim = FuncAnimation(fig, animate, frames=frames, interval=10, blit=False,
init_func=init_anim)
plt.show()
```

## Comments

Comments are pre-moderated. Please be patient and your comment will appear soon.

## Pablo 1 year, 8 months ago

Hello Christian,

Link | ReplyI believe I may have found a bug. When updating the positions of the particles, you have:

```

# For each collision, update the velocities of the particles involved.

for i, j in zip(iarr, jarr):

pos_i, vel_i = self.pos[i], self.vel[i]

pos_j, vel_j = self.pos[j], self.vel[j]

rel_pos, rel_vel = pos_i - pos_j, vel_i - vel_j

r_rel = rel_pos @ rel_pos

v_rel = rel_vel @ rel_pos

v_rel = 2 * rel_pos * v_rel / r_rel - rel_vel

v_cm = (vel_i + vel_j) / 2

self.vel[i] = v_cm + v_rel/2

self.vel[j] = v_cm - v_rel/2

```

Notice that `r_rel = res_pos @ rel_pos`, but you calculating `v_rel` differently:

```

v_rel = rel_vel @ rel_pos # shouldn't this be = rel_vel @ rel_vel ?

```

Maybe I am not understanding sth in your code (which works seemingly well despite the bug), but from a dimensionality standpoint (or naming convention consistency) I believe this may be a bug.

Let me know your thoughts, and thank you very much for the implementation!

Pablo.

## christian 1 year, 8 months ago

Hi Pablo,

Link | ReplyI think this is just my clumsy naming: the quantity I called "v_rel" is not the relative velocity (that's "rel_vel"), but rather the dot product of the relative position and relative velocity, which is the numerator in the expressions given e.g. at the end of the Wikipedia article on elastic collisions (https://en.wikipedia.org/wiki/Elastic_collision); there's a derivation of these expressions here: https://stackoverflow.com/questions/35211114/2d-elastic-ball-collision-physics if you're interested.

Glad you found it interesting!

Christian

## Moises 1 year, 6 months ago

Dear Christian,

Link | ReplyI think there is a bug. In order to recover the equation you show in the link (https://stackoverflow.com/questions/35211114/2d-elastic-ball-collision-physics) you need to change:

v_rel = 2 * rel_pos * v_rel / r_rel - rel_vel

to:

v_rel = -2 * rel_pos * v_rel / r_rel + rel_vel

Either way, please review it and if is incorrect please let me know

## christian 1 year, 6 months ago

Hello!

Link | ReplyI looked into this (I wish I had named my variables better), and I think you are right – many thanks for taking the time to get in touch. I have corrected this in the update to vel[i] and vel[j].

I've also disabled blitting because something changed in a recent Matplotlib update and it broke.

Cheers,

Christian

## JunXiang 6 months ago

what can i do change left picture, but i write homework for boltzmann distribution . i from tw english not good you can translate my word ths

Link | Reply## Eli 3 months, 2 weeks ago

Can I have a python script formaxwell distribution. I need it for my teaching class.

Link | Reply## christian 3 months, 2 weeks ago

Dear Eli,

Link | ReplyYou are welcome to use this script for your class.

Best wishes,

Christian

## Eli 2 months, 1 week ago

Hi, I run the script with Jupyter 6.4.5. but it did not show the animation. May I ask you please let me know how I can fix the issue.

Link | Reply## christian 2 months, 1 week ago

Hello Eli,

Link | ReplyIf you're running the code from within a Jupyter Notebook you probably want the

%matplotlib notebook

magic first because the default (%matplotlib inline) does not support animation.

Cheers, Christian

## Micah 2 months, 1 week ago

Hello Christian, I copied your code to try and run it myself and the animation isn't working. I just get 2 graphs at t=0, am I missing something? Do I need to input any values?

Link | ReplyThank you

Micah

## christian 2 months, 1 week ago

Dear Micah,

Link | ReplyPerhaps you're having the same problem as Eli, above?

Christian

## Micah 2 months, 1 week ago

Thank you so much that was it!

Link | Reply## Karen 4 days, 11 hours ago

Hello Cristian

Link | ReplyYour contribution is very interesting.

How could the distribution of energies be visualized?

## christian 3 days, 22 hours ago

Thanks, Karen,

Link | ReplyThe energies in this system are purely kinetic, so you can create the histogram using get_KE instead of get_speeds as the object to pass to Histogram, I think.

Best wishes, Christian

## New Comment