PyParticles is a particle simulation toolbox entirely written in python 3.
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.
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
- Euler method
- Leap Frog method
- Rung Kutta method
- Midpoint
- Stormer Verlet method
As a forces model it includes:
- Gravity
- Particle by Particle spring
- Constant
- User defined field
- Lennard Jones
- Drag
- Damping
- 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.
For more details about the installation visit the Blog: http://pyparticles.wordpress.com/installation/
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:
pyparticles_app
- Start a simulation described in a config file
pyparticle_app <file_name>
- Start the specified demo simulation
| Demos | |
|---|---|
| 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:
[pset_origin] media_origin = from_file file_name = solar_sys.csv [set_config] len_unit = 149597870700.0 mass_unit = 5.9736e24 boundary = open [model] force = gravity ode_solver_name = euler time_step = 3600 steps = 1000000 force_const = 6.67384e-11 force_vector = 0 0 0 [animation] animation_type = opengl xlim = -5.0 5.0 ylim = -5.0 5.0 zlim = -5.0 5.0