File indexing completed on 2025-01-18 09:16:07
0001 <HTML>
0002 <HEAD>
0003 <TITLE>Geant4 6.1 Release Notes</TITLE>
0004 </HEAD>
0005 <BODY BGCOLOR='F0F0F0'>
0006
0007 <P> </P>
0008 <BR>
0009 <P> </P>
0010
0011 <P ALIGN="Center">
0012 <FONT SIZE="+4" COLOR="#238E23">
0013 <B>Geant4 6.1 Release Notes</B>
0014 </FONT>
0015
0016 <TABLE WIDTH="100%">
0017 <TR><TD ALIGN="Right">
0018 <FONT SIZE="-1" COLOR="#5C3317">
0019 <B><I>March 25<SUP>th</SUP>, 2004</I></B>
0020 </FONT>
0021 </TD></TR>
0022 </TABLE>
0023
0024 <BR><BR>
0025 <HR ALIGN="Center" SIZE="7%">
0026 <P>
0027 The code and binary libraries for the supported systems are available
0028 through our <A TARGET="ext" HREF="http://cern.ch/geant4">Source Code Web page</A>.
0029 </P>
0030 <P>
0031 Please refer to the
0032 <A TARGET="ext" HREF="http://cern.ch/geant4/G4UsersDocuments/Overview/html">Geant4
0033 User Documentation</A> for further information about using Geant4.
0034 </P>
0035
0036 <H2><I>Contents</I></H2>
0037 <OL>
0038 <LI><A HREF="#1.">Supported and Tested Platforms</A></LI>
0039 <LI><A HREF="#2.">AIDA and CLHEP</A></LI>
0040 <LI><A HREF="#3.">Compiler Specific Problems</A></LI>
0041 <LI><A HREF="#4.">Known Run-Time Problems</A></LI>
0042 <LI><A HREF="#5.">Compilation Warnings</A></LI>
0043 <LI><A HREF="#6.">Known Run-Time Warnings</A></LI>
0044 <LI><A HREF="#7.">Major items for migration of user code</A></LI>
0045 <LI><A HREF="#8.">Detailed list of changes and fixes</A></LI>
0046 </OL>
0047
0048 <P> </P>
0049 <A NAME="1."></a>
0050 <HR>
0051
0052
0053
0054 <H2>1. Supported and Tested Platforms</H2>
0055
0056 Official platforms:
0057 <UL>
0058 <LI>SUN Solaris 5.8, C++ CC-5.4 Patch 111715-02.</LI>
0059 <LI>Linux, gcc 2.95.2, gcc 3.2.<BR>
0060 This configuration was tested with the RedHat 7.3 distribution,
0061 versions of Geant4 have also been compiled successfully on other
0062 Linux distributions, like Debian, Suse or more recent RedHat systems.
0063 The default RedHat compiler gcc-2.96 distributed in RedHat 7.X is NOT
0064 supported. It has been verified that it produces incorrect binaries,
0065 therefore is not reliable. See also <A HREF="#note-1">note below</A>.</LI>
0066 <LI>Windows/2000 and CygWin Tools with: Visual C++ 6.0 Service Pack 5</LI>
0067 </UL>
0068
0069 More verified configurations:
0070 <UL>
0071 <LI>SUN Solaris 5.8, C++ CC-5.5.</LI>
0072 <LI>Linux, gcc 3.3.3.</LI>
0073 <LI>Linux, Intel-icc 8.0.</LI>
0074 <LI>MacOS 10.3, gcc-3.3</LI>
0075 <LI>Windows/XP and CygWin Tools, .NET Visual Studio 2003 C++ 7.1</LI>
0076 </UL>
0077
0078 Platforms configured but not tested and not supported:
0079 <UL>
0080 <LI>AIX 4.3.2, xlC 6.0</LI>
0081 <LI>DEC V4.0, cxx C++ V6.1-027</LI>
0082 <LI>HP 10.20, aCC C++ B3910B A.01.23</LI>
0083 <LI>SGI V6.5.5, CC 7.2.1</LI>
0084 </UL>
0085
0086 <P> </P>
0087 <A NAME="2."></A>
0088 <HR>
0089
0090
0091
0092 <H2>2. AIDA and CLHEP</H2>
0093
0094 Geant4 6.1 requires the <A TARGET="ext"
0095 HREF="http://cern.ch/clhep/INSTALLATION/clhep.html">installation
0096 of CLHEP</A>.<BR>
0097 Tests have been performed with <B>CLHEP-1.8.1.0</B>.
0098 <P> </P>
0099 Geant4 6.1 examples with histogramming cowork with AIDA 3
0100 implementations. These include:
0101 <UL>
0102 <LI><A TARGET="ext" HREF="http://cern.ch/anaphe">ANAPHE</A> and included components</LI>
0103 <LI><A TARGET="ext" HREF="http://jas.freehep.org">JAS (Java Analysis Studio)</A></LI>
0104 <LI><A TARGET="ext" HREF="http://www.lal.in2p3.fr/OpenScientist">Open Scientist</A></LI>
0105 </UL>
0106
0107 AIDA headers can be downloaded from:
0108 <A TARGET="ext" HREF="http://aida.freehep.org">http://aida.freehep.org</A>
0109
0110
0111 <P> </P>
0112 <A NAME="3."></A>
0113 <HR>
0114
0115
0116
0117 <H2>3. Compiler Specific Problems</H2>
0118
0119 <UL>
0120 <LI><A NAME="note-1"><B>Linux Red Hat 7.X, gcc-2.96</B></A>.
0121 <UL>
0122 <LI>The default compiler distributed by Red Hat since release 7.0 is
0123 NOT supported and not considered reliable for running a Geant4-based
0124 application. In more than one test case, binaries produced by gcc-2.96
0125 have shown incorrect behavior, either due to wrong order of
0126 initialisation of static data in memory or to bugs in the system
0127 <TT>iostream</TT> classes, problems which apparently have all been
0128 solved in more recent versions of the compiler (3.X series).<BR>
0129 For information, gcc-2.96 is a compiler that has never been
0130 officially released, nor supported by the GNU team itself and is not
0131 considered reliable by the authors (for more information, see also
0132 <A TARGET="ext" HREF="http://gcc.gnu.org/gcc-2.96.html">http://gcc.gnu.org/gcc-2.96.html</A>).</LI>
0133 </UL></LI>
0134 </UL>
0135
0136 <P> </P>
0137 <A NAME="4."></A>
0138 <HR>
0139
0140
0141
0142 <H2>4. Known Run-Time Problems and Limitations</H2>
0143
0144 For a complete list of outstanding run-time problems and to submit any
0145 problem you may find running this version of Geant4, please refer to the
0146 <A TARGET="ext" HREF="http://cern.ch/geant4/problemreport">Geant4 Problem Reporting
0147 System</A>.
0148
0149
0150 <P> </P>
0151 <A NAME="5."></A>
0152 <HR>
0153
0154
0155
0156 <H2>5. Compilation Warnings</H2>
0157
0158 There may be compilation warnings on some platforms. We do not believe
0159 that any will lead to incorrect run-time behaviour.
0160
0161
0162 <P> </P>
0163 <A NAME="6."></A>
0164 <HR>
0165
0166
0167
0168 <H2>6. Known Run-Time Warnings</H2>
0169
0170 The following messages can be written to error output while tracking.
0171 We believe none give rise to incorrect behaviour.
0172 <PRE>
0173 G4PropagateInField: Warning: Particle is looping
0174 - tracking in field will be stopped.
0175 It has performed 1000 steps in Field while a maximum of 1000
0176 are allowed.
0177 </PRE>
0178
0179
0180 <P> </P>
0181 <A NAME="7."></A>
0182 <HR>
0183
0184
0185
0186 <H2>7. Major items for migration of user code</H2>
0187
0188 There not known migrations necessary if upgrading from release 6.0,
0189 other than recompilation and/or reinstallation of libraries and user
0190 applications.
0191
0192 <P> </P>
0193 <A NAME="8."></A>
0194 <HR>
0195
0196
0197
0198 <H2>8. Detailed list of changes and fixes</H2>
0199
0200 These are the main new features/fixes included in this release since the
0201 last patched public release (for the detailed list of fixes/additions,
0202 please refer to the related History files provided in most packages):
0203
0204 <P> </P>
0205
0206 <A NAME="conf-notes">
0207 <H3><I>Configuration</I></H3></A>
0208 <UL>
0209 <LI>Fixes in the experimental configuration file <TT>Linux-icc.gmk</TT>
0210 for Intel/icc compiler on Linux systems.</LI>
0211 <LI><TT>WIN32-VC7.gmk</TT>: added material to build shared-libs for
0212 Windows (DLLs), for future use.<BR>
0213 Added program <TT>win32def.c</TT> to help building DLLs, for
0214 future use.</LI>
0215 </UL>
0216
0217 <A NAME="dgt-notes">
0218 <H3><I>Digitization & Hits</I></H3></A>
0219 <UL>
0220 <LI>Added methods to <TT>G4HCtable</TT> for additional verbosity.</LI>
0221 </UL>
0222
0223 <A NAME="evt-notes">
0224 <H3><I>Event</I></H3></A>
0225 <UL>
0226 <LI><TT>LocateGlobalPointAndSetup()</TT> method of <TT>G4Navigator</TT>
0227 is now invoked at the beginning of each new event to reset the
0228 navigation history.</LI>
0229 <LI>Bug Fix in the destructor of <TT>G4ParticleGunMessenger</TT>.</LI>
0230 </UL>
0231
0232 <A NAME="emlow-notes">
0233 <H3><I>Electromagnetic Processes (Low-energy)</I></H3></A>
0234 <UL>
0235 <LI>Implemented optimization of Bremsstrahlung angular generators.</LI>
0236 <LI>Bug fixes in <TT>G4IonisationParameters</TT>, <TT>G4PenelopeCompton</TT>
0237 and <TT>G4PenelopeIonisation</TT>.</LI>
0238 <LI>Fixed some compilation warnings on Intel/icc compiler.</LI>
0239 <LI>Bug fix in <TT>G4PenelopeRayleigh</TT>, related to problem report #605.</LI>
0240 <LI>Performance improvement in <TT>G4Generator2BN</TT> and Penelope
0241 processes.</LI>
0242 </UL>
0243
0244 <A NAME="emstd-notes">
0245 <H3><I>Electromagnetic Processes (Standard)</I></H3></A>
0246 <UL>
0247 <LI>Bug Fixes in model variant of multiple-scattering; simplified calculation
0248 of energy dependence of internal parameters.<BR>
0249 <TT>G4MscModel</TT>: corrections to path length conversion and theta angle.</LI>
0250 <LI>Updated parameterizations in G4MuPairProductionModel for energies
0251 over ~100 GeV. Precision of differential cross section parameterization is
0252 improved from 30% to 5%.</LI>
0253 <LI>Updated radiative corrections calculation for <TT>G4MuBetheBlochModel</TT>
0254 for muon energy above 1 GeV. Accuracy of energy loss of high energy muons
0255 updated from 10% to 2%.</LI>
0256 <LI>Fixed problem of ionisation in air with low pressure less than
0257 <TT>10<SUP>-4</SUP> Atm</TT>. Setting <TT>lowestKinEnergy</TT> to <TT>1.*eV</TT>,
0258 in <TT>G4VEnergyLossProcess</TT>.</LI>
0259 <LI>Fixed problem of simulation of fluctuation of energy losses in very
0260 small steps.</LI>
0261 <LI>Activated new optional feature, <I>PreciseRange</I> option, which
0262 provides ranges of particles calculated from total (not-truncated
0263 by cut) energy loss. Relevant for energies less than <TT>1 MeV</TT>
0264 and effect sampling calorimeter results.</LI>
0265 <LI>Added new class <TT>G4EmProcessOptions</TT> to be used in physics lists.
0266 <LI>Fixes in constructor of discrete processes for setting of process type.</LI>
0267 </UL>
0268
0269 <A NAME="gen-notes">
0270 <H3><I>General Processes, Parameterisation, Cuts, Decay, Optical</I></H3></A>
0271 <UL>
0272 <LI><B>Decay</B>:
0273 <UL>
0274 <LI>Fixed bug in <TT>PostStepGPIL()</TT> in case of stopping
0275 during AlongStep actions.</LI>
0276 </UL></LI>
0277 <LI><B>Optical</B>:
0278 <UL>
0279 <LI><TT>G4OpBoundaryProcess</TT>:
0280 <UL>
0281 <LI>Added process status <TT>NotAtBoundary</TT>, <TT>SameMaterial</TT>,
0282 <TT>StepTooSmall</TT>, <TT>NoRINDEX</TT>. Allowing for a
0283 skin-surface between mother and daughter volumes, with the
0284 daughter skin taking precedence.</LI>
0285 <LI>Initialise all class members in constructor.</LI>
0286 </UL></LI>
0287 </UL></LI>
0288 </UL>
0289
0290 <A NAME="geo-notes">
0291 <H3><I>Geometry</I></H3></A>
0292 <UL>
0293 <LI><B>Navigation</B>
0294 <UL>
0295 <LI><TT>G4Navigator</TT>: fixed old outstanding bug in
0296 <TT>ComputeStep()</TT> for the location of the local point in
0297 the calculation of a valid exit normal.</LI>
0298 <LI>Added <I>check_mode</I> state for navigators. The state can be
0299 activated by a new UI command
0300 (<TT>geometry/navigator/check_mode [true/false]</TT>) and will
0301 force more strict and less tolerant checks in step/safety computation
0302 to verify the correctness of solids' response in the geometry.</LI>
0303 <LI>Reorganised verbosity levels. Added more useful information activated
0304 when in <TT>G4VERBOSE</TT> mode and verbosity level selected.<BR>
0305 Fixed output formatting when entering/exiting verbose blocks.</LI>
0306 </UL></LI>
0307 <LI><B>Solids</B>
0308 <UL>
0309 <LI><I>Boolean solids</I>:
0310 <UL>
0311 <LI><TT>G4UnionSolid</TT>, <TT>G4SubtractionSolid</TT>: fix in debug
0312 printout for <TT>SurfaceNomal()</TT>.</LI>
0313 </UL></LI>
0314 <LI><I>CSG solids</I>:
0315 <UL>
0316 <LI><TT>G4Torus</TT>: fixed bug in <TT>Inside(p)</TT>, fixing warnings
0317 of '<TT>point p is outside</TT>' observed when running in
0318 debug-mode.</LI>
0319 </UL></LI>
0320 </UL></LI>
0321 </UL>
0322
0323 <A NAME="glob-notes">
0324 <H3><I>Global</I></H3></A>
0325 <UL>
0326 <LI>Removed obsolete "<TT>includes</TT>" target in <TT>management/GNUmakefile</TT>.</LI>
0327 <LI>Corrected comments in <TT>G4UserLimits</TT> header.</LI>
0328 </UL>
0329
0330 <A NAME="had-notes">
0331 <H3><I>Hadronic Processes</I></H3></A>
0332 <UL>
0333 <LI><B>management & utils</B>
0334 <UL>
0335 <LI>Added a white-board functionality to allow for in-core inspection
0336 of reaction conditions in optimized.</LI>
0337 <LI>Added a signal-handler (for SIGSEGV) that prints the reaction
0338 conditions before handling it over to the experiment (or default)
0339 signal handler.</LI>
0340 <LI>Fixed cases of double deletion of memory in cases when
0341 isotope-production models are used.</LI>
0342 <LI>Run-time checking for <TT>NaN</TT> values of energies of
0343 secondaries.</LI>
0344 <LI>Fix for suspended particles (only neutron_hp model has these).</LI>
0345 <LI>Rudimentary verification of consistancy of hadronic physics.</LI>
0346 <LI>Transition to <TT>std::pair</TT> in <TT>G4Pair</TT>.</LI>
0347 </UL></LI>
0348 <LI><B>models/binary_cascade</B>
0349 <UL>
0350 <LI>Fixed a few memory leaks in <TT>G4BinaryLightIonReaction</TT>.</LI>
0351 <LI>Fix for single nucleon spectator, resulting in occasional
0352 momentum non-conservation.</LI>
0353 <LI>Removed one recurring run time warning from <TT>G4RKPropagation</TT>.
0354 Relates to problem report #593.</LI>
0355 </UL></LI>
0356 <LI><B>models/chiral_inv_phase_space</B>
0357 <UL>
0358 <LI>Major improvement of the CHIPS nuclear fragmentation model: in
0359 addition to Lambdas, now Sigmas, Xi, and Omega hyperons are added to
0360 the fragmentation algorithm (together with N+Sigma and NN+Sigma nuclear
0361 fragments); Delta isobars together with iso-nuclei are implemented
0362 as an intermediate states of fragmentation; all leptons are added to
0363 the CHIPSWorld of particles, so that now the CHIPS model is ready for
0364 nuclear muon-minus capture at rest process and for the neutrino-nuclear
0365 reactions.</LI>
0366 <LI>Implemented new debug system of step by step energy/momentum and
0367 charge/baryon_number conservation control.</LI>
0368 <LI>Resolved en/mom conflicts in the Sigma+Delta++ and Sigma-Delta-
0369 final states.</LI>
0370 <LI>Corrected baryon number and charge non conservation observed in some
0371 decays.</lI>
0372 <LI>Cleared unnecessary run-time warnings, for which it was tested that
0373 the conflict situation is successfully resolved.</LI>
0374 <LI>Fixed bug for Delta-,Delta-,n under 3n+2pi- together with all possible
0375 Delta-Delta-,(k*n) under (k+2)*n+2pi- threshold and Delta++,Delta++,
0376 (k*p) under (k+2)*p+2pi+ threshold possible fragmentation states.</LI>
0377 <LI>Bug fixes and porting in the interface classses.</LI>
0378 </UL></LI>
0379 <LI><B>models/im_r_matrix</B>
0380 <UL>
0381 <LI>Improved configuration and configurability, using TMPs.</LI>
0382 </UL></LI>
0383 <LI><B>models/leading_particle</B>
0384 <UL>
0385 <LI>Added constructor message, specifying what code is used.</LI>
0386 </UL></LI>
0387 <LI><B>models/neutron_hp</B>
0388 <UL>
0389 <LI>Bug fix concerning Mandrake/Linux (CSTOP enum replaced).</LI>
0390 <LI>Fixed Valgrind run-time error on <TT>G4NeutronHPVector</TT>.</LI>
0391 </UL></LI>
0392 <LI><B>models/qgsm</B>
0393 <UL>
0394 <LI>Introduced minimal transverse mass for diffractive
0395 scattering of gammas.</LI>
0396 </UL></LI>
0397 <LI><B>stopping</B>
0398 <UL>
0399 <LI>Updated implementation of mu-nuclear absorption at rest.</LI>
0400 </UL></LI>
0401 </UL>
0402
0403 <A NAME="part-notes">
0404 <H3><I>Particles</I></H3></A>
0405 <UL>
0406 <LI>Updated mass and width to meet with PDG 2002 data.</LI>
0407 <LI>Added classes for retrieving particle properties from file:
0408 <UL>
0409 <LI>Base class <TT>G4VParticlePropertyRetriever</TT>.</LI>
0410 <LI>Classes <TT>G4TextPPReporter</TT> and <TT>G4TextPPRetriever</TT>.</LI>
0411 </UL></LI>
0412 </UL>
0413
0414 <A NAME="readout-notes">
0415 <H3><I>Readout</I></H3></A>
0416 <UL>
0417 <LI>Added some methods in <TT>G4DCtable</TT> to enhance a verbosity.</LI>
0418 </UL>
0419
0420 <A NAME="run-notes">
0421 <H3><I>Run, Intercoms and Interfaces</I></H3></A>
0422 <UL>
0423 <LI><TT>G4RunManager</TT>:
0424 <UL>
0425 <LI>Invocation of <TT>G4Navigator::LocateGlobalPointAndSetup()</TT> is now
0426 moved to <TT>G4EventManager</TT> so that the navigation history is
0427 reset for every new event.</LI>
0428 <LI>Added reference and WWW information to run-time header.</LI>
0429 </UL></LI>
0430 </UL>
0431
0432 <A NAME="vis-notes">
0433 <H3><I>Visualization</I></H3></A>
0434 <UL>
0435 <LI><B>HepRep</B>
0436 <UL>
0437 <LI>HepRepFile handle duplicate <TT>ShowView</TT>.</LI>
0438 <LI>HepRepFile improve layering and hierarchy for hits.</LI>
0439 <LI>Fixed compilation warnings for the Linux-icc (8.0) compiler.</LI>
0440 <LI>Removed appendzip.cc file, not strictly necessary.
0441 Fixes problem report #570.</LI>
0442 <LI>Renamed the HepRep schema locator to new web URL.</LI>
0443 </UL></LI>
0444 <LI><B>OpenGL</B>
0445 <UL>
0446 <LI>Fixed wrong order of statements in <TT>G4OpenGLXViewer</TT>
0447 destructor. Fixes bug report #581.</LI>
0448 </UL></LI>
0449 <LI><B>management</B>
0450 <UL>
0451 <LI>Added checks and minor improvement of behaviour at end of event
0452 and run.</LI>
0453 </UL></LI>
0454 </UL>
0455
0456 <A NAME="hlst-notes">
0457 <H3><I>Hadronic physics-lists</I></H3></A>
0458 <UL>
0459 <LI>Updates to package 4.1 (QGSP_BIC, QGSP_BERT).</LI>
0460 </UL>
0461
0462 <A NAME="ex-notes">
0463 <H3><I>Examples</I></H3></A>
0464 <UL>
0465 <LI>Updated reference outputs.</LI>
0466 <LI><B>advanced</B>
0467 <UL>
0468 <LI><I>brachytherapy</I>
0469 <UL>
0470 <LI>Added a new histogram and some code cleanup.</LI>
0471 </UL></LI>
0472 <LI><I>composite_calorimeter</I>
0473 <UL>
0474 <LI>Removed redefinition of streaming operator for
0475 <TT>G4LorentzVector</TT> in <TT>CCalRotationMatrixFactory</TT>,
0476 causing compilation problems on some compiler/system
0477 configurations.</LI>
0478 </UL></LI>
0479 <LI><I>Rich</I>
0480 <UL>
0481 <LI>Fixed compilation errors and warnings for gcc-3.2.</LI>
0482 </UL></LI>
0483 </UL></LI>
0484 <LI><B>extended</B>
0485 <UL>
0486 <LI><I>biasing/B01</I>
0487 <UL>
0488 <LI>Open the geometry to cleanly clear biasing stores
0489 at the end of the application.</LI>
0490 </UL></LI>
0491 <LI><I>electromagnetic/TestEm5</I>
0492 <UL>
0493 <LI>Modified histo 7: projected position at exit.</LI>
0494 <LI>RunAction: removed UI commands for visualisation,
0495 added a function <TT>ComputeMscHighland()</TT>.</LI>
0496 </UL></LI>
0497 <LI><I>field</I>
0498 <UL>
0499 <LI>Fixed methods that change the field to update the equation and
0500 field-manager in field01 and field03.</LI>
0501 </UL></LI>
0502 <LI><I>medical/DICOM</I>
0503 <UL>
0504 <LI>Added History file, changed README.</LI>
0505 </UL></LI>
0506 </UL></LI>
0507 <LI><B>novice</B>
0508 <UL>
0509 <LI><I>N06</I>
0510 <UL>
0511 <LI>DetectorConstruction: changed surface model between
0512 <TT>OpWaterSurface</TT> and <TT>OpAirSurface</TT>.</LI>
0513 </UL></LI>
0514 </UL></LI>
0515 </UL>
0516
0517 <HR>
0518
0519 </BODY>
0520 </HTML>
