Installation instructions and pre-workshop exercises
Instructions for the on-site exercise
Final result from the on-site exercise 

[http://www.phys.ufl.edu/~matchev/mc4bsm6/ Links to all tutorial presented at the MC4BSM conferences]


 == Installation instructions and pre-workshop exercises ==

 === Install on Windows ===
The different program are foreseen to run on !Linux/Mac. If you don't have Linux or Mac, the best solution is to install Linux (I would advice to install Ubuntu) in dual boot and follow the instructions for Linux.
This video might help you to do so: http://video.google.com/videoplay?docid=-2369893842637434537
virtual machine are fine, but quite often the library readline is not present on the system. This package is not mandatory but allozs mg5 to have history and nice auto-completions.
So you might consider to install that library first and the compile python2.6.


 === Install on Linux ===

  * '''python 2.6/2.7'''[[BR]]
    !MadGraph 5 requires python 2.6 or python 2.7. In order to check your version of python, you can type:
    python --version. Some of the repositories are still on python 2.5. So if updating python via your repository manager didn't work.
    you can download directly python from the following link:
    http://www.python.org/download/
    and follow instructions.
  * '''Madgraph5'''[[BR]]
    You will find madgraph5 package on the following page:  https://launchpad.net/madgraph5.
    For this program, you just need to untar it. 
    To check if mg5 is correctly install you directly try to run it by doing:
    ./bin/mg5
    If you don't have a valid python version. It will fail directly.
  * '''MadAnalysis'''[[BR]]
    This programs is not mandatory but allows to have partonic distributions done automatically.
    In order to install this program, you need to launch mg5 (./bin/mg5) and then type
{{{
   install MadAnalysis
}}} 

 === Install on !MacOs ===

1. '''Basic program'''
  * perl 
  * bash [[BR]]
  Those programs are by default present in any Mac distribution, 
  but just in case you should check that they are all installed in your computer (by doing perl --version). 
  * gmake [[BR]]
  By default, makefile are not recognize on mac. In order to check, you can do 'make --version'. If it says:
  -bash: make: command not found
  then you should install it. The easiest is to install the xcode.
     1. For !MacOs 10.5: https://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=20414
     2. For !MacOs 10.6: http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=20792
     3. For !MacOs 10.7: http://itunes.apple.com/us/app/xcode/id448457090?mt=12
  In order to be able to download it, you will need to a apple developer account (which is free)
  * gfortran 4.x (To check the version do gfortran do: gfortran --version)
  This program is often not included in standard mac version. In order to download it, you can download it from:
    a.  http://prdownloads.sourceforge.net/hpc/gcc-lion.tar.gz?download for !MacOs 10.7
    b.  http://prdownloads.sourceforge.net/hpc/gcc-snwleo-intel-bin.tar.gz?download for !MacOs 10.6
    c.  http://sourceforge.net/projects/hpc/files/hpc/gcc/gcc-leopard-intel-bin.tar.gz/download for !MacOs 10.5

2. '''!MadGraph5'''
  * '''python'''
    a. The default python version of !MacOs 10.6 is python 2.6 and is (in 99% of the case) fully working with Madgraph5, so nothing to install for you.
    b. The python version of !MacOs 10.7 is python 2.7. And this one works perfectly, so nothing to install for you.
    c. For other version of MacOS, you will need to install python2.7 from the python web site: http://www.python.org/download/
  * '''Madgraph5'''[[BR]]
    You will find madgraph5 package on the following page:  https://launchpad.net/madgraph5.
    For this program, you just need to untar it. 
    To check if mg5 is correctly install you directly try to run it by doing:
    ./bin/mg5
    If you don't have a valid python version. It will fail directly.
  * '''MadAnalysis'''[[BR]]
    This programs is not mandatory but allows to have partonic distributions done automatically.
    In order to install this program, you need to launch mg5 (./bin/mg5) and then type
{{{
   install MadAnalysis
}}} 

 === pre-workshop exercises ===
  As a pre-workshop exercises and a proof that the full instalation is succesfull. 
  Please launch mg5
  ./bin/mg5
  and type the following command:
{{{
   tutorial
}}} 
  and follow the tutorial instructions on the screen.


 == Instructions for the on-site exercise ==

   * If you don't have run the tutorial before the lectures please do it now.
     Please launch mg5
     ./bin/mg5
     and type the following command:
{{{
   tutorial
}}} 
     and follow the tutorial instructions on the screen.

   * The exercice of this tutorial is to 
     1. Use the model generatedby Feynrules
     2. generate $ p p \to U \bar U $
     3. generate some events
     4. pass the events to Pythia
     5. Restart the chain but this time by including all the decay chain in MG5.

     Note that in order to have the correct cross-sections in the second cases or to have the correct branching ratio computed by Pythia in the first case, we need first to compute the width and the branching ratio of the non standard model particles. 
 
  * '''The model'''[[BR]]