Back to home page

EIC code displayed by LXR

 
 

    


Warning, /geant4/CHANGELOG/ReleaseNotes4.0.1.txt is written in an unsupported language. File is not indexed.

0001                  Geant4.0.1 Release Notes
0002                  ------------------------
0003 
0004                                                      14th July 1999
0005 
0006 This version of Geant4 is a "consolidation" of the first public
0007 release.  Its main characteristics are:
0008 
0009   o improved reliability and robustness.
0010   o the possibility of using granular (sub-category) libraries.  We
0011       recommend this mode of installation and use.
0012   o the possibility of using either the Standard Template Library
0013       (STL) or RogueWave tools.h++, selectable at installation and use
0014       time.
0015   o new low energy electromagnetic processes (first version).
0016   o extension of nuclear photon-evaporation to include the calculation
0017       of time to production for gammas.
0018   o improvements in design of the User Action classes - see below.
0019 
0020 Note that the next release, Geant4.1.0, will be offered only in the
0021 STL version.
0022 
0023 This code and some binary libraries are available through our "Source
0024 Code" Web page - see our Geant4 Home Page (http://cern.ch/geant4).
0025 
0026 Please refer to the Geant4 User Documentation
0027 (http://cern.ch/geant4/G4UsersDocuments/Overview/html)
0028 for further information about using Geant4.
0029 Updates to the documentation for Geant4.0.1 are still in preparation
0030 and are expected to be published within three weeks.
0031 
0032 
0033 Contents
0034 --------
0035 
0036   1. Supported and Tested Platforms
0037   2. CLHEP 1.4
0038   3. Using the Standard Template Library
0039   4. Compiler Specific Problems
0040   5. Known Run-Time Problems
0041   6. Compilation Warnings
0042   7. Known Run-Time Warnings
0043   8. Changes of the Signatures of Methods of the User Action Classes
0044 
0045 
0046 1. Supported and Tested Platforms
0047 ---------------------------------
0048 
0049   o SUN Solaris 5.6, C++ 4.2 patch 104631-04.
0050   o HP 10.20, aCC C++ B3910B A.01.18.
0051   o Linux 2.0.35, gcc C++ egcs-2.91.60.  There is a bug in an egcs
0052       include file which affects compilation with STL - see comments
0053       below.  This configuration was tested in the RedHat 5.1
0054       distribution, but versions of Geant4 have also been compiled
0055       successfully in Debian and Suse distributions.
0056 
0057 Platforms also tested but giving rise to some problems - see below:
0058 
0059   o AIX 4.3, xlC compiler.
0060   o DEC V4.0, cxx C++ V6.1-027.
0061   o NT 4.0 with Service Pack 4 and Cygnus Tools b20 with:
0062       Visual C++ 6.0 Service Pack 2 for either STL or RogueWave, or
0063       Visual C++ 5.0 Service Pack 3 for the RogueWave version only.
0064 
0065 
0066 2. CLHEP 1.4
0067 ------------
0068 
0069 Geant4.0.1 requires the installation of CLHEP 1.4
0070 (http://cern.ch/clhep/INSTALLATION/clhep.html).
0071 The following platform specific instructions apply:
0072 
0073   DEC: Do *not* use the compiler option "-std strict_ansi".
0074 
0075   NT: After configure, edit the file config/CLHEP-x86-cygnus-win32 and
0076         comment out "#define HEP-USE-STD 1".
0077 
0078 
0079 
0080 3. Using the Standard Template Library
0081 --------------------------------------
0082 
0083 The following versions of STL have been tested:
0084 
0085    ObjectSpace STL (http://www.objectspace.com) on: AIX,
0086           DEC, HP, NT and SUN.
0087 
0088    STLPORT STL (http://www.stlport.org) on: NT
0089 
0090    "Native" STL on: Linux.
0091 
0092 This is selected at installation/compile time by environment variables
0093 - see documentation.  Be aware that this is the first implementation
0094 of "The STL Interface" for which the emphasis has been on correct
0095 behaviour, not on performance.  Also, the size of libraries and
0096 executables is considerably larger.  These issues will be addressed in
0097 the next release.
0098 
0099 
0100 4. Compiler Specific Problems
0101 -----------------------------
0102 
0103   o Linux with egcs-1.1.1 and 1.1.2
0104 
0105       In order to compile with STL it is necessary to edit
0106       stl_hash_fun.h in /usr/include/g++/ or /usr/local/include/g++/.
0107       Lines 65-67 must be removed or commented out.  These are the
0108       lines in question:
0109 
0110         __STL_TEMPLATE_NULL struct hash<signed char> {
0111           size_t operator()(unsigned char x) const { return x; }
0112         };
0113 
0114   o AIX 4.3, xlC compiler.
0115 
0116       Geant4 does compile and link on AIX... eventually.  The compiler
0117       is very slow and the executables in debug mode are very large.
0118       On rsplus at CERN we had to revert to a version of the archiver
0119       corresponding to AIX 4.1 in order to have templates treated
0120       correctly.  This has limited our ability to test Geant4.
0121 
0122   o DEC V4.0, cxx C++ V6.1-027.
0123 
0124       We have found cases of mis-compilation of min and max templates
0125       on DEC.  We have traced those which cause serious malfunction
0126       but there is no guarantee that there are no other cases.
0127       Detailed inspection of assembler output suggests that this
0128       problem might not be confined to min and max.  This has been
0129       reported to DEC/Compaq.  We understand a new version 6.1A of the
0130       compiler is on its way.  However we cannot guarantee correct
0131       execution of Geant4 on DEC with the current version of the
0132       compiler.
0133 
0134   o NT
0135 
0136       - Note that the G4SYSTEM environment variable used for compiling
0137           Geant4 on NT has changed from WIN32-VC-NICE to WIN32-VC.
0138           Please check documentation on setting the environment.
0139       - Testing was done using the debuggable version only.
0140       - g3tog4 has not been ported to NT.
0141       - During the making of dependency files during compilation there
0142           are repeated warnings ("strstrea.h not found") - this is an
0143           artefact of using g++ for this purpose.
0144       - Ignore linker warnings: "conflicts with use of other libs".
0145       - Ignore linker errors: "unresolved external symbol
0146           __imp__MessageBoxA@16".
0147       - There is a known problem reading the data files for neutron
0148           scattering processes.  A patch resolving this problem will
0149           be issued soon.
0150  
0151 
0152 
0153 5. Known Run-Time Problems
0154 --------------------------
0155 
0156   o Reading STEP files on DEC with optimised libraries causes a Memory
0157       fault - but see notes on DEC above.
0158   o exampleN04 loops on DEC with optimised libraries - but see notes
0159       on DEC above.
0160   o On HP, an executable which uses "integral approach"
0161       electromagnetic processes - G4IMultipleScattering,
0162       G4IeIonisation, G4IeBremsstrahlung, G4IeplusAnnihilation,
0163       G4IhIonisation - has intermittently given Bus error(coredump).
0164 
0165 
0166 6. Compilation Warnings
0167 -----------------------
0168 
0169 There are compilation warnings om some platforms.  We do not believe
0170 that any will lead to incorrect run-time behaviour, but we are working
0171 on reducing them.
0172 
0173 
0174 7. Known Run-Time Warnings
0175 --------------------------
0176 
0177 The following messages are written to error output while tracking.  We
0178 believe none give rise to incorrect behaviour.
0179 
0180   o G4PropagatorInField::LocateIntersectionPoint: Warning: Integration
0181       inaccuracy requires an adjustment in the step's endpoint Two
0182       mid-points are further apart than their curve length difference:
0183       Dist = xxx curve length = yyy
0184   o Stepsize underflow in Stepper.
0185   o Warning G4Navigator::ComputeStep found slightly inaccurate
0186       position...
0187   o Warning in G4Navigator::ComputeStep: The Step's starting point has
0188       moved...
0189 
0190 
0191 8. Changes of the Signatures of Methods of the User Action Classes
0192 ------------------------------------------------------------------
0193 
0194 The signatures of all methods of all of the optional user action
0195 classes have been changed.  Now every method takes a constant pointer
0196 to an appropriate G4 object.  To cope with this change the user code
0197 must be modified.  The examples and documents are updated and the user
0198 is requested to consult to them.  We are sorry for this inconvenience
0199 but we concluded that this change will provide the user with a better
0200 and more robust code.