Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/edibotopic/stokes-law

Interactive 2D simulation of Stokes' Law, which describes how particles float/sediment in solvent. Subject of paper in the Journal of Chemical Education: https://pubs.acs.org/doi/10.1021/acs.jchemed.2c01201
https://github.com/edibotopic/stokes-law

animation canvas food motion particles physics physics-simulation science simulation

Last synced: 7 days ago
JSON representation

Interactive 2D simulation of Stokes' Law, which describes how particles float/sediment in solvent. Subject of paper in the Journal of Chemical Education: https://pubs.acs.org/doi/10.1021/acs.jchemed.2c01201

Awesome Lists containing this project

README 

        
# Stokes' Law Simulation



This is an interactive simulation of Stokes' Law, which is used by scientists and engineers to approximate the velocity of sedimentation (or flotation) for particles dispersed in a solvent.



The purpose of the simulation is to provide a visual tool for developing an intuition for the equation and the behaviour it describes, especially for students who are unfamiliar or uncomfortable with mathematics.



## Basic Principles



A particle will sediment if it is more dense than the solvent it is suspended in. If it is less dense than the solvent then it will float.



Stokes' Law is commonly used to calculate the average velocity of a population of particles as influenced by physical properties of the particles and solvent:



![Equation for Stokes' Law](./img/equation_light.png#gh-light-mode-only)

![Equation for Stokes' Law](./img/equation_dark.png#gh-dark-mode-only)



$D$ is the diameter of the particle, $ρ_p - ρ_s$ represents the difference in density between particle and solvent, while $μ$ is the viscosity of the solvent. The $g$ represents gravitational acceleration, which can be multiplied by an appropriate g-force when separation in a centrifuge is of interest.



In the application the units for the physical quantities are taken to be:



- Radius ($mm$)

- Density ($kg/m^3$)

- Viscosity ($Pa.s$)

- Velocity ($m/s$)



The default centrifugal force is $1$ (no centrifugation) meaning

that acceleration due to gravity ($1 \times 9.81 \ m/s^2$) applies.

Applying a centrifugal force of $2$ will double this value.



Note: the units can be viewed at any time by hovering over the sliders or

clicking on the variable name (mobile).

On mobile, clicking anywhere else on the screen after a tooltip appears will remove the tooltip.



## Practical Significance



Manipulating the physical variables in this equation is the basis of commercial strategies to both promote separation (centrifugation) or reduce separation (homogenisation).



In food, for example:



- Centrifugation is used to promote the flotation of oil droplets in the separation of cream

- Homogenisation is used to reduce the size of oil droplets in beverages and thereby decrease their flotation speed

- Thickeners are added to salad dressings to increase viscosity and slow the sedimentation of herbs and spices



In analytical science, re-arranging the Stokes' Law equation allows for estimation  of particle size or viscosity based on sedimentation data.



A variety of other industrial and scientific examples can be found in the literature.



## Implementation



The simulation is coded using vanilla JavaScript, with particles rendered using the HTML `` element.



Sliders can be used to modify the variables of Stokes' Law and observe the changes in real-time.



Buttons are provided to *restart* the simulation, show a brief *about* popup and access the *source* code.



The application is deliberately minimal and simple so that students can interact with it quickly and easily.



The code is made available under an MIT license and educators are free to copy and modify the code themselves.



As the application is served as a single `index.html` page it can be easily embedded as an iframe in web-based notes and slides, in addition to Learning Management Systems like Canvas.

It can also be downloaded onto your device and then run locally by opening `index.html` (inside the `stokes-law` folder) in a browser.



## Release Notes



1.1.0



Statistical output added:



- Graph readout of velocity over time

- Numerical output of mean velocity, diameter and the density difference

- Addition of a copy button for embedding in LMS



1.0.0



Basic implementation complete:



- Simulation of particles with velocity determined by Stokes' Law

- Manipulation of particle and solvent properties using sliders

- Minimal UI with reset, about and source buttons



## Future Plans



As of 1.0.0 the application is considered feature-complete.



Beyond that, I will mainly be focusing on minor bug fixes and quality-of-life improvements and do not foresee major changes.



If you have any suggestions please file an *issue*, raise a *pull request* or send me an email at [email protected].