Release notes for FLUKA packages. -------------------------------------------------------- UPDATED===24.03.2009.14.30.18 TITLE===FLUKA files short doc TYPE===subpage --------------------------------------------------------

Release notes for Fluka2008.3b (patch version of Fluka2008.3)

As it is obvious from the name, the major revision number of this release is 2008, the minor revision number is 3, and the patch level "b". With this patch release all FLUKA versions older or equal to 2008.3 are obsoleted and they shall no longer be used according to the conditions spelled out in the FLUKA license.

This release contains a few small fixes and a significant functionality improvement with respect to Fluka2008.3.7 (the latest respin of Fluka2008.3). Most of them are likely to be irrelevant for the majority of the users, however it is safer and recommended to immediately move to Fluka2008.3b. The move should be painless since there is no change in the physics, apart the new functionality which is described below (and which is not activated by default).

New functionality:

How to activate: in order to activate the new fully detailed Compton scattering treatment an EMFRAY card with WHAT(1)=4, (Rayleigh activated as well) or WHAT(1)=6 (no Rayleigh) must be issued. Don't forget that EMFRAY works on a region-by-region basis. For all problems where accuracy in the physics treatment of sub-MeV photons is paramount, this option should always be activated everywhere, for example by issuing:

EMFRAY 4.0 1.0 @LASTREG

Please note that the impact on CPU of the new feature is minimal in almost all situations, therefore when in doubt activate it.

Extract from the release notes of Fluka2008.3 and other previous versions are reported below.

Release notes for Fluka2008.3

This release is a major step in the FLUKA development cycle with respect to Fluka2006.3(b): it adds a few new features and there are a few major physics improvements.

The users should keep in mind that given the extent of the new additions some problems could occur. The development team has spent a significant amount of time debugging the new features, however we would be surprised if no issue will show up.

As it is obvious from the name, the major revision number of this release is 2008 and the minor revision number is 3. With this release all FLUKA version older or equal to 2006.3 are obsoleted and they shall no longer be used according to the conditions spelled out in the FLUKA license.

Starting from this release, the code will be distributed in parallel to the FLUKA web site by the Nuclear Energy Agency (NEA-OECD) Data Bank. The NEA-OECD distribution (source included) will operate under the same license and conditions, and following the procedures specific of NEA-OECD.

A completely revised version of the FLUKA web site will be available starting September 26th. Users already registered should be flawlessly migrated to the new system. Please, let us know through the fluka-discuss list whichever problem you may meet.

NEW PHYSICS AND TECHNICAL FEATURES

Among the new features of this release (with respect to Fluka2006.3b):

Already starting from Fluka2006.3, a new high energy event generator has been developed, based on the sophisticated nuclear physics of PEANUT coupled with the proved FLUKA Dual Parton Model description for hadron-hadron collisions and a brand new Glauber cascade treatment. This model will eventually substitute as default the old one (PEANUT is already the default below 5 GeV). It is not yet the default, mostly because it requires a bit more testing and cleaning up some FLUKA inconsistencies related to quasi-elastic treatment. All thin target benchmarks of the code by the development team are now run with the new model, the development of the old one being frozen. The PHYSICS cards allows to switch on the new model (with some caveats about the quasielastic issue) ie with:

PHYSICS 1000. 1000. 1000. 1000. 1000. 1000. PEATHRES

Please give particular attention to the PHYSICS card recommendations (see below). For all other features, please refers to the Fluka2006.3(b) release note snippets reported at the end of these release notes.

IMPORTANT WARNINGS FOR THE USERS

NEW FEATURES NOT YET INCLUDED

The following features are currently under active development. Some of them are ready but were not included for lack of time, others are ready and possibly already presented or going to be presented to conferences, but not yet tested enough for a general user version, others are in various stages of completeness. The Authors warn that every result obtained out of the production version of the code which could be heavily dependent on any of these features will not be representative of the actual performances of FLUKA and therefore shall not be published.

List of the features under active development but not yet included in the production version of FLUKA:

