Your machine must be running Mavericks (10.9.5) or above.

Installation:

1. Remove any old installation of G4beamline; if it is older than 2.17b you must also remove its data files (you may rename them to other directory names to preserve old versions). If they are installed in the usual places, these are: /Applications/G4beamline.app and $HOME/Geant4Data
2. Install the new version of G4beamline. Download this file, open it, and drag the G4beamline application into /Applications (you may drag it from there into the dock). G4beamline-3.01.dmg
3. Be sure you have a working version of Root installed. If you don't, download and install this: root_v5.34.28.macosx64-10.9-clang60.tar.gz.
4. Install MuSim. Download this file, open it, and drag the MuSim application into /Applications (you may drag it from there into the dock) MuSim-beta.7.dmg
5. Eject the drives mounted above. You will not need the downloaded files any more.
6. Run MuSim (from /Applications or the Dock). You will need the license information from the email inviting you to join the beta test.
7. Then the Setup Wizard will run; it should find G4beamline and Root if any of these are true: a) they are in your PATH, b) they are installed in the same directory as MuSim, c) ROOTSYS is set. Otherwise you can enter their path manually. If you ran MuSim from beta.2 thru 6, then the startup wizard might not run; run it from the Tools menu.
8. Once MuSim is configured, a good thing to do is to open the Help window and move it off to the side.
9. A good place to start is with File/Examples — you can open any of them and run them.

Note you need a license in order to participate in the beta test; the license will be specialized to your machine when it is installed — the license permits you to run MuSim on two machines (any OS). Contact Tom Roberts if you would like to participate.

Note: MuSim requires G4beamline, and it must be version 3.01 below. MuSim also requires Root; on Mac and Linux any version will do, but on Windows it must be the version below.

G4beamline 3.01

This is a new version of G4beamline, built using a new technique. Its primary change is that Java has been completely removed. All programs are now C++ executables — basically the code that had been in shell scripts and Java has been ported to C++ and moved into the executables themselves (g4bl, g4blgui, and g4bldata).

Mac OS X

[+]

Linux

[+]

Windows

[+]

Note you need a license in order to participate in the beta test; the license will be specialized to your machine when it is installed — the license permits you to run MuSim on two machines (any OS). Contact Tom Roberts if you would like to participate.

At present, only Mac OS X and Linux are supported. Windows is coming.
NOTE:G4beamline is required by MuSim, and it must be the version below (2.17c).

Mac OS X

Your machine must be running Mavericks (10.9.5) or above.

Installation:

1. You need the most recent version of Java. Get it from https://www.java.com/en/download/mac_download.jsp?locale=en Note there are older versions masquerading as "the most recent", in particular one from an apple website — DO NOT BE FOOLED.
2. Java must be configured via the Terminal app. Run Terminal and type "java -version" followed by <CR>, if it does not start 'java version "1.8.0_40"' then you must do the following: edit $HOME/.bash_profile and insert this line at the end: export JAVA_HOME="/Library/Internet Plug-Ins/JavaAppletPlugin.plugin/Contents/Home" (keep the "") — Then close the Terminal window and open a new one.
3. Remove any old installation of G4beamline; if it is older than 2.17b you must also remove its data files (you may rename them to other directory names to preserve old versions). If they are installed in the usual places, these are: /Applications/G4beamline.app and $HOME/Geant4Data
4. Install the new version of G4beamline. Download this file, open it, and drag the G4beamline application into /Applications (you may drag it from there into the dock). G4beamline-2.17c.dmg
5. Run G4beamline to install its data files. You need at least the first six datasets. If G4beamline does not start, and you see some Java Exception in a terminal window, then you forgot to do steps 1 and 2 above, or they failed somehow. Talk to Tom Roberts for assistance.
6. Be sure you have a working version of Root installed. If you don't, download and install this: root_v5.34.28.macosx64-10.9-clang60.tar.gz.
7. Install MuSim. Download this file, open it, and drag the MuSim application into /Applications (you may drag it from there into the dock) MuSim-beta.3.dmg
8. Eject the drives mounted above. You will not need the downloaded files any more.
9. Run MuSim — execute MuSim-beta.3/bin/MuSim. You will need the license information from the email inviting you to join the beta test.
10. Then the Setup Wizard will run; it should find G4beamline and Root if any of these are true: a) they are in your PATH, b) they are installed in the same directory as MuSim, c) ROOTSYS is set. Otherwise you can enter their path manually. If you ran MuSim from beta.2, then the startup wizard might not run; run it from the Tools menu.
11. Once MuSim is configured, a good thing to do is to open the Help window and move it off to the side.
12. A good place to start is with File/Examples — you can open any of them and run them.

Linux

The version of Linux must be reasonably recent and 64-bits.

