online manual


This is the online version of the traditional ASCII FLUKA manual. You should take note of the material below since it covers the FLUKA license/disclaimer.

To proceede to the Table Of Contents just follow the link or click on the image above. If you downloaded FLUKA a current copy of the ASCII manual is provided with the package. Alternatively, it is available for download fluka2006manual.gz here (shift click?).

Work is in progress to provide a much more detailed document to describe the physics of FLUKA in addition. The document is prepared in PDF format and latest draft is available.


           *====================================================================*
           *                                                                    *
           *                                                                    *
           *                                                                    *
           *                                                                    *
           *   FFFFF  L      U   U  K   K   AAA       222    000   000   666    *
           *   F      L      U   U  K  K   A   A     2   2  0   0 0   0 6   6   *
           *   F      L      U   U  K K    A   A         2  0   0 0   0 6       *
           *   FFFF   L      U   U  KK     AAAAA ===    2   0   0 0   0 6666    *
           *   F      L      U   U  K K    A   A       2    0   0 0   0 6   6   *
           *   F      L      U   U  K  K   A   A      2     0   0 0   0 6   6   *
           *   F      LLLLL   UUU   K   K  A   A     22222   000   000   666    *
           *                                                                    *
           *                    http://www.fluka.org                            *
           *                                                                    *
           *         Copyright (c) 1989-2007 by INFN and CERN                   *
           *                                                                    *
           *         All rights reserved                                        *
           *         Main authors:  A.Fasso`, A.Ferrari, J.Ranft, P.R.Sala      *
           *         Contributing authors: G.Battistoni, F.Cerutti, A.Empl,     *
           *                               M.V.Garzelli, V.Patera, S.Roesler,   *
           *                               V.Vlachoudis                         *
           *                                                                    *
           *         2006 version of the FLUKA code by :                        *
           *                                                                    *
           *             Alberto Fasso` - SLAC                                  *
           *             fasso@slac.stanford.edu                                *
           *                                                                    *
           *             Alfredo Ferrari & Paola Sala - CERN/INFN Milan         *
           *             Alfredo.Ferrari@cern.ch, Paola.Sala@mi.infn.it         *
           *             Alfredo.Ferrari@mi.infn.it, Paola.Sala@cern.ch         *
           *                                                                    *
           *             Johannes Ranft - Siegen University                     *
           *             Johannes.Ranft@cern.ch                                 *
           *                                                                    *
           *====================================================================*
 



17 January 2008
Copyright © 1992-2008 by INFN, CERN, the authors


Present (active) authors:

Alberto Fassò
Stanford Linear Accelerator Center,
2575 Sand Hill Road,
Menlo Park, CA 94025, USA
Fasso@slac.stanford.edu

Alfredo Ferrari
CERN, 1211 Geneva 23, Switzerland
(presently on leave from Istituto Nazionale di Fisica Nucleare,
via Celoria 16, 20133 MILANO, Italy)
Alfredo.Ferrari@cern.ch

Johannes Ranft
Universitaet Gesamthochschule Siegen, Fachbereich Physik,
D-57068 Siegen, Germany
Johannes.Ranft@cern.ch

Paola Sala
Istituto Nazionale di Fisica Nucleare, via Celoria 16,
20133 MILANO, Italy (presently on leave at ETH, Zurich)
Paola.Sala@mi.infn.it


Other authors who contributed to previous FLUKA versions
(from FLUKA82 up to FLUKA92):

P. Aarnio Helsinki University of Technology, Dept. of Technical
Physics Otakaari 1, SF-02150 ESPOO, Finland
(up to FLUKA87)
J.-H. Möhring Leipzig University, Germany, Fachbereich Physik,
LEIPZIG, Germany
(up to FLUKA92)
G. R. Stevenson TIS/RP, CERN, CH-1211 GENEVE 23, Switzerland
(up to FLUKA90)
J. M. Zazula Institute of Nuclear Physics, CRACOW, Poland
(up to FLUKA90)


FLUKA User license,
as established by the FLUKA Coordination Committee