PLATFORMS UNDER WHICH FLUKA SHALL BE RUN

This version of the code should be run on the platforms for which it has been released, that is Linux x86 under g77 (which runs on both 32 and 64 bit machines), Mac OSX under g95, and Compaq TrueUnix. The code has been checked and validated for these platforms/compilers only for the time being. The availability of the source code shall not be exploited for tentative builds on other architectures or with different compilers/compiler options than the ones recommended by the development team. Our experience shows that for a code of the complexity of FLUKA the chances of hitting one or more compiler issues are very large. Therefore users shall not make use for every serious job, including whichever form of publication or presentation, of code versions built on platforms and/or with compiler options which have not been cleared as safe by the development team.

The development team is actively developing and testing FLUKA also on other platforms which will become available in the next future.

FLUKA MANAGEMENT AND LICENSING CONDITIONS

This is the third major release of FLUKA carried out under the INFN-CERN Collaboration Agreement for the Maintenance and Development of the FLUKA code.

The development and distribution of FLUKA is managed by two Committees, the former, the Fluka Coordination Committee (FCC), which is representing the Copyright Holders (INFN and CERN) and which is empowered for all major decisions, the latter, the Fluka Scientific Committee (FSC), which is in charge of the day-to-day development of the code and of the technical and scientific issues.

The present membership of the Fluka Coordination Committee and the Fluka Scientific Committee are the following:

FCC:

GiuseppeBattistoniINFN/MilanMail to (chairman)
MichaelDoserCERN/PH Mail to
RobertoLositoCERN/ABMail to
JohannesRanftSiegen Un.Mail to
Paola R.SalaINFN/MilanMail to

FSC:

GiuseppeBattistoniINFN/MilanMail to (chairman)
FedericoCarminatiCERN/PHMail to
FrancescoCeruttiCERN/ABMail to
AlbertoFassòSLACMail to
AlfredoFerrariCERN/ABMail to (coordinator)
MaurizioPelliccioniINFN/LNFMail to
LarryPinskyUn. of HoustonMail to
JohannesRanftSiegen Un.Mail to
StefanRoeslerCERN/RPMail to
Paola R.SalaINFN/MilanMail to
VasilisVlachoudisCERN/ABMail to

The cornerstones of the INFN-CERN Agreement are the following::

This release is as usual available in source form for CERN staff members and INFN researchers: the source is now also available for other scientific Institutions. A special download form is available on the Fluka web site for this purpose. The source release includes the Linux-x86 version only (which runs on x86_64 machines as well). The Fluka Coordination Committee, the Fluka Scientific Committee and the Authors kindly invite all users to refer to any of them for whichever question or doubt about the source release and its condition of use.

Code snippets setting an expiration day for this release version are present in a few routines: obviously the availability of the source code allows to change it, however users should be aware that under the licensing conditions this is not permitted. The code expiration date (around end of 2010 for this release) is there as a reminder to use up-to-date versions. In no way it is intended as a robust protection, the code distribution is done as always on a mutual trust basis.

The "FLUKA User Routines" mentioned at point 3) in the FLUKA User License are obviously those (and only those) contained in the directory usermvax, both in the source and binary versions of the code.