Known bug: G4beamline emits a bogus error message about file 'iostream' not being opened; ignore it.

1. You need a recent version of Java.
2. Remove any old installation of G4beamline; if it is older than 2.17b you must also remove its data files (you may rename them to other directory names to preserve old versions).
3. Install the new version of G4beamline. Download this file nd un-tar it into $HOME (tar -xzf G4beamline-2.17c-Linux64.tgz). G4beamline-2.17c-Linux64.tgz
4. Run G4beamline to install its data files (G4beamline-2.17c/bin/g4blgui). You need at least the first six datasets. If G4beamline does not start, and you see some Java Exception, talk to Tom Roberts for assistance.
5. Be sure you have a working version of Root installed. If you don't, download and install this: root_v5.34.26.Linux-slc5_amd64-gcc4.3.tar.gz.
6. Install MuSim. Download this file, and un-tar it in $HOME (tar -xzf MuSim-beta.3.tgz) MuSim-beta.3.tgz
7. Run MuSim — execute MuSim-beta.3/bin/MuSim. You will need the license information from the email inviting you to join the beta test.
8. Then the Setup Wizard will run; it should find G4beamline and Root if any of these are true: a) they are in your PATH, b) they are installed in the same directory as MuSim, c) ROOTSYS is set. Otherwise you can enter their path manually. If you ran MuSim from beta.2, then the startup wizard might not run; run it from the Tools menu.
9. Once MuSim is configured, a good thing to do is to open the Help window and move it off to the side.
10. A good place to start is with File/Examples — you can open any of them and run them.

Ubuntu Users (and possibly others)

Some Linux distributions do not include the specific versions of libraries that MuSim and G4beamline were built with. If either program fails to run with an error message indicating shared library problems, do the following:

1. Download this file and un-tar it in $HOME (tar -xzf LinuxCompatibilityLibs.tgz) LinuxCompatibilityLibs.tgz
2. Put the following line into your .bash_profile, then log out and re-login: "export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$HOME/LinuxCompatibilityLibs" (omit the ""). If you use some shell other than bash, do the corresponding thing.

If problems persist, talk to Tom Roberts for guidance.

Note you need a license specific to your machine in order to participate in the beta test. Contact Tom Roberts if you would like to participate.

At present, only Mac OS X is supported. Linux and Windows are coming.
NOTE:G4beamline is required by MuSim, and it must be the version below.

Mac OS X

Your machine must be running Mavericks (10.9.5) or above.

Installation:

1. You need the most recent version of Java. Get it from https://www.java.com/en/download/mac_download.jsp?locale=en Note there are older versions masquerading as "the most recent", in particular one from an apple website — DO NOT BE FOOLED.
2. Java must be configured via the Terminal app. Run Terminal and type "java -version" followed by <CR>, if it does not start 'java version "1.8.0_40"' then you must do the following: edit $HOME/.bash_profile and insert this line at the end: export JAVA_HOME="/Library/Internet Plug-Ins/JavaAppletPlugin.plugin/Contents/Home"
3. Remove any old installation of G4beamline, including its data files (you may rename them to other directory names to preserve old versions). This includes the old Geant4Data. If they are installed in the usual places, these are: /Applications/G4beamline.app and $HOME/Geant4Data
4. Install the new version of G4beamline. Download this file, open it, and drag the G4beamline application into /Applications (you may drag it from there into the dock). G4beamline-2.17b.dmg
5. Run G4beamline to install its data files. You need at least the first six datasets. If G4beamline does not start, and you see some Java Exception in a terminal window, then you forgot to do steps 1 and 2 above, or they failed somehow. Talk to Tom Toberts for assistance.
6. Install MuSim. Download this file, open it, and drag the MuSim application into /Applications (you may drag it from there into the dock) MuSim-beta.2.dmg
7. Eject the drives mounted in steps 4 and 6. You will not need the downloaded files any more.
8. Run MuSim. You will need the license information from the email inviting you to join the beta test.
9. You will be prompted for a place to put the default library. /Users/YourLogin/MuSimLibrary is a good choice.
10. Configure G4beamline into MuSim. Do this by going to the menu item MuSim/Preferences and selecting the SimPrograms tab. Set the first Name to "G4beamline-2.17b", leave the SimDef blank, and set the Path to "/Applications/G4beamline.app/Contents/Resources/bin/g4bl". Close the Preferences window.
11. Once MuSim starts up, a good thing to do is to open the Help window and move it off to the side. A good place to start is with File/Examples — you will be prompted to install them in some writable directory (e.g. $HOME/MuSimExamples); then you can open any of them and run them.

Note that once the beta test is up and running, we'll implement an automatic scan for SimPrograms so that MuSim will easily and quickly find them.