source: trunk/ReleaseNotes/ReleaseNotes4.6.1.html

Last change on this file was 1337, checked in by garnier, 14 years ago

tag geant4.9.4 beta 1 + modifs locales
File size: 17.3 KB
Line 
1<HTML>
2<HEAD>
3<TITLE>Geant4 6.1 Release Notes</TITLE>
4</HEAD>
5<BODY BGCOLOR='F0F0F0'>
6
7<P> </P>
8<BR>
9<P> </P>
10
11<P ALIGN="Center">
12<FONT SIZE="+4" COLOR="#238E23">
13<B>Geant4 6.1 Release Notes</B>
14</FONT>
15
16<TABLE WIDTH="100%">
17<TR><TD ALIGN="Right">
18<FONT SIZE="-1" COLOR="#5C3317">
19<B><I>March 25<SUP>th</SUP>, 2004</I></B>
20</FONT>
21</TD></TR>
22</TABLE>
23
24<BR><BR>
25<HR ALIGN="Center" SIZE="7%">
26<P>
27The code and binary libraries for the supported systems are available
28through our <A TARGET="ext" HREF="http://cern.ch/geant4">Source Code Web page</A>.
29</P>
30<P>
31Please refer to the
32<A TARGET="ext" HREF="http://cern.ch/geant4/G4UsersDocuments/Overview/html">Geant4
33User Documentation</A> for further information about using Geant4.
34</P>
35
36<H2><I>Contents</I></H2>
37<OL>
38<LI><A HREF="#1.">Supported and Tested Platforms</A></LI>
39<LI><A HREF="#2.">AIDA and CLHEP</A></LI>
40<LI><A HREF="#3.">Compiler Specific Problems</A></LI>
41<LI><A HREF="#4.">Known Run-Time Problems</A></LI>
42<LI><A HREF="#5.">Compilation Warnings</A></LI>
43<LI><A HREF="#6.">Known Run-Time Warnings</A></LI>
44<LI><A HREF="#7.">Major items for migration of user code</A></LI>
45<LI><A HREF="#8.">Detailed list of changes and fixes</A></LI>
46</OL>
47
48<P> </P>
49<A NAME="1."></a>
50<HR>
51
52<!-- ============================================== -->
53
54<H2>1. Supported and Tested Platforms</H2>
55
56Official platforms:
57<UL>
58<LI>SUN Solaris 5.8, C++ CC-5.4 Patch 111715-02.</LI>
59<LI>Linux, gcc 2.95.2, gcc 3.2.<BR>
60    This configuration was tested with the RedHat 7.3 distribution,
61    versions of Geant4 have also been compiled successfully on other
62    Linux distributions, like Debian, Suse or more recent RedHat systems.
63    The default RedHat compiler gcc-2.96 distributed in RedHat 7.X is NOT
64    supported. It has been verified that it produces incorrect binaries,
65    therefore is not reliable. See also <A HREF="#note-1">note below</A>.</LI>
66<LI>Windows/2000 and CygWin Tools with: Visual C++ 6.0 Service Pack 5</LI>
67</UL>
68
69More verified configurations:
70<UL>
71<LI>SUN Solaris 5.8, C++ CC-5.5.</LI>
72<LI>Linux, gcc 3.3.3.</LI>
73<LI>Linux, Intel-icc 8.0.</LI>
74<LI>MacOS 10.3, gcc-3.3</LI>
75<LI>Windows/XP and CygWin Tools, .NET Visual Studio 2003 C++ 7.1</LI>
76</UL>
77
78Platforms configured but not tested and not supported:
79<UL>
80<LI>AIX 4.3.2, xlC 6.0</LI>
81<LI>DEC V4.0, cxx C++ V6.1-027</LI>
82<LI>HP 10.20, aCC C++ B3910B A.01.23</LI>
83<LI>SGI V6.5.5, CC 7.2.1</LI>
84</UL>
85
86<P> </P>
87<A NAME="2."></A>
88<HR>
89
90<!-- ============================================== -->
91
92<H2>2. AIDA and CLHEP</H2>
93
94Geant4 6.1 requires the <A TARGET="ext"
95HREF="http://cern.ch/clhep/INSTALLATION/clhep.html">installation
96of CLHEP</A>.<BR>
97Tests have been performed with <B>CLHEP-1.8.1.0</B>.
98<P> </P>
99Geant4 6.1 examples with histogramming cowork with AIDA 3
100implementations. These include:
101<UL>
102<LI><A TARGET="ext" HREF="http://cern.ch/anaphe">ANAPHE</A> and included components</LI>
103<LI><A TARGET="ext" HREF="http://jas.freehep.org">JAS (Java Analysis Studio)</A></LI>
104<LI><A TARGET="ext" HREF="http://www.lal.in2p3.fr/OpenScientist">Open Scientist</A></LI>
105</UL>
106
107AIDA headers can be downloaded from:
108<A TARGET="ext" HREF="http://aida.freehep.org">http://aida.freehep.org</A>
109
110
111<P> </P>
112<A NAME="3."></A>
113<HR>
114
115<!-- ============================================== -->
116
117<H2>3. Compiler Specific Problems</H2>
118
119<UL>
120<LI><A NAME="note-1"><B>Linux Red Hat 7.X, gcc-2.96</B></A>.
121<UL>
122<LI>The default compiler distributed by Red Hat since release 7.0 is
123    NOT supported and not considered reliable for running a Geant4-based
124    application. In more than one test case, binaries produced by gcc-2.96
125    have shown incorrect behavior, either due to wrong order of
126    initialisation of static data in memory or to bugs in the system
127    <TT>iostream</TT> classes, problems which apparently have all been
128    solved in more recent versions of the compiler (3.X series).<BR>
129    For information, gcc-2.96 is a compiler that has never been
130    officially released, nor supported by the GNU team itself and is not
131    considered reliable by the authors (for more information, see also
132    <A TARGET="ext" HREF="http://gcc.gnu.org/gcc-2.96.html">http://gcc.gnu.org/gcc-2.96.html</A>).</LI>
133</UL></LI>
134</UL>
135
136<P> </P>
137<A NAME="4."></A>
138<HR>
139
140<!-- ============================================== -->
141
142<H2>4. Known Run-Time Problems and Limitations</H2>
143
144For a complete list of outstanding run-time problems and to submit any
145problem you may find running this version of Geant4, please refer to the
146<A TARGET="ext" HREF="http://cern.ch/geant4/problemreport">Geant4 Problem Reporting
147System</A>.
148
149
150<P> </P>
151<A NAME="5."></A>
152<HR>
153
154<!-- ============================================== -->
155
156<H2>5. Compilation Warnings</H2>
157
158There may be compilation warnings on some platforms.  We do not believe
159that any will lead to incorrect run-time behaviour.
160
161
162<P> </P>
163<A NAME="6."></A>
164<HR>
165
166<!-- ============================================== -->
167
168<H2>6. Known Run-Time Warnings</H2>
169
170The following messages can be written to error output while tracking.
171We believe none give rise to incorrect behaviour.
172<PRE>
173    G4PropagateInField: Warning: Particle is looping
174    -  tracking in field will be stopped.
175       It has performed 1000 steps in Field while a maximum of 1000
176       are allowed.
177</PRE>
178
179
180<P> </P>
181<A NAME="7."></A>
182<HR>
183
184<!-- ============================================== -->
185
186<H2>7. Major items for migration of user code</H2>
187
188There not known migrations necessary if upgrading from release 6.0,
189other than recompilation and/or reinstallation of libraries and user
190applications.
191
192<P> </P>
193<A NAME="8."></A>
194<HR>
195
196<!-- ============================================== -->
197
198<H2>8. Detailed list of changes and fixes</H2>
199
200These are the main new features/fixes included in this release since the
201last patched public release (for the detailed list of fixes/additions,
202please refer to the related History files provided in most packages):
203
204<P> </P>
205
206<A NAME="conf-notes">
207<H3><I>Configuration</I></H3></A>
208<UL>
209<LI>Fixes in the experimental configuration file <TT>Linux-icc.gmk</TT>
210    for Intel/icc compiler on Linux systems.</LI>
211<LI><TT>WIN32-VC7.gmk</TT>: added material to build shared-libs for
212    Windows (DLLs), for future use.<BR>
213    Added program <TT>win32def.c</TT> to help building DLLs, for
214    future use.</LI>
215</UL>
216
217<A NAME="dgt-notes">
218<H3><I>Digitization & Hits</I></H3></A>
219<UL>
220<LI>Added methods to <TT>G4HCtable</TT> for additional verbosity.</LI>
221</UL>
222
223<A NAME="evt-notes">
224<H3><I>Event</I></H3></A>
225<UL>
226<LI><TT>LocateGlobalPointAndSetup()</TT> method of <TT>G4Navigator</TT>
227    is now invoked at the beginning of each new event to reset the
228    navigation history.</LI>
229<LI>Bug Fix in the destructor of <TT>G4ParticleGunMessenger</TT>.</LI>
230</UL>
231
232<A NAME="emlow-notes">
233<H3><I>Electromagnetic Processes (Low-energy)</I></H3></A>
234<UL>
235<LI>Implemented optimization of Bremsstrahlung angular generators.</LI>
236<LI>Bug fixes in <TT>G4IonisationParameters</TT>, <TT>G4PenelopeCompton</TT>
237    and <TT>G4PenelopeIonisation</TT>.</LI>
238<LI>Fixed some compilation warnings on Intel/icc compiler.</LI>
239<LI>Bug fix in <TT>G4PenelopeRayleigh</TT>, related to problem report #605.</LI>
240<LI>Performance improvement in <TT>G4Generator2BN</TT> and Penelope
241    processes.</LI>
242</UL>
243
244<A NAME="emstd-notes">
245<H3><I>Electromagnetic Processes (Standard)</I></H3></A>
246<UL>
247<LI>Bug Fixes in model variant of multiple-scattering; simplified calculation
248    of energy dependence of internal parameters.<BR>
249    <TT>G4MscModel</TT>: corrections to path length conversion and theta angle.</LI>
250<LI>Updated parameterizations in G4MuPairProductionModel for energies
251    over ~100 GeV. Precision of differential cross section parameterization is
252    improved from 30% to 5%.</LI>
253<LI>Updated radiative corrections calculation for <TT>G4MuBetheBlochModel</TT>
254    for muon energy above 1 GeV. Accuracy of energy loss of high energy muons
255    updated from 10% to 2%.</LI>
256<LI>Fixed problem of ionisation in air with low pressure less than
257    <TT>10<SUP>-4</SUP> Atm</TT>. Setting <TT>lowestKinEnergy</TT> to <TT>1.*eV</TT>,
258    in <TT>G4VEnergyLossProcess</TT>.</LI>
259<LI>Fixed problem of simulation of fluctuation of energy losses in very
260    small steps.</LI>
261<LI>Activated new optional feature, <I>PreciseRange</I> option, which
262    provides ranges of particles calculated from total (not-truncated
263    by cut) energy loss. Relevant for energies less than <TT>1 MeV</TT>
264    and effect sampling calorimeter results.</LI>
265<LI>Added new class <TT>G4EmProcessOptions</TT> to be used in physics lists.
266<LI>Fixes in constructor of discrete processes for setting of process type.</LI>
267</UL>
268
269<A NAME="gen-notes">
270<H3><I>General Processes, Parameterisation, Cuts, Decay, Optical</I></H3></A>
271<UL>
272<LI><B>Decay</B>:
273    <UL>
274    <LI>Fixed bug in <TT>PostStepGPIL()</TT> in case of stopping
275        during AlongStep actions.</LI>
276    </UL></LI>
277<LI><B>Optical</B>:
278    <UL>
279    <LI><TT>G4OpBoundaryProcess</TT>:
280        <UL>
281        <LI>Added process status <TT>NotAtBoundary</TT>, <TT>SameMaterial</TT>,
282            <TT>StepTooSmall</TT>, <TT>NoRINDEX</TT>. Allowing for a
283            skin-surface between mother and daughter volumes, with the
284            daughter skin taking precedence.</LI>
285        <LI>Initialise all class members in constructor.</LI>
286        </UL></LI>
287    </UL></LI>
288</UL>
289
290<A NAME="geo-notes">
291<H3><I>Geometry</I></H3></A>
292<UL>
293<LI><B>Navigation</B>
294    <UL>
295    <LI><TT>G4Navigator</TT>: fixed old outstanding bug in
296        <TT>ComputeStep()</TT> for the location of the local point in
297        the calculation of a valid exit normal.</LI>
298    <LI>Added <I>check_mode</I> state for navigators. The state can be
299        activated by a new UI command
300        (<TT>geometry/navigator/check_mode [true/false]</TT>) and will
301        force more strict and less tolerant checks in step/safety computation
302        to verify the correctness of solids' response in the geometry.</LI>
303    <LI>Reorganised verbosity levels. Added more useful information activated
304        when in <TT>G4VERBOSE</TT> mode and verbosity level selected.<BR>
305        Fixed output formatting when entering/exiting verbose blocks.</LI>
306    </UL></LI>
307<LI><B>Solids</B>
308    <UL>
309    <LI><I>Boolean solids</I>:
310        <UL>
311        <LI><TT>G4UnionSolid</TT>, <TT>G4SubtractionSolid</TT>: fix in debug
312            printout for <TT>SurfaceNomal()</TT>.</LI>
313        </UL></LI>
314    <LI><I>CSG solids</I>:
315        <UL>
316        <LI><TT>G4Torus</TT>: fixed bug in <TT>Inside(p)</TT>, fixing warnings
317            of '<TT>point p is outside</TT>' observed when running in
318            debug-mode.</LI>
319        </UL></LI>
320    </UL></LI>
321</UL>
322
323<A NAME="glob-notes">
324<H3><I>Global</I></H3></A>
325<UL>
326<LI>Removed obsolete "<TT>includes</TT>" target in <TT>management/GNUmakefile</TT>.</LI>
327<LI>Corrected comments in <TT>G4UserLimits</TT> header.</LI>
328</UL>
329
330<A NAME="had-notes">
331<H3><I>Hadronic Processes</I></H3></A>
332<UL>
333<LI><B>management & utils</B>
334    <UL>
335    <LI>Added a white-board functionality to allow for in-core inspection
336        of reaction conditions in optimized.</LI>
337    <LI>Added a signal-handler (for SIGSEGV) that prints the reaction
338        conditions before handling it over to the experiment (or default)
339        signal handler.</LI>
340    <LI>Fixed cases of double deletion of memory in cases when
341        isotope-production models are used.</LI>
342    <LI>Run-time checking for <TT>NaN</TT> values of energies of
343        secondaries.</LI>
344    <LI>Fix for suspended particles (only neutron_hp model has these).</LI>
345    <LI>Rudimentary verification of consistancy of hadronic physics.</LI>
346    <LI>Transition to <TT>std::pair</TT> in <TT>G4Pair</TT>.</LI>
347    </UL></LI>
348<LI><B>models/binary_cascade</B>
349    <UL>
350    <LI>Fixed a few memory leaks in <TT>G4BinaryLightIonReaction</TT>.</LI>
351    <LI>Fix for single nucleon spectator, resulting in occasional
352        momentum non-conservation.</LI>
353    <LI>Removed one recurring run time warning from <TT>G4RKPropagation</TT>.
354        Relates to problem report #593.</LI>
355    </UL></LI>
356<LI><B>models/chiral_inv_phase_space</B>
357    <UL>
358    <LI>Major improvement of the CHIPS nuclear fragmentation model: in
359        addition to Lambdas, now Sigmas, Xi, and Omega hyperons are added to
360        the fragmentation algorithm (together with N+Sigma and NN+Sigma nuclear
361        fragments); Delta isobars together with iso-nuclei are implemented
362        as an intermediate states of fragmentation; all leptons are added to
363        the CHIPSWorld of particles, so that now the CHIPS model is ready for
364        nuclear muon-minus capture at rest process and for the neutrino-nuclear
365        reactions.</LI>
366    <LI>Implemented new debug system of step by step energy/momentum and
367        charge/baryon_number conservation control.</LI>
368    <LI>Resolved en/mom conflicts in the Sigma+Delta++ and Sigma-Delta-
369        final states.</LI>
370    <LI>Corrected baryon number and charge non conservation observed in some
371        decays.</lI>
372    <LI>Cleared unnecessary run-time warnings, for which it was tested that
373        the conflict situation is successfully resolved.</LI>
374    <LI>Fixed bug for Delta-,Delta-,n under 3n+2pi- together with all possible
375        Delta-Delta-,(k*n) under (k+2)*n+2pi- threshold and Delta++,Delta++,
376        (k*p) under (k+2)*p+2pi+ threshold possible fragmentation states.</LI>
377    <LI>Bug fixes and porting in the interface classses.</LI>
378    </UL></LI>
379<LI><B>models/im_r_matrix</B>
380    <UL>
381    <LI>Improved configuration and configurability, using TMPs.</LI>
382    </UL></LI>
383<LI><B>models/leading_particle</B>
384    <UL>
385    <LI>Added constructor message, specifying what code is used.</LI>
386    </UL></LI>
387<LI><B>models/neutron_hp</B>
388    <UL>
389    <LI>Bug fix concerning Mandrake/Linux (CSTOP enum replaced).</LI>
390    <LI>Fixed Valgrind run-time error on <TT>G4NeutronHPVector</TT>.</LI>
391    </UL></LI>
392<LI><B>models/qgsm</B>
393    <UL>
394    <LI>Introduced minimal transverse mass for diffractive
395        scattering of gammas.</LI>
396    </UL></LI>
397<LI><B>stopping</B>
398    <UL>
399    <LI>Updated implementation of mu-nuclear absorption at rest.</LI>
400    </UL></LI>
401</UL>
402
403<A NAME="part-notes">
404<H3><I>Particles</I></H3></A>
405<UL>
406<LI>Updated mass and width to meet with PDG 2002 data.</LI>
407<LI>Added classes for retrieving particle properties from file:
408    <UL>
409    <LI>Base class <TT>G4VParticlePropertyRetriever</TT>.</LI>
410    <LI>Classes <TT>G4TextPPReporter</TT> and <TT>G4TextPPRetriever</TT>.</LI>
411    </UL></LI>
412</UL>
413
414<A NAME="readout-notes">
415<H3><I>Readout</I></H3></A>
416<UL>
417<LI>Added some methods in <TT>G4DCtable</TT> to enhance a verbosity.</LI>
418</UL>
419
420<A NAME="run-notes">
421<H3><I>Run, Intercoms and Interfaces</I></H3></A>
422<UL>
423<LI><TT>G4RunManager</TT>:
424    <UL>
425    <LI>Invocation of <TT>G4Navigator::LocateGlobalPointAndSetup()</TT> is now
426        moved to <TT>G4EventManager</TT> so that the navigation history is
427        reset for every new event.</LI>
428    <LI>Added reference and WWW information to run-time header.</LI>
429    </UL></LI>
430</UL>
431
432<A NAME="vis-notes">
433<H3><I>Visualization</I></H3></A>
434<UL>
435<LI><B>HepRep</B>
436    <UL>
437    <LI>HepRepFile handle duplicate <TT>ShowView</TT>.</LI>
438    <LI>HepRepFile improve layering and hierarchy for hits.</LI>
439    <LI>Fixed compilation warnings for the Linux-icc (8.0) compiler.</LI>
440    <LI>Removed appendzip.cc file, not strictly necessary.
441        Fixes problem report #570.</LI>
442    <LI>Renamed the HepRep schema locator to new web URL.</LI>
443    </UL></LI>
444<LI><B>OpenGL</B>
445    <UL>
446    <LI>Fixed wrong order of statements in <TT>G4OpenGLXViewer</TT>
447        destructor. Fixes bug report #581.</LI>
448    </UL></LI>
449<LI><B>management</B>
450    <UL>
451    <LI>Added checks and minor improvement of behaviour at end of event
452        and run.</LI>
453    </UL></LI>
454</UL>
455
456<A NAME="hlst-notes">
457<H3><I>Hadronic physics-lists</I></H3></A>
458<UL>
459<LI>Updates to package 4.1 (QGSP_BIC, QGSP_BERT).</LI>
460</UL>
461
462<A NAME="ex-notes">
463<H3><I>Examples</I></H3></A>
464<UL>
465<LI>Updated reference outputs.</LI>
466<LI><B>advanced</B>
467    <UL>
468    <LI><I>brachytherapy</I>
469       <UL>
470         <LI>Added a new histogram and some code cleanup.</LI>
471       </UL></LI>
472    <LI><I>composite_calorimeter</I>
473       <UL>
474         <LI>Removed redefinition of streaming operator for
475             <TT>G4LorentzVector</TT> in <TT>CCalRotationMatrixFactory</TT>,
476             causing compilation problems on some compiler/system
477             configurations.</LI>
478       </UL></LI>
479    <LI><I>Rich</I>
480       <UL>
481         <LI>Fixed compilation errors and warnings for gcc-3.2.</LI>
482       </UL></LI>
483    </UL></LI>
484<LI><B>extended</B>
485    <UL>
486    <LI><I>biasing/B01</I>
487        <UL>
488        <LI>Open the geometry to cleanly clear biasing stores
489            at the end of the application.</LI>
490        </UL></LI>
491    <LI><I>electromagnetic/TestEm5</I>
492        <UL>
493        <LI>Modified histo 7: projected position at exit.</LI>
494        <LI>RunAction: removed UI commands for visualisation,
495            added a function <TT>ComputeMscHighland()</TT>.</LI>
496        </UL></LI>
497    <LI><I>field</I>
498        <UL>
499        <LI>Fixed methods that change the field to update the equation and
500            field-manager in field01 and field03.</LI>
501        </UL></LI>
502    <LI><I>medical/DICOM</I>
503        <UL>
504        <LI>Added History file, changed README.</LI>
505        </UL></LI>
506    </UL></LI>
507<LI><B>novice</B>
508    <UL>
509    <LI><I>N06</I>
510        <UL>
511        <LI>DetectorConstruction: changed surface model between
512            <TT>OpWaterSurface</TT> and <TT>OpAirSurface</TT>.</LI>
513        </UL></LI>
514    </UL></LI>
515</UL>
516
517<HR>
518
519</BODY>
520</HTML>
Note: See TracBrowser for help on using the repository browser.