LCLIB

Latest version of lclib packed to tar file is lclib-2003-1

Changes in recent release are

• lclib-2003-1.src.tar.gz (released 30-April-2003, 1434Kb)

New features of this package are,
• xmkmf commnad to create makefiles are not used any more. To build package, do ( assuming that you are using bash )

    $ export LCLIBROOT=[top directory where lclib is installed]
    $ cd $LCLIBROOT
    $ configure [options]
    $ make install
  

  Unless you create an executable in example/genww directory, name of the pythia library does not matter.

• Some obsolute routines are removed.

• JAVAVM flag is included in configure parameter. When it is specified, library for JAVA is created. This part is prepared with a help of Michel Ronan, LBL.

• lclib-2002-1.src.tar.gz (released 8-May-2002, 1487Kb)

New features of this package are,
• Add options to use Pythia6. To use Pythia6, edit config/configure.in and edit PYTHIA_VERSION number. Default is Pythia 5, but it will be changed to 6 in near future. Note that gen/luhadr is not compatible with Pythia6 and example/genww can not be used when Pythia6 is selected. Use JSF to use Pythia6.
• lclib-2001-1.src.tar.gz (released 6-November-2001, 1505Kb)

New features of this package are,
• Inclusion of Bug fix patch as described in the next section.
• Random function was modified to use CERN lib's ranmar. Use this version if you want to use Write/Read function of JSF of version later than 1-18.
• Bug and fixes:
  
  • simjlc.000918.tar.gz (18-September-2000)
    This file includes two subroutines, swmevt.F and smrhlx.F. swmevt.F is to fix a bug introduced by swmevt.000301.F.gz. On Linux system, if-then-else statement in swmevt.000301.F.gz did not interpreted properly. As a result decay length of most of B hadrons were almost 0 while D hadrons from B hadrons had correct decay length. This problem was fixed by this patch. Change of smrhlx.F is to change the gas density in CDC. According to the comparision of JIM simulation, momentum resolution (Delta Pt/Pt) of low momentum particles simulated by Quick Simulator was about 2.5x10^{-3}Pt(GeV), which is about three times larger than that of JIM results. So radiation length of CDC gas was reduced from 55x10^{-6}radiation length per cm to 15x10^{-6}, artificially. To install these files,

        Download files
        cd $LCLIBROOT/simjlc/src
        tar zxvf simjlc.000918.tar.gz
        make
        make install
    

  • swmevt.000301.F.gz (1-March-2000)
    There was a bug in the treatment of long lived particle when it's momentum is 0, which is solved. Please put this file in simjlc/src directory, then do make install to re-create lib/libSIMJLC.a This also fixes the problem of un-expected energy deposit on Calorimeter when qqbar event is generated without initial state radiation.
  • If particles enter the edge cell of Barrel Calorimter, some energy should be depositted to End Cap calorimeter. But current Quick Simulator does not create End Cap signals. This will be improved in future release.(1-March-2000)

• lclib-2000-1.src.tar.gz (released 25-January-2000, 1504Kb)

Main new feature in this release are,
• A tentative parameter file for 3 Tesla solenoid field is included in simjlc/param/jlc3T.com. Since granuarity of calorimter is increased, common size for Track-Cluster matching must be modified which is not backword compatible. Please use this release together with jsf-1-13. The preliminary results of the performance of this parameter set are described in a report on Performance of 3 Tesla detector.
  Please note that the default parameter is for 2 Tesla solenoid. Please see How define a 3 Tesla Detector to run JSF and Quick Simulator with 3 Tesla solenoid.
• There are some other minar changes as described in Release Notes.

If you have already installed lclib-98a-6, you may download the patch file, lclib-2000-1.patch-000125.tar.gz, then install it by

      $ cd $LCLIBROOT
      $ tar zxvf lclib-2000-1.patch-000125.tar.gz
      $ make install

That's it.
• lclib-98a-6.src.tar.gz (released 27-May-1999, 1503Kb)

Main new feature in this release are,
• When track parameter of CDC and VTX are smeared, effect of multiple scattering are included and a formula without approximation of large number of sampling are used. As a result, momentum resolution of low momentum track, say 1 GeV, is now roughly 2%, while it was 0.1% prviously. As a CDC chamber gas, C02-C4H10 of 90-10 mixture, whose thickness in unit of radiation length is 0.000055 per cm, is used. To use other gas, data statement in the subroutine SMRHLX must be modified.
  In our simulation, helical track parameter is approximated by second order polynomial and the effect of multiple-scattering are included assuming uniform matterial distribution along the track. This approximation is not good for VTX. But we don't know it quantitatively. Comparison with JIM results is yet to be done.
• Buffer size to store VTX hits are increased to accept up to 20 hits for the study of intermidiate tracker.
• PID of 1000022 is treated as LSP in luhadr.F

If lclib-98a-5 is already installed in your system and dont't want to compile whole library, get the patch file, lclib-98a-6.src.patch-990528.tar.gz, then do

   $ cd $LCLIBROOT
   $ cd ..
   $ tar zxvf lclib-98a-6.src.patch-990528.tar.gz
   $ cd $LCLIBROOT/simjlc/src ; make clean ; xmkmf ; make install
   $ cd $LCLIBROOT/gen/luhadr ; make clean ; xmkmf ; make install

If your system is HP-UX, compile whole library, since it is modified so as not to create shared libary on HP-UX system. Instruction is

   $ cd $LCLIBROOT
   $ cd ..
   $ tar zxvf lclib-98a-6.src.patch-990528.tar.gz
   $ cd $LCLIBROOT 
   $ make distclean 
   $ make install