Copyright statements referring to one of more of the Authors (A.Fasso`, A.Ferrari, J.Ranft, P.R. Sala) contained in individual routines, must always be interpreted as:

Copyright INFN and CERN, Authors: ...

since the Authors have transferred their rights to INFN and CERN at the time of (and subject to) the enactement of the INFN-CERN agreement of 2003.

A proper re-elaboration of all those Copyright statements is going on.

MISCELLANEOUS

The source code for DPMJET and for the version of rQMD-2.4 used together with FLUKA is not yet available for this release. The development team is finalizing the proper distribution conditions for these codes, which will be possibly included in the next release. The binary libraries are anyway available as usual, hence we do not expect any serious inconvenience for users who need heavy ion capabilities

There are several routines in this release which are apparently useless and not required for a successful link of the code. Most of them are new developments which either are activated in the development version only for the time being, or are under test in isolation with suitable drivers which are not included in the released version. Please ignore them.

REFERENCES TO BE QUOTED

The use of the FLUKA code must be acknowledged explicitly by quoting at least the following set of references

- A. Ferrari, P.R. Sala, A. Fasso`, and J. Ranft,

"FLUKA: a multi-particle transport code",
CERN 2005-10 (2005), INFN/TC_05/11, SLAC-R-773

- G. Battistoni, S. Muraro, P.R. Sala, F. Cerutti, A. Ferrari, S. Roesler, A. Fasso`, J. Ranft,,

"The FLUKA code: Description and benchmarking",
Proceedings of the Hadronic Shower Simulation Workshop 2006,
Fermilab 6--8 September 2006, M. Albrow, R. Raja eds.,
AIP Conference Proceeding 896, 31-49, (2007)

Additional FLUKA references can be added, provided they are relevant for this FLUKA version.

If FLUKA is used together with rQMD-2.4, DPMJET-2.53, or DPMJET-3 the following references should be quoted:

rQMD-2.4:

- H. Sorge, H. Stoecker, and W. Greiner, Annals of Physics 192, 266 (1989)

DPMJET-2.53:

- J. Ranft. Physical Review D51, 64 (1995)

DPMJET-3:

- S.Roesler, R.Engel, J.Ranft: "The Monte Carlo Event Generator DPMJET-III"
in Proceedings of the Monte Carlo 2000 Conference, Lisbon, October 23-26
2000, A. Kling, F. Barao, M. Nakagawa, L. Tavora, P. Vaz eds.,
Springer-Verlag Berlin, 1033-1038 (2001).

UNSUPPORTED/OBSOLETE VERSIONS

All FLUKA versions older than Fluka2006.3b (Fluka2005.6 and Fluka2006.3 included), and starting since 1989, are declared obsolete and will no longer be supported. Therefore they shall no longer be used for any publication according to the FLUKA User License and associated Requests of the Authors.

The FLUKA development team

Part of the Release Notes for Fluka2006.3(b), reported here for convenience

This release contains several small fixes and a few functionality improvements with respect to Fluka2006.3. Most of them are likely to be irrelevant for the majority of the users, however it is safer and recommended to immediately move to Fluka2006.3b. The move should be painless since there is no change in the physics. Only be careful to recompile user routines since a couple of commons changed.

This release is a bug fixing release for Fluka2006.3. As such it doesn't count as a new release, and it doesn't obsolete Fluka2005.6, for the purpose of the provisions of the Fluka User license. Rather, it obsoletes Fluka2006.3 and hence all users of Fluka2006.3 are invited to move to this bug fixing release from now on, particularly for publications.

The most relevant bug fixes or functionality improvements are listed below:

Many other minor bug fixes have been implemented, but they should be completely transparent to end users

A few further news of relevance for Fluka users are reported below:

The FLUKA development team

The release notes for Fluka2006.3 and before are reported below. They still apply unless explicitly superseded above. We invite the users to give particular attention to the PEANUT extension described below.

Release notes for Fluka2006.3 (release version)

This release is an incremental step in the FLUKA development with respect to Fluka2005.6. It adds a few features and there are physics improvements in several areas. It represents a major milestone from the user interface point of view with the introduction of the "input by names".

The users should keep in mind that there are a significant number of new features in this release, and therefore some problems are expected. The development team has spent a significant amount of time debugging the new features, however we would be surprised if no issue will show up. Users are recommended to check the Fluka home page for possible advisories on patched versions.

As it is obvious from the name, the major revision number of this release is 2006 and the minor revision number is 3. With this release all FLUKA version older or equal to 2003.1b are obsoleted and they should no longer be used according to the conditions spelled out in the FLUKA license.

NEW PHYSICS AND TECHNICAL FEATURES

Among the new features of this release (with respect to Fluka2005.6):

OBSOLETE FEATURES

the COMMENT card is deprecated (ordinary comments starting with "*" are of course supported): it is still accepted but there is no guarantee it works properly

omissis