A Julia package for dynamical billiard systems in two dimensions.
The goals of the package is to provide a flexible and intuitive framework for fast implementation of billiard systems of arbitrary construction.
The core of
DynamicalBilliards.jl is separated in simple and cohesive modular structures:
- Straight propagation : The standard billiard dynamical system. A particle is propagating in a straight line, until a specular reflection is performed at a boundary.
- Magnetic propagation : Instead of a straight line, the orbit of the particle is a circle, like electrons in a perpendicular magnetic field. The particle still undergoes specular reflections at the boundaries of the billiard.
- Ray-splitting billiards : A semiclassical implementation of the dynamical billiard. After a collision of a particle with a boundary, the particle may propagate through the boundary given some arbitrary probability and transmission law.
- Standard billiards : A library of pre-constructed billiard systems that have already been used in Physics/Mathematics (e.g. Sinai, periodic Sinai, Buminovich etc.)
- Visualization : Functions for plotting and visualizing aspects of a billiard system, such as obstacles, orbits and more. Also includes animation related content.
- Lyapunov Spectrum : Calculate the lyapunov spectrum of the trajectory of a particle in an arbitrary billiard table. Currently this is only available for
NOTICE: This package does not support collision between particles (currently), since
all particles are considered point-particles.
This package is registered, simply use
Pkg.add("DynamicalBilliards") to install it.
The master branch of
DynamicalBilliards is used for development purposes. It is not advised to use
Pkg.checkout("DynamicalBilliards"), unless you want to contribute to the development of the package.
DynamicalBilliards is done through the
PyPlot package. However, all plotting-related functions are not available by default but only "on-demand". Use
DynamicalBilliards.enableplotting() to bring them into scope.
WARNING: You must be able to
using PyPlot if you want to use the plotting capabilities of
DynamicalBilliards! If you are having trouble installing
PyPlot you can always use the minimal Python installation through miniconda by running these lines in your Julia terminal:
ENV["PYTHON"]=""; Pkg.add("PyCall"); Pkg.build("PyCall");
Pkg.add("PyPlot"); using PyPlot;
This package is mainly developed by George Datseris. However, this development would not have been possible without significant help from other people:
- David. P. Sanders (@dpsanders) contributed in fruitful discussions about the programming and physics of Billiard systems all-around, as well as provided some reference code for the "straight-propagation" billiards.
- Christopher Rackauckas (@ChrisRackauckas) helped set-up the continuous integration, testing, documentation publishing and all around package development-related concepts.
- Tony Kelman (@tkelman) helped significantly in the package publication process, especially in making it work correctly without destroying METADATA.jl.
- Diego Tapias (@dapias) Contributed the lyapunov spectrum calculation methods.