The Particle Windchime is written using the processing programming language. One very nice feature, is that it can create a transferable application (using Java) for different platforms.


When you have downloaded the .zip file, uncompress it using the tool of your choice (unzip, StuffIt). This creates a directory called app_ppw_2D_<OS> or app_ppw_3D_<OS>, where OS is the operating system (linux, macosx or windows). Running the app is slightly different, depending on your Operating System (OS):

  • Linux
    • Go into this directory and run the executable.
    • cd app_ppw_2D_linux
    • ./ppw_2D
  • Mac OSX
    • Go into the app_ppw_2D_macosx/app_ppw_3D_macosx directory.
    • In here, you should see an Application (actually it’s directory) called (or Double click on the icon/name to run the program.
  • Windows
    • Go into the app_ppw_2D_windows/app_ppw_2D_windows directory.
    • In here, you should see an executable called ppw_2D (or ppw_3D). Double click on the icon/name to run the program.

Using the Particle Physics Windchime

  • Run it!
    • Select a file using the Select a File dropdown menu at the top.
      • Note that these files represent simulations of different particle physics processes.
    • Press Play.
  • Change it!
    • Try different files (physics processes). Do they look/sound different?
    • Try different Mappings using the Mapping drop down menu at the top.
      • These are presets that take different particle physics/detector properties and map them onto the sonic characteristics.
    • Change the speed using the Tempo slider in the lower-left.
    • In the 3D version, you can change the view using the mouse and the mouse buttons (PeasyCam libraray in processing).
      • Left button: rotate
      • Middle button: translate
      • Right button: zoom

Feature Requests & Known Bugs

  • Wishlist: the purple dropdown menus will be enabled in a future release so that you can select your own sonic mappings.
  • Known bug: The text is sometimes blurry on the GUI in the 3D app. This is a known issue related to my using the P3D renderer. The problem goes away if I use the OPENGL renderer, but with that, I get some crashes. It could be related to my Linux/Java installation.


Thanks to everyone who helped on this project during the Science Hack Day SF. Not just our group of developers, but the organizers of the event itself. This project makes use of the following tools: