Skip to content
Particles simulation in python
Python Other



PyParticles is a particle simulation toolbox entirely written in python.

The main objective of PyParticles is to provide a system API simple and fast to use. Furthermore is to provide a basic application for the implementation of simple models.


PyParticles v0.3.5 tgz


Simulate a particle by particle model with the most popular integrations methods, and it represents the results on a OpenGL or Matplotlib plot.

PyParticle includes the followings integrations methods

  1. Euler method
  2. Leap Frog method
  3. Rung Kutta method
  4. Midpoint
  5. Stormer Verlet method

As a forces model it includes:

  1. Gravity
  2. Particle by Particle spring
  3. Constant
  4. User defined field
  5. Lennard Jones
  6. Drag
  7. Damping
  8. Electromagnetic fields

We have also the possibility of modeling the forces with user-defined constraints (See demo cat_spri).

PyParticle offers an easy to use class structure with a fully interchangeable integrations method or force model, it also implements the possibility to add some boundary model.


PyParticles require the following packages:

For more details about the installation visit the Blog:

Command line tool usage:

In PyParticles a simulation model is entirely described in a config file that should be edited by the user.

The following are the main command of the PyParticles application.

  • Start the demo simulation:
  • Start a simulation described in a config file
pyparticle_app <file_name>
  • Start the specified demo simulation
springs 3 body springs
solar_system Simulation of the solar system with realistic magnitudes
bubble Bubbles. With a non realistic force
cat_spri Vibrating string with gravity and air drag
gas_lj Lennard jones gas model (should be improved)
elmag_field Electromagnetic field
fountain 250'000 particles fountain
pyparticles_app --demo springs
pyparticles_app --demo solar_system
pyparticles_app --demo bubble
pyparticles_app --demo cat_spri
pyparticles_app --demo gas_lj
pyparticles_app --demo elmag_field
pyparticles_app --demo fountain
  • Start a testing procedure

Execute the specified test:

pyparticles_app --test harmonic
pyparticles_app --test fall
  • Write out a model config file
pyparticle_app -m
  • Print out the help and version
pyparticles_app --help
pyparticles_app --version

During the simulation you can toggle the help message by pressing h

Config file Example:

media_origin = from_file
file_name = solar_sys.csv

len_unit = 149597870700.0
mass_unit = 5.9736e24
boundary = open

force = gravity
ode_solver_name = euler
time_step = 3600
steps = 1000000
force_const = 6.67384e-11
force_vector = 0 0 0

animation_type = opengl
xlim = -5.0  5.0
ylim = -5.0  5.0
zlim = -5.0  5.0
Something went wrong with that request. Please try again.