This page introduces "JIM" (Full Detector Simulation Program for the JLC physics analysis) and related softwares.
JIM Home Page in Japanese is also prepared (under construction).
"JIM" is "Full Detector Simulation Program for the JLC physics analysis", which is based on the description of the JLC green report. At present, "JIM" can simulate the following detector components.
The "JLCSIM" package distributed on this page includes the following components:
There is a mailing list for discussion and announcement about "JIM". In order to subscribe the JIM mailing list, please send an e-mail to "email@example.com" with
subscribe jimin its text field. Address of the list itself is
Please download jlcsim.tar.gz (700kB) and expand the package as
zcat jlcsim.tar.gz | tar xvf -or, in case your tar command supports z option
tar zxvf jlcsim.tar.gzThen under the top directory of jlcsim, please execute the imboot command as:
cd jlcsim ./bin/imbootwhich makes all related libraries, programs and JIM.
This installation procedure is only tested on
After above installation procedure, an executable module of JIM should be located under jim/src directory. There is a very simple template script, run_jim, in the same directory. Within this distribution package, there is also an example directory where some sample scripts are prepared. This JIM module can be executed by these commands.
"JIM" requires some input FFREAD cards from standard input.
JIM can accept various kind of input 4-vectors as its input. User can select input source by the GEN data card as:
Possible input sources are described below:
Generates e+e- -> hadrons with the JETSET74 generator of CERNLIB. CMS energy is given by the first parameter of GENP data card.
GEN 'LUND' GENP 250.gives hadronic events at ECM=250 GeV.
Generates top quark pair productions with the JETSET74 generator. CMS energy is also given by the first parameter of GENP data card. Default mass of the top quark is set as 174 GeV, which can be changed by the second parameter of GENP CARD.
GEN 'TOP' GENP 500. 175.gives top quark pair events at ECM=500 GeV with mtop=175 GeV.
Generates Higgs events by PYTHIA (MSEL =16). CMS energy is given by the first parameter of GENP data card. Default mass of the Higgs particle is set to 120 GeV, which can be changed by the second parameter of GENP CARD.
GEN 'HIGGS' GENP 250. 130.gives top quark pair events at ECM=250 GeV with mHiggs=130 GeV.
Generates a single particle for debugging use. The first parameter of GENP data card gives momentum of generated particles. If it is given in negative value, it gives their transverse momentum. The second parameter gives their JETSET particle code.
If |CODE|<1000, particles are generated to the fixed direction, which is given by the third (theta in degree) and fourth (phi in degree) parameters. If |CODE|>1000, then particles are uniformly generated in the central region which is limited by a veto angle, the third parameter (in degree).
GEN 'SINGLE' GENP 10. 11. 45. 180.gives electrons with 10 GeV generated into theta=45 degrees and phi=180 degrees.
GEN 'SINGLE' GENP 5. -1013. 60.gives positive muons with 5 GeV generated uniformly in the central region from 60 to 120 degrees.
Generates multi particles for debugging use. The following list shows the possible GENP parameters:
Read 4-vectors form a file given by VECI data card.
In order to speed up execution time, some of calorimetric detectors have smearing mode in "JIM". This mode can be given by SIMD data card. If user wants to use smearing mode for a certain detector components, value "1" should be given to the corresponding detector number.
At present the following detectors have smearing mode:
SIMD 3=1 4=1 11=1 12=1
Under util directory, there are some sample programs to analyze events generated by "JIM".