Introduction

• Install G4MICE (including downloading pre-compiled copies of the external libraries, setting up your environment, checking code out from CVS and compiling it).
• Run a number of the applications as an introduction to how G4MICE can be used for simulation, reconstruction and analysis tasks.
• Find online documentation on G4MICE, in particular how to control program execution through use of data cards and how experimental setups can be defined with the MiceModules scheme.

Operating Systems

Since Sunday 10th May 2009, the code in CVS has been updated to comile with the new version of g++, GEANT4, etc.

Package	Linux	Source
compiler	gcc 4.3.2	GCC website
CLHEP	2.0.4.2	CLHEP website
GEANT4	9.2.p01	GEANT4 website
ROOT	5.22.0	ROOT website
GSL	1.12	GSL website
RecPack	24th April 2009	Source code tarball
Operating System	External Libraries	Setup Script
Linux	extlibs.gcc4.3.2.linux.tgz	setupmice.csh

1 Select an area of disk in which to store the external libraries, G4MICE source code, etc. You will need about 2 Gig of space in order to compile and build all the executables and still have some room to run some simple applications. For the purposes of this guide we will assume that the username is bloggs and that their home directory is in /home/bloggs and that there is another area called /large_disk/ in which they have a directory called bloggs.

2 In this area, create a directory called mice:

/home/bloggs > cd /large_disk/bloggs/

/large_disk/bloggs > mkdir mice

3 From your home directory, make a link to this new mice directory:

/large_disk/bloggs > cd

/home/bloggs > ln s /large_disk/mice ./

Note! If you have lots of space in your home directory and don't need to put the software elsewhere (for example, if you are running under cygwin on a windows system with one large disk), then the 3 steps above can be replaced with the following two commands:

/some/other/path > cd

/home/bloggs > mkdir mice

4 Download the micesetup.csh and the external library tarball into this mice directory from the links in the table above (choose the one appropriate to your operating system). If you find it easier, instead of selecting the links above, you can always use the wget command. For example:

/some/other/path > cd ~/mice/

/home/bloggs/mice > wget http://www.mice.iit.edu/software/DataChallenge/Downloads/linux/extlibs.gcc4.3.2.linux.tgz

/home/bloggs/mice > wget http://www.mice.iit.edu/software/DataChallenge/Downloads/linux/setupmice.csh

5 Unpack the tarball with the command tar xvzmf . An example of this might be tar xvzmf linux_extlibs.tgz. This will create a directory called gcc4.3.2 inside of which you will find the compiler and all the external libraries listed above:

/home/bloggs > cd mice

/home/bloggs/mice > tar xvzmf extlibs.gcc4.3.2.linux.tgz

/home/bloggs/mice > rm -f extlibs.gcc4.3.2.linux.tgz

6 Edit the setupmice.csh file and modify it according to the comments in the file. This should only require a modification if you have installed the code somewhere other than the location listed in steps 1-3 or if you wish to use your own CVS account on the IIT server (instead of logging in to it anonymously). If you are using your own CVS account, you will need to issue a cvs login command after step 7 and/or ensure there is a correct entry in the .cvspass file in your home directory.

7 Source the script (source setupmice.csh or source setupmice.sh). This should result in 8 lines of output confirming the versions of the compiler an external packages that you are using. An example under Linux is reproduced below:

Installed MICE Environment
Linux setings:
Compiler gcc4.3.2
GEANT4 version 4.9.2.p01
CLHEP version 2.0.4.2
ROOT version 5.22.0
GSL version 1.12
UNPACKING version 2.0
RecPack version 20090424

Note! Every time that you open up a new shell or login to your account you will need to source this script, if not, then the code will not compile or run!

9 You are now ready to install G4MICE:

/where/ever/you/are/ > cd ~/mice/

/home/bloggs/mice > cvs co -r mice-2-2-0 MICE

/home/bloggs/mice > cd MICE/mgr

/home/bloggs/mice/MICE/mgr > make

Congratulations! G4MICE is now installed and ready to run. Nb: this will install the latest release version of G4MICE, version mice-2-2-0.

Successful Installations

Person	Operating System	Computer	Comments
Aron Fish	Linux	lx cluster at Imperial
Aron Fish	Mac OS X	Laptop
Malcolm Ellis	Cygwin	Laptop	Twice: on a DELL latitude D810 and D830
Malcolm Ellis	Linux	muons.brunel.ac.uk
Paul Kyberd	Linux	muons.brunel.ac.uk	Taking external packages from Malcolm
Tamas Sashalmi	Linux	Imperial College machine	Compiled using gcc 4.x on a 64 bit machine
Ken Long	Linux	lx cluster at Imperial	An Actual Professor! Taking external packages from Aron
Terry Hart	Linux	IIT
Ben Freemire	Linux	IIT
Michael Wojcik	Linux	IIT
Chris Rogers	Linux	RAL	64 bit
David Forrest	Linux	Glasgow University
Mark Rayner	Linux	Oxford University
Yordan Karadzhov	Linux	Sofia University
Rikard Sandstrom	Linux	Geneva University
Mary-Anne Cummings	Cygwin	Laptop	Work on the MANX experiment

A note about building recpack - to build recpack, I did: ./autogen.sh; ./autogen.sh; make; ar cru librecpack.a *.o */*.o - note that I also had to fix a typo in one of the source files (something like hv not defined). Urk! What a mess.