[1337] | 1 | |
---|
| 2 | Geant4 3.0 Release Notes |
---|
| 3 | ------------------------ |
---|
| 4 | |
---|
| 5 | 15th December 2000 |
---|
| 6 | |
---|
| 7 | These are the main new features/fixes included in this release (for the |
---|
| 8 | detailed list of fixes/additions, please refer to the related History files): |
---|
| 9 | |
---|
| 10 | o Analysis |
---|
| 11 | -------- |
---|
| 12 | - New module for analysis/histogramming management and concrete |
---|
| 13 | drivers interfaces through AIDA: JAS, Lizard, OpenScientist. |
---|
| 14 | |
---|
| 15 | o Configuration: |
---|
| 16 | ------------- |
---|
| 17 | - Added unsupported configuration WIN32-g++ |
---|
| 18 | for Windows/NT/9X and Cygwin with g++ compiler. |
---|
| 19 | - Introduced changes to handle analysis module. |
---|
| 20 | - Incorporated building of shared libraries into .gmk files |
---|
| 21 | (NOTE: tests on shared libraries currently perfomed only on |
---|
| 22 | Linux-g++ and SUN-CC platforms) |
---|
| 23 | o Introduced new variables steering the building of shared/static |
---|
| 24 | libraries (static still default): G4LIB_BUILD_SHARED and |
---|
| 25 | G4LIB_BUILD_STATIC. |
---|
| 26 | o Introduced new variable (G4LIB_USE_GRANULAR) to force using of |
---|
| 27 | granular libraries. |
---|
| 28 | - Added rules for "includes" gmake target, to copy all header files |
---|
| 29 | in a single location specified by $G4INCLUDE path. |
---|
| 30 | - Introduced SUN-CC5 G4SYSTEM architecture for SUN CC 5.1 compiler. |
---|
| 31 | |
---|
| 32 | o Event: |
---|
| 33 | ----- |
---|
| 34 | - Added new Set methods to G4PrimaryVertex and G4PrimaryParticle. |
---|
| 35 | - Introduced ParticleGun for Ions and weights for primary vertex |
---|
| 36 | and particle: |
---|
| 37 | o G4ParticleGun: added Set/GetParticleCharge methods for ions. |
---|
| 38 | o G4ParticleGunMessenger: added new command of /gun/ion; |
---|
| 39 | modified command of /gun/particle. |
---|
| 40 | o G4PrimaryParticle: add Set/GetCharge methods, added weight. |
---|
| 41 | o G4PrimaryVertex: added weight. |
---|
| 42 | o G4PrimaryTransformer: use G4PrimaryParticle::GetCharge to give |
---|
| 43 | dynamic charge in G4DynamicParticle; set weight of G4Track. |
---|
| 44 | - Introduced G4GeneralParticleSource and related classes. |
---|
| 45 | G4GeneralParticleSource is an alternative primary source |
---|
| 46 | generator to G4ParticleGun. It has all the functions of |
---|
| 47 | G4ParticleGun plus many options for specifying the primary |
---|
| 48 | event particle and vertex. |
---|
| 49 | |
---|
| 50 | o Electromagnetic Processes (Low-energy): |
---|
| 51 | -------------------------------------- |
---|
| 52 | - Bug fix to G4hLowEnergyIonisation, relevant for particles |
---|
| 53 | with absolute charge value greater than 1. |
---|
| 54 | - Bug fix on electron energy loss fluctuations. |
---|
| 55 | - New features on antiproton ionisation, extending the model for |
---|
| 56 | application to generic materials. |
---|
| 57 | - Modifications in hadron classes (renaming of classes). |
---|
| 58 | - Bug fix related to the charge dependence of ion fluctuations. |
---|
| 59 | - Fixes to G4LowEnergyUtilities to replace the obsolete HepString |
---|
| 60 | with G4String. |
---|
| 61 | - Bug fixes for problems found on setting cuts. |
---|
| 62 | - Bug fix for nuclear stopping table name, improvements in |
---|
| 63 | code quality and added comments for the Software Reference Manual. |
---|
| 64 | |
---|
| 65 | o Electromagnetic Processes (Standard): |
---|
| 66 | ------------------------------------ |
---|
| 67 | - G4eBremsstrahlung : new cross section and energy-loss parametrisation. |
---|
| 68 | - Update to G4VhEnergyLoss.cc, G4VhEnergyLoss.hh, G4hIonisation.cc |
---|
| 69 | in order to simulate energy losses of ions; correction to cross |
---|
| 70 | section for particles with spin 1. |
---|
| 71 | - Removed class G4ionIonisation. |
---|
| 72 | - Fix in G4VhEnergyLoss and G4ionIonisation in AlongStepDoIt |
---|
| 73 | for particles with Charge^2 > 1. |
---|
| 74 | - Stopped very low energy photons in photo electric effect. |
---|
| 75 | - Moved ElossMessenger to G4VEnergyLoss. |
---|
| 76 | - Bug fix in G4Cerenkov and G4Scintillation: corrected usage of |
---|
| 77 | the 'step length' to position the origins of secondaries. |
---|
| 78 | - Corrections on Polarized Compton: |
---|
| 79 | o Sampling of Phi |
---|
| 80 | o Depolarization probability |
---|
| 81 | - G4IeBremsstrahlung: |
---|
| 82 | o new cross section/en.loss parametrisation, LPM flag. |
---|
| 83 | o corrections in the LPM implementation. |
---|
| 84 | - Changed signature in GetLossWithFluct. |
---|
| 85 | - G4EnergyLossMessenger: created subdirectory /process/eLoss. |
---|
| 86 | Added class description for Software Reference Manual. |
---|
| 87 | - EnergyLossTable: use "const G4Material*" where required. |
---|
| 88 | - Introduced correction to G4Cerenkov to fix a problem when |
---|
| 89 | an optical medium has refraction indices all equal to 1. |
---|
| 90 | |
---|
| 91 | o General Processes, Parameterisation, Decay, Optical: |
---|
| 92 | --------------------------------------------------- |
---|
| 93 | - Bug fix in G4Decay to avoid direct modification of G4Track by |
---|
| 94 | the Decay process. |
---|
| 95 | - Fixed bugs in G4ProcTblElement::operator= |
---|
| 96 | - Removed destruction of processes in G4ProcessTable destructor. |
---|
| 97 | - Implemented full STL migration in G4ProcessVector. |
---|
| 98 | - Added thePILfactor and GPIL methods in G4VProcess. |
---|
| 99 | - Added Store/RetrievePhysicsTable() methods. |
---|
| 100 | |
---|
| 101 | o Geometry: |
---|
| 102 | -------- |
---|
| 103 | QA code cleanup. Cleanup warnings issued by "-Wall -ansi -pedantic" |
---|
| 104 | g++ compiler options. |
---|
| 105 | - Boolean solids: |
---|
| 106 | o G4SubtractionSolid.cc: relaxed behavior in SurfaceNormal(p), |
---|
| 107 | where it is now allowed for a point to be inside the solid. |
---|
| 108 | A message is thrown to cerr instead of a G4Exception. |
---|
| 109 | o Added new set methods for matrix/vectors to G4DisplacedSolid: |
---|
| 110 | SetTransform(G4AffineTransform&), |
---|
| 111 | SetDirectTransform(G4AffineTransform&), |
---|
| 112 | SetFrameRotation(const G4RotationMatrix&), |
---|
| 113 | SetFrameTranslation(const G4ThreeVector&), |
---|
| 114 | SetObjectRotation(const G4RotationMatrix&), |
---|
| 115 | SetObjectTranslation(const G4ThreeVector&). |
---|
| 116 | - BREPS solids: |
---|
| 117 | o Fix in G4Ellipse::Project() for computation of u as function |
---|
| 118 | of atan2(). |
---|
| 119 | o Changed return value to be "const" pointer to functions: |
---|
| 120 | - G4BREPSolid::GetPlace() |
---|
| 121 | - G4BREPSolid::GetBBox() |
---|
| 122 | o G4Assembly: fix in destructor, added call to clearAndDestroy(). |
---|
| 123 | o G4BREPSolid: changed method NumberOfFaces() to GetNumberOfFaces(). |
---|
| 124 | o G4Curve: fixed obsolete workaround for XlC compiler. |
---|
| 125 | o G4OsloMatrix: changed internal class "Matrix" to "G4PointMatrix" |
---|
| 126 | and updated classes making use of it. |
---|
| 127 | o G4ThreeMat:removed unused overloaded operators =, +, -, +=, -=, *. |
---|
| 128 | - CSG solids |
---|
| 129 | o Fix to G4Tubs and G4Cons in DistanceToIn/DistanceToOut: |
---|
| 130 | + fixes to DistanceToOut(p,v,...) to make roots of quadratic |
---|
| 131 | equations more stable. |
---|
| 132 | + added check against negative distance returned. |
---|
| 133 | o Fixes to G4Cons: |
---|
| 134 | + corrected condition on conical surface to consider a real |
---|
| 135 | projection of the conical surface thickness on XY plane |
---|
| 136 | (0.5*kCarTolerance*secRMin instead of 0.5*kCarTolerance), |
---|
| 137 | when dealing with cons with large opening angle. |
---|
| 138 | + fix in constructor to check if one of the Rmin different than 0, |
---|
| 139 | to avoid degenerated cones. |
---|
| 140 | o G4Torus: introduced Newton-based numerical method for computing |
---|
| 141 | roots of equations in DistanceToIn() and DistanceToOut(). |
---|
| 142 | o Bug fixed in G4Tubs::Inside(p) for analysis of phi positioning |
---|
| 143 | when on +-fDz surface. |
---|
| 144 | o Fix in G4Tubs::DistanceToOut(p,v,...): initialised sr and sphi to |
---|
| 145 | kInfinity and re-introduced additional condition on check for |
---|
| 146 | Rmin intersection (t2 >= 0). |
---|
| 147 | - Specific solids: |
---|
| 148 | o Fix in G4IntersectingCone.cc: the check for a zero radical has been |
---|
| 149 | adjusted to be less sensitive to round off error in LineHitsCone1(), |
---|
| 150 | LineHitsCone2(). |
---|
| 151 | - STEP |
---|
| 152 | o dirobj.h: protected from missing definition of MAXNAMLEN, S_IFMT |
---|
| 153 | and S_IFDIR originally defined in /usr/include/sys/stat.h. |
---|
| 154 | - STEPinterface |
---|
| 155 | o Added GetInstanceManager() method to G4GeometryCreator. |
---|
| 156 | o Changed return value to "const char*" to method Name() and made |
---|
| 157 | post-const in all creator classes. |
---|
| 158 | o Fix in G4Axis2Placement3dCreator::CreateSTEPGeometry(void*). |
---|
| 159 | - Magnetic Field |
---|
| 160 | o Fix in G4FieldManager: added check on existence of allocated |
---|
| 161 | fChordFinder in CreateChordFinder(G4MagneticField*) method. |
---|
| 162 | o Changed return value to be "const" pointer to functions: |
---|
| 163 | + G4EquationOfMotion::GetFieldObj() |
---|
| 164 | + G4FieldManager::GetDetectorField() |
---|
| 165 | + G4MagIntegratorDriver::GetStepper() |
---|
| 166 | o Fixed and corrected signature to G4MagIntegratorDriver::SetHmin(). |
---|
| 167 | - Management |
---|
| 168 | o Fixed bug in destructor of G4SolidStore. Memory corruption at |
---|
| 169 | application exit was occuring when Boolean solids were involved. |
---|
| 170 | o Fix in G4VSolid::CalculateClippedPoligonExtent(): |
---|
| 171 | removed assumption that pMin<pMax by eliminating "else" |
---|
| 172 | condition. |
---|
| 173 | - Volumes |
---|
| 174 | o Changed return value to be "const" pointer to functions: |
---|
| 175 | - G4LogicalBorderSurface::GetVolume1() |
---|
| 176 | - G4LogicalBorderSurface::GetVolume2() |
---|
| 177 | - G4LogicalSkinSurface::GetLogicalVolume() |
---|
| 178 | |
---|
| 179 | o Global: |
---|
| 180 | ------ |
---|
| 181 | - Moved G4VStateDependent and G4StateManager classes into |
---|
| 182 | global/management from intercoms. |
---|
| 183 | - Added "Abort" state is added G4ApplicationState. |
---|
| 184 | - Modified G4Exception to change Geant4 status to "Abort". |
---|
| 185 | - Bug fix of "double deleting" in the destructor of G4StateManager. |
---|
| 186 | - Defined G4RandGauss to invoke CLHEP's RandGaussQ, |
---|
| 187 | needed to fix general events' reproducibility problem. |
---|
| 188 | - Added STL wrapper for in management/include/g4std. |
---|
| 189 | - QA code cleanup from Code-Wizard and warnings issued by |
---|
| 190 | "-Wall -ansi -pedantic" g++ compiler options. |
---|
| 191 | |
---|
| 192 | o Hadronic Processes: |
---|
| 193 | ------------------ |
---|
| 194 | - General update of source code documentation. |
---|
| 195 | - management |
---|
| 196 | o Introduced the possibility for cross-section biasing. |
---|
| 197 | - util |
---|
| 198 | o Added G4Pair class as utility (to be replaced with stl in due course) |
---|
| 199 | o Added protection to G4ReactionDynamics in case no secondary has been |
---|
| 200 | created. |
---|
| 201 | - high_energy |
---|
| 202 | o Fixed bug causing energy non-conservation in pion interactions. |
---|
| 203 | o Code cleanup. |
---|
| 204 | - neutron_hp |
---|
| 205 | o Added several protections against non-physical cross-section values |
---|
| 206 | removed 'const' in operator+ of G4NeutronHPVector to work around |
---|
| 207 | compiler inconsistencies. |
---|
| 208 | o Removed 'const' in GetXsec(G4int i) of G4NeutronHPVector to work |
---|
| 209 | around compiler inconsistencies. |
---|
| 210 | o Introduced self-hashing has table to optimize initialization and |
---|
| 211 | run-time performance (factor 4 in init, 2 at run-time) |
---|
| 212 | o Introduced correct treatment of compound cross-sections |
---|
| 213 | full event by event correlations in Capture below 100 keV regardless |
---|
| 214 | the data quality |
---|
| 215 | o Correction of a Q-value miscalculation in exceptional conditions in |
---|
| 216 | Capture |
---|
| 217 | o Added Protections in case no photon energies given in the capture |
---|
| 218 | data. |
---|
| 219 | o Fixed error in accessing gamma level 49 in n->ngamma inelastic channel |
---|
| 220 | o Added recoil production to several inelastic channels |
---|
| 221 | o Added protections in cases interpolations between expansions in terms |
---|
| 222 | of legendre polynomials lead to non-physical cross-section integrals. |
---|
| 223 | - radiative_decay |
---|
| 224 | o Fix to const-ness of G4DynamicParticle to co-work with latest changes |
---|
| 225 | in 'track' module. |
---|
| 226 | o Code correction in integration of Fermi beta functions. |
---|
| 227 | - diffractive_string |
---|
| 228 | o Updated sampling of impact parameter for re-use. |
---|
| 229 | - kinetic_model |
---|
| 230 | o Fixed a memory leak |
---|
| 231 | o Added protection in case to pre-compound phase was registered |
---|
| 232 | - management(gen) |
---|
| 233 | o Added impact parameter sampling possibility to G4V3DNucleus. |
---|
| 234 | - quark_gluon_string |
---|
| 235 | o Fixed memory leak in G4SPBaryon and G4SPBaryonTable |
---|
| 236 | o Introduced improved of low energy cut-off for string creation |
---|
| 237 | o Updated sampling of impact parameter for re-use |
---|
| 238 | - string_fragmentation |
---|
| 239 | o Design iteration to allow for use of quark molecular dynamics. |
---|
| 240 | - util |
---|
| 241 | o Updated G4Parton to allow for use of quark molecular dynamics. |
---|
| 242 | o Bug-fix in Lorentz boost in G4Fancy3DNucleus |
---|
| 243 | o Added protection of G4Fragment against negative excitation energies |
---|
| 244 | o Fixed memory leaks in G4KinetiTrack |
---|
| 245 | - pre_equilibrium |
---|
| 246 | o Design iteration |
---|
| 247 | o Update of barrier penetration factors |
---|
| 248 | - string_common |
---|
| 249 | o Design iteration to allow for usage of quark molecular dynamics. |
---|
| 250 | |
---|
| 251 | NOTE: the consistent data sets for photon evaporation and radio-active |
---|
| 252 | decay (derived from the same version of the ENSDF data) are |
---|
| 253 | provided from Web in the source download area. A previous version |
---|
| 254 | of photon evaporation data is also provided. |
---|
| 255 | |
---|
| 256 | o Interfaces: |
---|
| 257 | ---------- |
---|
| 258 | - Modified G4UIterminal, G4VUIshell, G4UIcsh and G4UItcsh to display |
---|
| 259 | the break status as a prompt characters. |
---|
| 260 | - Minor fixes in G4VInteractorManager and G4VUIShell. |
---|
| 261 | |
---|
| 262 | o Materials: |
---|
| 263 | --------- |
---|
| 264 | - Fixed initialization of pointers in G4SandiaTable constructor |
---|
| 265 | and corrected deletion of fPhotoAbsorptionCof in destructor. |
---|
| 266 | |
---|
| 267 | o Parameterisations |
---|
| 268 | ----------------- |
---|
| 269 | - New top category for specific parameterisation models: |
---|
| 270 | G4FoamXrayTRmodel, G4GamDistrXrayTRmodel, G4IrregularXrayTRmodel, |
---|
| 271 | G4PAIclusterModel, G4PhotoClusterModel, G4PlateIrrGasXrayTRmodel, |
---|
| 272 | G4RegularXrayTRmodel, G4VClusterModel, G4VXrayTRmodel. |
---|
| 273 | |
---|
| 274 | o Particles: |
---|
| 275 | --------- |
---|
| 276 | - Added const to G4DynamicParticle::GetPreAssignedDecayProducts. |
---|
| 277 | - Added method G4IonTable::GetElementNumber. |
---|
| 278 | - Added neutron life time. |
---|
| 279 | - Fixed stable flag for G4PionMinus. |
---|
| 280 | |
---|
| 281 | o Run and Intercoms: |
---|
| 282 | ----------------- |
---|
| 283 | - Modified G4RunManager and G4RunMessenger: eliminated |
---|
| 284 | G4StateManager::Pause(). |
---|
| 285 | - Made G4UImanager state dependent. |
---|
| 286 | - Added Retrieve/StorePhysicsTable() and related methods in |
---|
| 287 | G4VUserPhysicsList and modified BuildPhysicsTable() method. |
---|
| 288 | - Added store/retreivePhysicsTable command in |
---|
| 289 | G4UserPhysicsListMessenger. |
---|
| 290 | - Moved default place for storing random number status out of main |
---|
| 291 | directory. |
---|
| 292 | - Added G4VModularPhysicsList and G4VPhysicsConstructor |
---|
| 293 | to modularize UserPhysicsList. |
---|
| 294 | - Fixed bug in G4VUserPhysicsList::StorePhysicsTable(). |
---|
| 295 | |
---|
| 296 | o Tracking & Track: |
---|
| 297 | ---------------- |
---|
| 298 | - Added protection when PiMinusAbsorptionAtRest and Decay processes |
---|
| 299 | are deactivated. |
---|
| 300 | - Bug fixes in copy constructor of G4ParticleChange. |
---|
| 301 | - Added "const" to G4DynamicParticle pointer of returned value of |
---|
| 302 | G4Track::GetDynamicParticle |
---|
| 303 | |
---|
| 304 | o Visualization: |
---|
| 305 | ------------- |
---|
| 306 | - Fixed bug in /vis/lights/direction to not refresh view. |
---|
| 307 | - G4PhysicalVolumeModel: added protection against volumes without |
---|
| 308 | material. |
---|
| 309 | - Removed /vis/viewer/update from compound commands /vis/drawVolume |
---|
| 310 | and /vis/specify. |
---|
| 311 | |
---|
| 312 | o G4toG4 Tool: |
---|
| 313 | ----------- |
---|
| 314 | - Moved tests clGeometry and cltog4 from source/g3tog4/test to |
---|
| 315 | examples/extended/g3tog4. Default build mechanism is now used. |
---|
| 316 | - Bug-fix in destructor for G3RotTable. |
---|
| 317 | - Added handling of ELTU (Elliptical Tube) solid. |
---|
| 318 | - Fixed initialisation of pDPhi for CONS in G3toG4MakeSolid.cc. |
---|
| 319 | - G4PhysicalVolumeModel: added protection against volumes without |
---|
| 320 | material. |
---|
| 321 | - Added protection against multiple positiong of the same physical |
---|
| 322 | volume and added methods ClearG3PosCopy(G4int) and ClearDivision() |
---|
| 323 | in G3VolTableEntry . |
---|
| 324 | - Removed useless G3toG4Debug global method and file. |
---|
| 325 | Replaced verbosity by G3G4DEBUG flag. |
---|
| 326 | - Removed obsolete class/files G3CalcParams[.hh.cc]. |
---|
| 327 | |
---|
| 328 | - Examples: |
---|
| 329 | -------- |
---|
| 330 | o New "advanced" examples for specific applications: |
---|
| 331 | xray_telescope, brachyterapy and gammaray_telescope. |
---|
| 332 | |
---|
| 333 | Notes: |
---|
| 334 | |
---|
| 335 | o Geant4 3.0 is based on STL and can be installed with strict |
---|
| 336 | ISO/ANSI C++ compliant setup or not. See notes below. |
---|
| 337 | |
---|
| 338 | The code and some binary libraries are available through our "Source |
---|
| 339 | Code" Web page: |
---|
| 340 | - see our Geant4 Home Page (http://cern.ch/geant4). |
---|
| 341 | |
---|
| 342 | Please refer to the Geant4 User Documentation |
---|
| 343 | (http://cern.ch/geant4/G4UsersDocuments/Overview/html) |
---|
| 344 | for further information about using Geant4. |
---|
| 345 | Updates to the documentation for Geant4 3.0 are expected to be published as |
---|
| 346 | usual within three weeks from the release date. |
---|
| 347 | |
---|
| 348 | |
---|
| 349 | Contents |
---|
| 350 | -------- |
---|
| 351 | |
---|
| 352 | 1. Supported and Tested Platforms |
---|
| 353 | 2. ANAPHE and CLHEP |
---|
| 354 | 3. The Standard Template Library (STL) |
---|
| 355 | 4. Persistency |
---|
| 356 | 5. Compiler Specific Problems |
---|
| 357 | 6. Known Run-Time Problems |
---|
| 358 | 7. Compilation Warnings |
---|
| 359 | 8. Known Run-Time Warnings |
---|
| 360 | |
---|
| 361 | |
---|
| 362 | 1. Supported and Tested Platforms |
---|
| 363 | --------------------------------- |
---|
| 364 | |
---|
| 365 | o SUN Solaris 5.6/5.7, C++ 4.2 Patch 104631-04, C++ 5.1 Patch 109490-01. |
---|
| 366 | o HP 10.20, aCC C++ B3910B A.01.23 |
---|
| 367 | o Linux 2.2.12-20, gcc C++ egcs-2.91.66 (egcs 1.1.2). |
---|
| 368 | This configuration was tested with the RedHat 6.1 distribution, but |
---|
| 369 | versions of Geant4 have also been compiled successfully on Debian |
---|
| 370 | and Suse distributions. |
---|
| 371 | o NT 4.0 with Service Pack 4 and Cygnus Tools b20 with: |
---|
| 372 | Visual C++ 6.0 Service Pack 2 |
---|
| 373 | |
---|
| 374 | Platforms also tested but giving rise to some problems - see below: |
---|
| 375 | |
---|
| 376 | o DEC V4.0, cxx C++ V6.1-027. |
---|
| 377 | |
---|
| 378 | Platforms configured but not tested and not supported: |
---|
| 379 | o SGI V6.5.5, CC 7.2.1 with ObjectSpace |
---|
| 380 | o AIX 4.3.2, xlC compiler with ObjectSpace |
---|
| 381 | |
---|
| 382 | |
---|
| 383 | 2. ANAPHE and CLHEP |
---|
| 384 | ------------------- |
---|
| 385 | |
---|
| 386 | Geant4 3.0 requires the installation of CLHEP. |
---|
| 387 | |
---|
| 388 | See CLHEP (http://cern.ch/clhep/INSTALLATION/clhep.html). |
---|
| 389 | Tests have been performed with CLHEP 1.6.0.0. |
---|
| 390 | |
---|
| 391 | By default, the CLHEP installation scripts will activate ISO/ANSI C++ features |
---|
| 392 | if the compiler is capable. You need to explicitly disable CLHEP settings in |
---|
| 393 | case you wish non-ISO/ANSI setup on specific compilers (for example, DEC). |
---|
| 394 | |
---|
| 395 | Geant4 3.0 coworks with ANAPHE 3.2.0 and components included therein: |
---|
| 396 | Objectivity 5.2.1 |
---|
| 397 | ObjectSpace 2.1 |
---|
| 398 | HepODBMS 0.3.1.4 |
---|
| 399 | CLHEP 1.6.0.0 |
---|
| 400 | |
---|
| 401 | For more information about ANAPHE see: http://cern.ch/anaphe |
---|
| 402 | |
---|
| 403 | |
---|
| 404 | 3. The Standard Template Library |
---|
| 405 | -------------------------------- |
---|
| 406 | |
---|
| 407 | The following versions of STL have been tested: |
---|
| 408 | |
---|
| 409 | ObjectSpace STL on |
---|
| 410 | DEC, HP and SUN (CC 4.2). |
---|
| 411 | |
---|
| 412 | See ObjectSpace (http://www.objectspace.com). |
---|
| 413 | |
---|
| 414 | "Native" STL on: Windows/NT, Linux, HP, DEC and SUN (CC 5.1). |
---|
| 415 | |
---|
| 416 | This is selected at installation/compile time by the environment variable |
---|
| 417 | G4USE_OSPACE in the case of the former - see documentation. |
---|
| 418 | |
---|
| 419 | NOTES: |
---|
| 420 | - Be aware that by default, the installation scripts will expect to use |
---|
| 421 | the native STL implementation. You must set the G4USE_OSPACE variable |
---|
| 422 | in the environment in order to select the ObjectSpace implementation. |
---|
| 423 | |
---|
| 424 | - Platform specific setup: |
---|
| 425 | o DEC: ObjectSpace is required in non ISO/ANSI setup. |
---|
| 426 | Native STL is required for ISO/ANSI setup. |
---|
| 427 | o HP: either ObjectSpace or native STL can be used (non ISO/ANSI setup). |
---|
| 428 | o SUN: ObjectSpace is required in non ISO/ANSI setup (CC 4.2). |
---|
| 429 | Native STL is required for ISO/ANSI setup (CC 5.1 only). |
---|
| 430 | o Linux: Native STL is required (non ISO/ANSI setup). |
---|
| 431 | o NT: Native STL and ISO/ANSI setup required. |
---|
| 432 | |
---|
| 433 | In the interest of stability, part of the code in Geant4 3.0 still makes use |
---|
| 434 | of the "STL Interface" wrapper classes, used for allowing the migration from |
---|
| 435 | Rogue Wave Tools.h++ container library. For these the emphasis has remained |
---|
| 436 | on correct behaviour, rather than performance. |
---|
| 437 | |
---|
| 438 | |
---|
| 439 | 4. Persistency |
---|
| 440 | -------------- |
---|
| 441 | |
---|
| 442 | Platform |
---|
| 443 | -------- |
---|
| 444 | |
---|
| 445 | Persistency in Geant4 3.0 release is tested on the following |
---|
| 446 | platforms: |
---|
| 447 | |
---|
| 448 | G4SYSTEM OS C++ compiler HepODBMS Objectivity |
---|
| 449 | --------- ----------- ------------ --------- ----------- |
---|
| 450 | SUN-CC SunOS 5.6 CC 4.2 0.3.1.4 5.2.1 |
---|
| 451 | SUN-CC5 SunOS 5.7 CC 6.0 0.3.2.3 (*) 6.0 (*) |
---|
| 452 | Linux-g++ RedHat 6.1 egcs-2.91.66 0.3.1.4 5.2.1 |
---|
| 453 | |
---|
| 454 | (*) HepODBMS header files must be prepared with "ooddlx -noline" option. |
---|
| 455 | See below. |
---|
| 456 | |
---|
| 457 | Known Problems |
---|
| 458 | -------------- |
---|
| 459 | |
---|
| 460 | - There are several warning messages on some platforms during the |
---|
| 461 | installation of the libraries and the compilation of the examples. |
---|
| 462 | Most of them can be safely ignored. It is annoying but hard to get |
---|
| 463 | rid of them due to various reasons. |
---|
| 464 | |
---|
| 465 | - A warning message "Could not find naming root directory" appears at |
---|
| 466 | runtime of the persistency examples. It is generaged by HepDbApplication |
---|
| 467 | in HepODBMS. It can be ignored. |
---|
| 468 | |
---|
| 469 | - On Solaris7 (SUN-CC5), persistent header files has to be generated by |
---|
| 470 | ooddlx with "-noline" option to work around a bug in C++ compiler. |
---|
| 471 | This workaround applies not only to Geant4 Persistency category but |
---|
| 472 | also to HepODBMS, and the user defined ddl files as well. This option |
---|
| 473 | removes the "#line" directive of the file name and the line number of |
---|
| 474 | the original ddl file. As a consequences, C++ compiler no longer |
---|
| 475 | "tell" the correct file name and the line number of the ddl file if |
---|
| 476 | compiler error occurs. Try to identify the compiler error by first |
---|
| 477 | looking into the header file generated by ooddlx, and then locate the |
---|
| 478 | source of the problem by looking into the ddl file. |
---|
| 479 | A patch to the compiler is expected from Sun. |
---|
| 480 | |
---|
| 481 | |
---|
| 482 | 5. Compiler Specific Problems |
---|
| 483 | ----------------------------- |
---|
| 484 | |
---|
| 485 | o DEC V4.0, cxx C++ V6.1-027. |
---|
| 486 | |
---|
| 487 | - We have found cases of mis-compilation of min and max templates |
---|
| 488 | on DEC. We have traced those which cause serious malfunction |
---|
| 489 | but there is no guarantee that there are no other cases. |
---|
| 490 | Detailed inspection of assembler output suggests that this |
---|
| 491 | problem might not be confined to min and max. This has been |
---|
| 492 | reported to DEC/Compaq. We understand a new version 6.2 of the |
---|
| 493 | compiler is now available. However we cannot guarantee correct |
---|
| 494 | execution of Geant4 on DEC with the current version of the |
---|
| 495 | compiler. |
---|
| 496 | - A bug in cin.getline() system function causes an anomalous |
---|
| 497 | behavior when running in interactive-mode on DEC-cxx 6.1 in |
---|
| 498 | ISO/ANSI mode. We tested the bug has been fixed in more recent |
---|
| 499 | versions of the compiler. |
---|
| 500 | |
---|
| 501 | |
---|
| 502 | 6. Known Run-Time Problems and Limitations |
---|
| 503 | ------------------------------------------ |
---|
| 504 | |
---|
| 505 | For a complete list of outstanding run-time problems and to submit any |
---|
| 506 | problem you may find running this version of Geant4, please refer to the |
---|
| 507 | Geant4 Problem Reporting System, available on the Web at this address: |
---|
| 508 | |
---|
| 509 | http://cern.ch/geant4/problemreport |
---|
| 510 | |
---|
| 511 | |
---|
| 512 | 7. Compilation Warnings |
---|
| 513 | ----------------------- |
---|
| 514 | |
---|
| 515 | There are compilation warnings on some platforms. We do not believe |
---|
| 516 | that any will lead to incorrect run-time behaviour, but we are working |
---|
| 517 | on reducing them. |
---|
| 518 | |
---|
| 519 | |
---|
| 520 | 8. Known Run-Time Warnings |
---|
| 521 | -------------------------- |
---|
| 522 | |
---|
| 523 | The following messages can be written to error output while tracking. We |
---|
| 524 | believe none give rise to incorrect behaviour. |
---|
| 525 | |
---|
| 526 | o G4PropagateInField: Warning: Particle is looping |
---|
| 527 | - tracking in field will be stopped. |
---|
| 528 | It has performed 10000 steps in Field while a maximum of 10000 |
---|
| 529 | are allowed. |
---|