= Taipei School on !MadGraph for LHC Physics =

[http://phys.cts.ntu.edu.tw/workshop/2012/1010525LHC/default.aspx? Link to the official school website]

 == Lectures and tutorials ==
 * [attachment:NTU-MG5-lectures.pdf Lectures] and [attachment:NTU-MG5-tutorial.pdf tutorial] on Event generation with !MadGraph 5
 * [attachment:NTU-MLM-lectures.pdf Lectures] on Parton Showers and MLM Matching
 * [attachment:FR_Taiwan_2012_1_part_1.pdf Lecture 1], [attachment:FR_Taiwan_2012_1_part_2.pdf Lecture 2] and [attachment:Taipei_Tutorial.tar.gz tutorial files] on !FeynRules

 == Installation of the needed software ==

In order to be efficient during the time of the school, we would like to ask you to install all the software packages that you will need during the school in advance. 
If you have any difficulties, please contact Olivier Mattelaer at the following address: olivier.mattelaer__AT__uclouvain.be or Johan Alwall at jalwall__AT__ntu.edu.tw.

 === 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

 === Linux ===

1. '''Basic requirements'''
  * perl
  * bash
  * gfortran 4.x (To check the version do gfortran do: gfortran --version)
  Those programs are by default present in any linux distribution, 
  but just in case you should check that they are all installed in your computer. If they are not, 
  you can use apt-get/yum/... in order to have those.

2. '''Madgraph 5'''
  * '''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.
  * '''Root''' [[BR]]
    Root is require, in order to make some of the plots in !MadEvent.
    Except if you are in SLC4 or SLC5 distribution, you will need to install root from scratch on your computer.
    The current last verstion of Root is 5.30, which you can download from here: ftp://root.cern.ch/root/root_v5.30.02.source.tar.gz
    After Un-packing, follow the instruction of the file README/INSTALL.
    Finally you should edit the file ~/.bashrc, by adding the following line into it
{{{
    export ROOTSYS=PATH_TO_YOUR_UNPACK_DIRECTORY
    export PATH=$PATH:$ROOTSYS:$ROOTSYS/bin
}}}


3. '''Pythia/pgs/MadAnalysis'''
   In order to install those programs, you need to launch mg5 (./bin/mg5) and then type
{{{
   install pythia-pgs
   install MadAnalysis
}}}

4. '''!FeynRules'''
   * '''Mathematica''' 
     This program is NOT free, but your university should have the possibility to provide a license for you. Please contact your IT team.
   * '''!FeynRules'''
     Please download the Feynrule package (mathematica package): http://feynrules.irmp.ucl.ac.be/downloads/feynrules-current.tar.gz

 === !MacOs ===

1. '''Basic requirements'''
  * 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. We never test this python version with MG5 but in principle it should be fine.
    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.
  * '''Root''' [[BR]]
    Root is require, in order to make some of the plots in !MadEvent.
    a. for !MacOs 10.5, you can install this version: ftp://root.cern.ch/root/root_v5.26.00.macosx105-i386-gcc-4.0.tar.gz
       After unpacking the directory. you will need to performed the two following action in the terminal
{{{
cd
emacs .bash_profile
}}} 
    The last command will open a terminal, add in this file the following line:
{{{
    export ROOTSYS=PATH_TO_YOUR_UNPACK_DIRECTORY
    export PATH=$PATH:$ROOTSYS:$ROOTSYS/bin
}}}
    In order to exit the emacs editor, you need to do CTRL-X CTRL-S (this will save your modification) and after CTRL-X CTRL-C. Finally in your terminal you will need to type
{{{
    source .bash_profile
}}} 
    b. for !MacOs 10.6 (and maybe 10.7), you can install this version: ftp://root.cern.ch/root/root_v5.30.02.macosx106-i386-gcc-4.2.tar.gz .Then follow the instruction for !MacOs 10.5.
    c. Otherwise, you will need to install from the source: ftp://root.cern.ch/root/root_v5.30.02.source.tar.gz
    After Un-packing, follow the instruction of the file README/INSTALL.
    
    If the installation is successful, you will need to have root working. In order to test it type '''root''' in the terminal. If it's not fine, please install it from Source.



3. '''Pythia/pgs/MadAnalysis'''   
   In order to install those programs, you need to launch mg5 (./bin/mg5) and then type
{{{
   install pythia-pgs
   install MadAnalysis
}}}


4. '''!FeynRules'''
   * '''Mathematica''' 
     This program is NOT free, but your university should have the possibility to provide a license for you. Please contact your IT team.
   * '''!FeynRules'''
     Please download the Feynrule package (mathematica package): http://feynrules.irmp.ucl.ac.be/downloads/feynrules-current.tar.gz