RALICE/history.txt

   1 //*CMZ :  1.00/02 04/07/97  16.48.20  by  Nick van Eijndhoven (UU/CERN)
   2 //*-- Author :    Nick van Eijndhoven (UU/CERN)   04/07/97
   3 //////////////////////////////////////////////////////////////////////////
   4 //                        History of updates                            //
   5 //////////////////////////////////////////////////////////////////////////
   6 04-jul-1997 NvE First release of the package
   7 11-jul-1997 NvE Class Invmass added to /GENUTILS and directories /PHYSICS
   8                 and /TRACKING created to hold Jet and Track classes resp.
   9 15-aug-1997 NvE Pilot patch *RALICE removed and automatic installation
  10                 now completely performed by pure CMZ commands in the
  11                 INSTALL macro.
  12 12-sep-1997 NvE Signal of central cluster module and position in user
  13                 coordinates for all modules introduced in the Calorimetry
  14                 package.
  15                 Also all "float vec[]" replaced by "float* vec" in the
  16                 Lorbo class for stylistic reasons.
  17 20-sep-1997 NvE Name of member function "getc()" of Calorimeter changed to
  18                 "get_c()" to avoid clash with native C function.
  19                 Also protection added in Calorimeter::group() against cases
  20                 where no modules fired.
  21 23-sep-1997 NvE Macro "install" modified to also enable automatic installation
  22                 of a G++ or ROOT loadable shared library 'ralice.sl'.
  23 24-sep-1997 NvE Class "Calorimeter" optimized by introduction of pointers
  24                 for the Module matrix instead of an indexed array.
  25 26-sep-1997 NvE Directory /ROOT added to hold the universal ROOT dictionaries
  26                 (dict.h and dict.cc) as generated by "rootcint" for all the
  27                 classes of this RALICE package.
  28                 This will allow automatic installation of the RALICE library
  29                 without running "rootcint".
  30 30-sep-1997 NvE 2-body decay added to class Track and invokation of "delete []"
  31                 only performed in case the object exists in the destructors
  32                 of the Calorimeter, Jet and Track classes.
  33 02-oct-1997 NvE Installation for MSVC++ added into macro "install" and several
  34                 "return 0.;" statements added in some "Sample" member functions.
  35                 The latter caused MSVC++ compiler errors.
  36                 Also 'int ..=fabs(int..)' changed to 'int ..=int(fabs(int..))'
  37                 in "Cluster::Add()" to prevent G++ warning.
  38 03-oct-1997 NvE The above code is now ANSI compatible, but MSVC++ 5.0 still
  39                 gives an error when comp. extensions are switched off (flag /Za).
  40                 The reason is probably an incorrect implementation of the ANSI
  41                 type conversion rules in MSVC++. To satisfy MSVC++ for the moment
  42                 the code in in "Cluster::Add()" has been changed to
  43                 'int ..=int(fabs(double(int..)))' so that at least a Microsoft
  44                 compatible RALICE.DLL can be produced. As soon as G++ is able
  45                 to produce Microsoft compatible dll's the support for MSVC++
  46                 will be dropped for ralice.cmz.
  47                 Message to all : USE G++ AS COMPILATION STANDARD !
  48                 Also CMZ standard adopted to include a "$" in the DECK names
  49                 which contain KEEP definitions.
  50 13-oct-1997 NvE Compiler directive for g++ changed in "flogon" and "install"
  51                 to provide warning for each non-ANSI C++ statement.
  52                 Also ROOT libs linked with g++ in "install" in case of
  53                 ROOT loadable shared library creation.
  54                 Unused variables removed in "Calorimeter::add_ring" and
  55                 "Track::decay".
  56 14-oct-1997 NvE Strict ANSI requirements dropped for ROOT loadable lib creation
  57                 to avoid many harmless warnings from rootcint generated code.
  58                 Class "Random" added to /GENUTILS and /ROOT updated accordingly.
  59 14-oct-1997 NvE Class "Random" extended with user definable distribution and
  60                 /ROOT updated accordingly.
  61 19-oct-1997 NvE Class "Random" extended with vector facility for user
  62                 defined dist. and also bug fixed. /ROOT updated accordingly.
  63 27-oct-1997 NvE Class "Random" optimised for user definable distribution and
  64                 /ROOT updated accordingly.
  65 10-dec-1997 NvE Creation of MSVC++ loadable library introduced in "install".
  66 12-dec-1997 NvE Keep and Deck in /ROOT given unique names to enable loading
  67                 of this package together with other packages.
  68 20-jan-1998 NvE New ralicedict produced because of new ROOT 1.03/09 version.
  69 23-mar-1998 NvE Macro "install" modified to support HP-CC.
  70                 Multiple usage of for-loop index names removed to satisfy HP-CC
  71                 compiler (although the original code was ANSI C++).
  72                 Cluster data just reset to 'empty cluster' in case of cluster
  73                 'creation' or 'start' for edge module or no-signal module.
  74 31-mar-1998 NvE Array index bug fixed in class Jet.
  75 03-apr-1998 NvE Jet and Invmass classes optimised by using pointers and
  76                 compiler options /GD and /DWIN32 introduced for msvc++
  77                 in order to optimize for windows DLL's and ensure correct
  78                 pre-processing in RConfig.h for ROOT library creation.
  79 13-apr-1998 NvE ROOTCINT processing implemented in $KUMACS/INSTALL and
  80                 contents of /ROOT updated accordingly.
  81                 Class Vertex added to /TRACKING and classes Track and Jet
  82                 protected against modifying of returned addresses.
  83 14-apr-1998 NvE "rm .def" removed for Unix systems in $KUMACS/INSTALL since
  84                 on Unix no .def file is created by ROOTCINT.
  85 17-apr-1998 NvE Return type Track& changed to Track* in the get_trk()
  86                 member functions of the Jet and Vertex classes.
  87 21-apr-1998 NvE Classes Track, Vertex, Jet, Lorbo and Invmass derived from
  88                 TObject to enable ROOT I/O.
  89                 $KUMACS/FLOGON and $KUMACS/INSTALL updated accordingly.
  90 26-apr-1998 NvE Classes Module, Cluster and Calorimeter derived from TObject
  91                 to enable ROOT I/O.
  92                 Functionality of class Calorimeter has also been extended to
  93                 enable re-clustering of original Module signals.
  94 28-apr-1998 NvE Decay produced Tracks in class Track stored also into TObjArray
  95                 to allow direct I/O.
  96 03-jun-1998 NvE MSVC++ compiler option /DWIN32 removed in $KUMACS/INSTALL
  97                 because of bug fix in ROOT version 2.00.
  98                 Printout of version number introduced in $KUMACS/FLOGON and
  99                 DOC section updated for new email and www address.
 100 17-aug-1998 NvE New ALICE coding conventions adopted and automatic marking
 101                 of 'edge modules' introduced in class AliCalorimeter.
 102                 The automatic treatment of edge modules required new member-
 103                 functions EdgeUp() and EdgeDown() in class AliModule.
 104 19-aug-1998 NvE Call to LoadMatrix() added in AliCalorimeter::Group()
 105                 to correctly treat different event sizes (i.e. empty events)
 106                 when reading data from input file(s).
 107 25-aug-1998 NvE AliCalorimeter::GetModule() introduced to provide quick
 108                 access to all 'fired' modules.
 109 27-aug-1998 NvE GetSignal() and GetClusteredSignal() of AliModule now
 110                 return 0 in case the module was marked as dead.
 111                 Because of the above, protection against row=col=0
 112                 introduced in AliCalorimeter::Group().
 113                 To enable access of modified calorimeter module data via
 114                 AliCalorimeter::GetModule() after reading in, the "fModules"
 115                 elements are updated in AliCalorimeter::LoadMatrix().
 116 16-sep-1998 NvE Correct deletion of the module matrix introduced in the
 117                 AliCalorimeter destructor and AliCalorimeter::LoadMatrix().
 118 16-oct-1998 NvE New ALICE coding conventions adopted. This resulted in
 119                 modifications in /$KUMACS and /ROOT (.cxx extension instead of .cc)
 120                 and /HEADERS (public class area in front of private).
 121                 #include <iostream.h> added in AliCluster (thanks to A.Zvyagin).
 122 19-oct-1998 NvE Protections agains crazy row,col numbers introduced in
 123                 AliCalorimeter (thanks to E. van der Pijll).
 124 22-oct-1998 NvE Bug fixed in setting edge values in SetDead() and SetAlive()
 125                 of AliCalorimeter (thanks to E. van der Pijll).
 126                 Also row and column dispersion introduced in AliCluster.
 127 24-oct-1998 NvE Memberfunctions DrawModules() and DrawClusters() introduced
 128                 in AliCalorimeter.
 129                 Also AliRandom derived from TObject to enable ROOT I/O.
 130 26-oct-1998 NvE DrawModules() and DrawClusters() histogram axes defined such
 131                 that the X and Y axis corresponds to columns and rows resp.
 132                 in AliCalorimeter. This view matches the 'common sense'.
 133 06-nov-1998 NvE SetDirectory(0) invoked for the histos created in
 134                 DrawModules() and DrawClusters() to suppress global character
 135                 of the histo pointer.
 136 16-nov-1998 NvE New class AliMath implemented in /GENUTILS and /ROOT
 137                 updated accordingly.
 138 23-jan-1999 NvE New class AliSignal implemented and AliCalorimeter extended
 139                 to contain veto signal information.
 140 25-jan-1999 NvE Most of the private areas modified into protected areas to enable
 141                 the use of inheritance.
 142                 Also support for veto signal information introduced in AliCluster.
 143 04-feb-1999 NvE Cluster array for internal use removed in AliCalorimeter; now only
 144                 the "TObjArray* fClusters" is used for performance optimalisation.
 145 06-feb-1999 NvE New class AliPosition implemented for universal position handling
 146                 and AliSignal, AliCluster and AliVertex all derived from AliPosition.
 147                 AliModule inherits from AliSignal and arguments of SetPosition()
 148                 and GetPosition() in AliCalorimeter updated to match the AliSignal
 149                 inheritance of AliModule.
 150 11-mar-1999 NvE All types changed to Int_t, Float_t etc... in order to guarantee
 151                 portability of all data within the ROOT framework.
 152 12-mar-1999 NvE Default destructors added in AliInvmass, AliLorbo and AliSample.
 153 30-mar-1999 NvE New base class Ali3Vector introduced for universal 3D vector handling
 154                 and AliPosition derived from it.
 155                 In AliSignal::Reset() memberfunction call introduced instead of setting
 156                 datamembers; this enhances flexibility for base class development.
 157 01-apr-1999 NvE "car" introduced as default frame for Ali3Vector::Print().
 158 03-apr-1999 NvE New base class Ali4Vector introduced for universal handling of
 159                 Lorentz 4-vectors.
 160                 Also class AliBoost introduced to perform Lorentz boosts on Ali4Vector
 161                 objects. This class will replace the old AliLorbo.
 162                 Memberfunction Print() renamed to Info() for Ali3Vector, Ali4Vector
 163                 and AliBoost to prevent clash with TObject::Print().
 164 05-apr-1999 NvE Functionality of Ali3Vector and Ali4Vector extended with += etc...
 165 06-apr-1999 NvE Class AliTrack derived from Ali4Vector and updated accordingly.
 166                 Also class AliJet modified by deriving it from AliTrack.
 167 08-apr-1999 NvE Class AliVertex derived from AliJet and updated accordingly.
 168                 Also recursive printing facilities List() and ListAll() introduced
 169                 for AliTrack, AliJet and AliVertex.
 170 09-apr-1999 NvE Obsolete classes AliLorbo and AliInvmass removed.
 171                 A new AliInvmass class is planned to provide invariant mass reconstruction
 172                 functionality to serve e.g. di-lepton and pi0 studies.
 173 16-apr-1999 NvE New class AliInvmass introduced for invariant mass and comb. bkg. reconstruction.
 174 21-apr-1999 NvE AliBoost::SetGamma() introduced for enhanced accuracy in boost parameters.
 175 27-apr-1999 NvE AliModule and AliCluster classes renamed to AliCalmodule and AliCalcluster resp.
 176                 in view of future general Aliroot base classes AliModule and AliCluster.
 177 28-jun-1999 NvE Ali4Vector casting changed in AliVertex::Add() and some explicit type conversions
 178                 added and an unused variable removed in AliInvmass to prevent g++ errors/warnings
 179                 (thanks to Eugene van der Pijll).
 180 23-sep-1999 NvE Errors and error propagation introduced in Ali3Vector in view of track
 181                 reconstruction/extrapolation development.
 182                 Also AliPosition and AliSignal updated accordingly by introducing the
 183                 SetPositionErrors(), SetSignalErrors() and Get memberfunctions.
 184                 Note : Errors (propagation) not yet fully implemented in Ali4Vector and
 185                        AliBoost.
 186 24-sep-1999 NvE In Ali4Vector internally the Lorentz invariant (x^mu x_mu) is now stored
 187                 instead of the scalar part x^0. This will yield better precision and
 188                 e.g. automatically conserves the particle identity (mass) in elastic
 189                 collisions.
 190 08-oct-1999 NvE GetResultError() introduced in Ali3Vector to provide error information
 191                 on results obtained from operations which yield a scalar.
 192                 Examples are the error on the norm (GetNorm) and the dotproduct (Dot).
 193 13-oct-1999 NvE Errors and error propagation fully implemented in Ali4Vector.
 194 15-oct-1999 NvE Algorithms for error calculations optimised for accuracy in Ali3Vector
 195                 and Ali4Vector.
 196                 Also particle mass datamember removed from AliTrack, since this is now
 197                 automatically handled via the SetInvariant()/GetInvariant() memberfunctions
 198                 of Ali4Vector.
 199 16-oct-1999 NvE Storage of multiple signal values (with errors) implemented in AliSignal
 200                 and AliCalmodule updated accordingly.
 201                 All documentation moved from the .h files into the .cxx files and also
 202                 Copyright and cvs logs introduced.
 203                 Html documentation generated for all classes using the ROOT automatic
 204                 documentation generator facility.
 205 18-oct-1999 NvE Classes Ali3VectorObj, Ali4VectorObj and AliPositionObj introduced.
 206 20-oct-1999 NvE AliTrack::AddSignal() & co. added to enable relating AliSignals to a certain
 207                 AliTrack object in view of track reconstruction development.
 208                 Also memberfunction Info() added to AliSignal.
 209 24-oct-1999 NvE Full error propagation implemented in AliBoost and obsolete memberfunction
 210                 AliBoost::SetGamma() removed.
 211 25-oct-1999 NvE Undefined "dtheta2" fixed in Ali3Vector::GetErrors() thanks to Rene Brun.
 212 29-oct-1999 NvE Compress() invoked for TObjArray fModules after removal of a single module
 213                 in AliCalorimeter::Reset().
 214                 Begin- and endpoint introduced for AliTrack.
 215 30-oct-1999 NvE Pointer handling introduced instead of object copying in AliCalorimeter::Sortm
 216                 to enhance speed. Also AliCalorimeter::GetModule(row,col) introduced.
 217                 Array creation moved out of default constructor of AliSignal to comply with
 218                 ROOT I/O requirements.
 219 31-oct-1999 NvE AliCalmodule::GetSignal() removed; the AliSignal memberfunction is used
 220                 instead and AliCalorimeter::GetSignal() takes care of the dead modules.
 221                 AliCalcluster::Start updated accordingly.
 222                 New memberfunctions GetVetoLevel() and HasVetoHit() introduced
 223                 for AliCalcluster.
 224 18-jan-2000 NvE AliCalorimeter updated to remove memory leak and to enable event mixing.
 225                 Module and position pointers and various attributes (like edge values etc...)
 226                 are now saved in separate matrices for the complete calorimeter.
 227                 AliCalmodule and AliCalcluster updated accordingly and also cleaned up
 228                 a little to remove unneeded datamembers.
 229 03-mar-2000 NvE AliCalorimeter::SetSignal() updated to provide position for new modules
 230                 and AliCalorimeter::AddSignal() updated to invoke AliCalorimeter::SetSignal()
 231                 in case of new modules instead of having duplicate code.
 232                 (Thanks to Eugene van der Pijll).
 233 12-mar-2000 NvE Computation of Integer Order Modified Bessel functions I_n(x) and K_n(x)
 234                 introduced in class AliMath.
 235                 Also already existing AliMath facilities converted to Double_t handling
 236                 to enhance flexibility.
 237 06-jun-2000 NvE AliMath::K() etc... renamed to AliMath::BesselK() etc... for clarity.
 238 07-jun-2000 NvE Vertex linking of AliVertex::Add(AliVertex&) made more sophisticated
 239                 by introduction of automatic generation of connecting track.