• A patch file, lclib-98a-5.src.patch-990507.tar.gz is prepared.
  This patch fixes two bugs in lclib-98a-5 release, namely,
  • When CDC track is extrapolated to VTX region to make a CDC-VTX track linking, correct matterial thickness was not used. Larger extrapolation error was applied to CDC track.
  • The thickness of first VTX layer defined in the detector parameter file, simjlc/param/detect7.com, was 0.0015 radiation length, though it should be 0.003.
• lclib-98a-5.src.tar.gz (released 9-April-1999, 1500Kb)

There are several bugs in 98a-4, which is fixed in this version.

Instead of re-installing whole source files, you can install only lclib-98a-5.src.patch-990409.tar.gz(27Kb), if you have the version later than 98a-3. To apply this patch, do

  cd $LCLIBROOT
  tar zxvf lclib-98a-4.src.patch-990409.tar.gz
  cd $LCLIBROOT/util/fortlib/src
  xmkmf ; make depend ; make ; make install
  cd $LCLIBROOT/simjlc/src
  make clean ; xmkmf ; make depend ; make ; make install

Changes in this version are
• QuickSimulator can handle 0 Pt particles in Generator:Particle_List. Thus, we can leave initial particle information in Generator:Particle_List ( any way, parent-daughter relation among particles must be set properly).
• The averaging procedure of CDC and VTX track sometimes failed when particle Pt is low, say less than 300 MeV. This bug was fixed.
• The calculation of VTX smeared track parameter failed sometimes due to round off error. The bug is fixed.

For more details about this release see release note



• (6-April-1999) There were bugs in Quick Simulator. Please get lclib-98a-4.src.patch-990406.tar.gz and modifed your lclib sources. To apply patch do

    cd $LCLIBROOT
    tar zxvf lclib-98a-4.src.patch-990406.tar.gz
    cd $LCLIBROOT/simjlc/src
    xmkmf
    make
    make install
  

  Due to the bug in previous version, the program goes into infinte loop when short lived particle decays between VTX layers.

  In addtion, this patch includes

  • Correct treatment of error matrix, when combining CDC and VTX Track parameter
  • A data for new detector parameter set for 40 cm suppor tube and 2 cm beam pipe.
• lclib-98a-4.src.tar.gz (released 1-April-1999, 1498Kb)

Only a small number of files are modified in lclib-98a-4. To install only modified files, get the patch file, lclib-98a-4.src.patch-990401.tar.gz(27Kb) and applied it to lclib-98a-3 files as described in the section of lclib-98a-3. Don't forget to do make install after expanding the patch file.

The main changes in this version are (1) to create smeared VTX Track parameter and use it to construct the combined CDC-VTX track and (2) to create signals of the Intermideate Tracker. The signal of the Intermideate Tracker are saved at the same place as Vertex Detector, but their spacial resolution can be different from those of the Vertex Detector. Please read the comment in the file $LCLIBROOT/simjlc/param/detect6.com to use these feature. As a default, the signal of the Intermediate Trcker is not created. An example file to create the Intermediate Tracker can be found here
Fore more details about this release see release note



• lclib-98a-3.src.tar.gz (released 15-Feburary-1999)

There were bugs in lclib-98a-2. Those are modified. For more details see, Release notes
Only a few files are modified in lclib-98a-3. It may be faster to apply only patch file lclib-98a-2.src.patch-990215.tar.gz. To do this, get the patch file, then do

     cd $LCLIBROOT
     cd ..
     tar zxvf [patch-file]

• lclib-98a-2.src.patch-990107.tar.gz (released 7-January-1999)

There was a problem to compile gen/tauola/tauola.F in HP-UX, since PWB is predefined by the system. Therefore add -WF,-UPWB to the Fortran compiler option for HP-UX. To apply this patch, do tar zxvf at the 98a directory.
• lclib-98a-2 (released 6-January-1999)

Several changes in simjlc/src to allow VTX layer more than 2. In addition to Production:VTX;Space_Point bank, output Production:VTX;Space_Point_Error bank to store r-phi and z error of each hit points. simjlc/param/detect5.com is added as a parameter set of 4 VTX layers.
• lclib-98a-1(released 24-December-1998)
Include several patches by K.Fujii. Thoese are,

-------------------------------------------------------------------------------
98/12/22  K.Fujii       Modifications for 98a
-------------------------------------------------------------------------------

Makefile                gen/pythia55: removed
                        gen/lund73:   renamed to gen/luhadr
config/hitachi.def      -DJETSET73
      /lclib.def        -fno-second-underscore for PPC
example                 removed
gen/Makefile            lund73: renamed to luhadr
                        pythia55: removed
gen/lund73              moved to gen/luhadr
gen/luhadr/Makefile     removed 
          /jetset73     removed
          /full/*       moved to ..
          /full         removed
          /Imakefile    jetset73 part removed
gen/pythia55            removed
gen/tauola/hepevt.inc   #ifndef JETSET73 .....
          /tauola.F        to change precision of PHEP,VHEP in /HEPEVT/
          /photos.F
util/cli/ldsdsn.F       removed MAIN__
    /genutil/Imakefile  udsrch: removed
            /udsrch.F   removed
    /lcfull/src/Imakefile       prmain.o removed
    /tbs/src/tb_buflib.c        removed PPC treatment for second underscore
 

• For history before 98a, please see a file, Rlease.notes, in the distribution.

Future Plan

• FULL (PS 75KB)    html
• FULL for JLC Physics Study (PS 77KB)    html
• TRISTAN Bank System (PS 54KB)    html
• New Combined Track Bank (PS 329KB)     html
• Interface to JETSET7.3 (PS 68KB)     html
• Seed Booker
• Introduction to Helical Track Manipulations (PS 178KB)     html
• Performance of a detector with 3 Tesla solenoid -- study by Quick Simulator

Authors