Copyright statement and license conditions
 Copyright Italian National Institute for Nuclear Physics
 (INFN) and European Organization for Nuclear Research (CERN)
 ("the FLUKA copyright holders"), 1989-2006.

 All rights not expressly granted under this license are
 reserved.

 This software results from work performed by Alberto Fasso`,
 Alfredo Ferrari, Johannes Ranft and Paola Sala.

 INFN and CERN are the exclusive source of distribution of
 the code, bug fixes and documentation of the FLUKA
 software. Each official version of FLUKA is identified by a
 numbering scheme specifying major and minor releases.

 The FLUKA Coordination Committee or its delegates are able
 to grant any of the permissions noted in this License
 Agreement as requiring a specific consent. Any such consent
 may only be granted in writing.

 Installation, use, reproduction, display of the FLUKA
 software ("FLUKA"), in source and binary forms, are
 permitted free of charge on a non-exclusive basis for
 internal scientific, non-commercial and non-weapon-related
 use by non-profit organizations only. Any exercise of these
 rights is subject to the following conditions:

 1 Insertion of the FLUKA code, in whole or in part, into
   other codes, or its translation into any other computer
   language are possible only after obtaining prior written
   permission. Modifications of the FLUKA code are permitted
   for use by the licensee only, unless authorized in
   written.

 2 FLUKA is non-transferable, non-sub-licensable and may not
   be distributed in any way, without express written
   consent, whether in original or modified form. Site-wise
   or collaboration-wise conditions can be agreed with the
   FLUKA Coordination Committee.

 3 Notwithstanding the above, the licensee may modify and
   sub-license FLUKA User Routines to third parties in so far
   as their purpose is limited to the adaptation of input and
   output interfaces of FLUKA and their modification does not
   circumvent, replace, add to or modify any of the functions
   of FLUKA, or extract specific isolated results from any of
   the individual internal physics models embedded within
   FLUKA.

 4 The licensee shall forthwith license all its modifications
   of FLUKA to the FLUKA copyright holders, at no cost and
   with no limitation of use. The licensee acknowledges that
   the FLUKA copyright holders may insert such modifications
   into future releases of FLUKA, subject to appropriate
   acknowledgment of the licensee's contribution.

 5 Any publication by the licensee with respect to FLUKA or
   results obtained from it shall explicitly acknowledge
   FLUKA by quoting its set of references and the FLUKA
   copyright holders. The licensee shall not without prior
   written permission publish documents or results based on a
   modified form of FLUKA, unless the modification
   exclusively concerns User Routines for the adaptation of
   its input and output interfaces which comply with the same
   restrictions, as defined in section 3) as those which
   apply to sub-licensing. Any publication of documents or
   results shall be based only on official FLUKA versions as
   obtained from the FLUKA website (http://www.fluka.org) or
   from any authorized mirror. Publication here implies any
   legal publication to any third party, whether verbal,
   electronic, visual, in writing or otherwise.

 6 The licensee shall ensure that the FLUKA references,
   copyright statement and license conditions are not altered
   or removed from FLUKA. Any integration of any portion of
   FLUKA, in modified or in unmodified form, into any other
   software package must preserve the internal copyright
   notices in those portions of FLUKA that have been
   employed, and must reproduce such notices within any
   additional global notices included along or embedded
   within the software into which FLUKA has been
   integrated. Any portion of FLUKA so integrated, whether
   modified or unmodified shall continue to be subject to
   these license conditions.

 7 Nothing in this license shall be construed as to grant any
   rights in any of the FLUKA versions since 1989. In
   addition, users are not permitted to circumvent any
   protection in prior distributions of FLUKA that provided
   for a preset expiration date of the code

 8 Versions or parts of the FLUKA source code, entrusted to
   individuals or groups prior to the enactment of the
   CERN-INFN Collaboration Agreement, which are listed in
   Chapter 5 of Annex 1 of the EP-AB-INFN Scientific
   Agreement (19-02-2003), together with the agreed
   conditions of use, are subject to this License Agreement
   in addition to any other restrictions on the scope of use
   that may have been part of the initial use grant.

 9 Commercial use of FLUKA, outside the scope of this
   license, must be negotiated with the copyright holders


10 DISCLAIMER

THIS SOFTWARE IS PROVIDED BY THE FLUKA COPYRIGHT HOLDERS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY, OF SATISFACTORY QUALITY, AND FITNESS FOR A PARTICULAR PURPOSE OR USE ARE DISCLAIMED. THE FLUKA COPYRIGHT HOLDERS AND THE AUTHORS MAKE NO REPRESENTATION THAT THE SOFTWARE AND MODIFICATIONS THEREOF, WILL NOT INFRINGE ANY PATENT, COPYRIGHT, TRADE SECRET OR OTHER PROPRIETARY RIGHT.


11 LIMITATION OF LIABILITY

THE FLUKA COPYRIGHT HOLDERS AND THE AUTHORS SHALL HAVE NO LIABILITY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, CONSEQUENTIAL, EXEMPLARY, OR PUNITIVE DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, LOSS OF USE, DATA OR PROFITS, OR BUSINESS INTERRUPTION, HOWEVER CAUSED AND ON ANY THEORY OF CONTRACT, WARRANTY, TORT (INCLUDING NEGLIGENCE), PRODUCT LIABILITY OR OTHERWISE, ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.


 REQUESTS MADE BY THE FLUKA AUTHORS TO ALL USERS

 All licensees are requested to report as soon as practical
 to the Authors any errors or bugs found in any portion of
 FLUKA and its accompanying documentation.

 All licensees are requested to forward copies of all
 comparisons that they may make between FLUKA results and
 data or other codes as soon as practical.  The Authors agree
 to keep any such communications confidential unless
 otherwise notified by the contributing user.

 The Authors reserve the right of publishing any benchmarking
 and/or comparisons of the distinct separate performance of
 the individual internal models that are embedded into FLUKA,
 whether the comparisons are with data or with other
 codes. The Authors would also like to convey a general
 willingness to conduct any such benchmarking efforts either
 upon request or in collaboration with interested parties. In
 case of doubt please contact the Authors.

 Users should exclusively download FLUKA from the official
 FLUKA website (http://www.fluka.org) or one of the
 authorized mirror sites.  Users are invited to regularly
 update their FLUKA version to profit for improvements and
 bug fixes.

 Users are invited to use reasonably updated versions of the
 code for publications. Publications of results based on
 those FLUKA versions that are declared unsupported and
 obsolete on the official FLUKA website shall be avoided.

 Users should address any request of consent to one member of
 the FLUKA Coordinating Committee, which at present is
 composed as follows:

 Giuseppe Battistoni    Giuseppe.Battistoni@mi.infn.it
 (chairman)
 John     Ferguson      John.Ferguson@cern.ch
 John     Harvey        John.Harvey@cern.ch
 Johannes Ranft         Johannes.Ranft@cern.ch
 Paola    Sala          Paola.Sala@mi.infn.it

In accordance with the User License, the use of the FLUKA code must be acknowledged explicitly by quoting the following set of references:

- A. Fasso`, A. Ferrari, J. Ranft, and P.R. Sala, "FLUKA: a multi-particle transport code", CERN-2005-10 (2005), INFN/TC_05/11, SLAC-R-773

