Running

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 ppw_2D.app (or ppw_3D.app) 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

Coming soon!

The purple dropdown menus will be enabled in a future release so that you can select your own sonic mappings.

Known bugs

The purple dropdown menus don't do anything right now. They're just placeholders.

The text is 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.