- A. Fasso`, A. Ferrari, S. Roesler, P.R. Sala, G. Battistoni, F. Cerutti, E. Gadioli, M.V. Garzelli, F. Ballarini, A. Ottolenghi, A. Empl and J. Ranft, "The physics models of FLUKA: status and recent developments", Computing in High Energy and Nuclear Physics 2003 Conference (CHEP2003), La Jolla, CA, USA, March 24-28, 2003, (paper MOMT005), eConf C0303241 (2003), arXiv:hep-ph/0306267


Additional FLUKA references can be added, provided they are relevant for the FLUKA version under consideration

This set of refences is subject to change in time. New ones will be communicated, when necessary, in the Release Notes of new FLUKA versions.

For questions/clarifications/problems about the license or in general the use of FLUKA please contact the chairman of the joint INFN/CERN FLUKA Coordination Committee:

Prof. Giuseppe Battistoni
INFN - Via Celoria 16 I-20133 Milano (Italy)
Giuseppe.Battistoni@mi.infn.it

or one of the Authors.





FLUKA2006 MANUAL
IMPORTANT WARNING FOR THE USERS


This manual is a reference tool for preparing input for the FLUKA particle transport code. It is not complete and it is not guaranteed to be free from errors. It is continually evolving just as the code does. It should not be cited: the proper references to be cited in any recent work related to FLUKA are Fas01 and Fas01a, (see list of References in 24}). In using the code, the user agrees on the authorship and copyright and hence is bound to quote the above references.

Please note also that early versions of the FLUKA hadronic event generator as implemented in other codes (in particular GEANT) should be referenced as such (e.g. GEANT-FLUKA) and not as FLUKA. They have little in common with the present version and should be considered virtually obsolete. The proper reference to GEANT-FLUKA is Fas93a.

Some parts of the manual must be "enriched": output etc.; the part on auxiliary programs must be updated.

Please refer to fasso@slac.stanford.edu / Alfredo.Ferrari@cern.ch for any comment or criticism on this manual and/or the code.

Alberto Fassò, Alfredo Ferrari

top / back
sponsored by: INFN and CERN updated: