1. LICENCE AND COPYRIGHT ' The SPACS code is free software: you can redistribute it and/or modify ' it under the terms of the GNU General Public License as published by ' the Free Software Foundation, either version 3 of the License, or ' (at your option) any later version. ' ' This program is distributed in the hope that it will be useful, ' but WITHOUT ANY WARRANTY; without even the implied warranty of ' MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ' GNU General Public License for more details. ' ' You should have received a copy of the GNU General Public License ' along with this program. If not, see . ' Copyright 2016: ' Dr. Christelle Schmitt, ' GANIL, Boulevard Henri Becquerel, B.P. 5027 ' 14076 CAEN Cedex 5, France, ' Dr. Karl-Heinz Schmidt, ' Rheinstrasse 4, 64390 Erzhausen, Germany ' and ' Dr. Aleksandra Kelic-Heil, ' GSI, Planckstrasse 1, 64291 Darmstadt, Germany 2. NAME OF THE PROGRAM: SPACS 3. DESCRIPTION OF PROGRAM OR FUNCTION SPACS is a computer code for calculating residue cross sections from spallation reactions induced by protons or neutrons. The nuclide cross sections are calculated with a semi-empirical model. The model considers the initial stage of nucleon-nucleon collisions and the consecutive de-excitation process. Nuclear fission and multi-fragmentation are not taken into account. A wide range of system size and bombarding energy is supported, including proton- and neutron-induced spallation on light (around C) up to heavy (Pb, Bi) nuclei, over an energy range from around 50 A MeV to a few hundred A GeV. The restrictions in heavier systems are related to the fact that the code does not consider fission. Also, the lightest residues produced in spallation are underpredicted, because multifragmentation (that becomes important at center-of mass energies above several A GeV) is not considered, and the light particles produced by evaporation (especially isotopes of hydrogen and helium) are not included. Output is provided as tables in SATAN format as isotopic sequences, A and Z distributions. The A and the Z distribution are displayed for orientation. The output files can directly be read by the SATAN program package (see www.GSI.de/Charms). Because the format is plein ASCII, the structure can easily be understood and adapted to other purposes. The official SPACS websites are www.khs-erzhausen.de, www.GSI.de/Charms, and www.GANIL.fr. 4. METHOD OF SOLUTION The deterministic method is used. 5. TYPICAL RUNNING TIME A calculation of all residue cross sections is performed in less than one second. 6. RELATED AND AUXILIARY PROGRAMS The SPACS program is written in FreeBASIC (http://www.freebasic.net/). FeeBASIC produces compiled binary code using the C run-time library. Graphics output is based on the X11 library. The Windows version of SPACS runs also under WINE on LINUX. 7. REFERENCES [1] "SPACS: A semi-empirical parameterization for isotopic spallation cross sections" C. Schmitt, K.-H. Schmidt, A. Kelic-Heil Phys. Rev. C 90 (2014) 064605 [2] "Erratum" to ref. [1] in Phys. Rev. C 94 (2016) 039901 [3] "Complex nuclear-structure phenomena revealed from the nuclide production in fragmentation reactions" M. V. Ricciardi, A. V. Ignatyuk, A. Kelic, P. Napolitani, F. Rejmund, K.-H. Schmidt, O. Yordanov Nucl. Phys. A 733 (2004) 299 [4] "Even-odd effect in multifragmentation products: the footprints of evaporation" M. V. Ricciardi, K.-H. Schmidt, A. Kelic-Heil arXiv:1007.0386v1 [nucl-ex] (2010) A self-sufficient summary of the SPACS formalism, equations, and numerical values of the parameters can be found in the Appendix of [2]. 8. HARDWARE REQUIREMENTS SPACS can be compiled and installed under Windows [a] and Linux, using exactly the same sources files. Specific executables are provided for the two systems. SPACS was tested on Windows [a] and Linux. Memory < 10 MByte; Disc < 1 MByte. 9. PROGRAMMING LANGUAGE(S) USED Computer language on Linux: FreeBASIC; on Windows [a]: FreeBASIC 10. OPERATING SYSTEM UNDER WHICH PROGRAM IS EXECUTED a) Windows [a] XP or newer b) Any Linux distribution. Eventually, some additional packages need to be installed, e.g. X11 developer tools. 11. OTHER PROGRAMMING OR OPERATING INFORMATION OR RESTRICTIONS There are no further restrictions. 12. NAME AND ESTABLISHMENT OF AUTHORS Christelle Schmitt, GANIL, Boulevard Henri Becquerel, B.P. 5027 14076 CAEN Cedex 5, France, Karl-Heinz Schmidt, Rheinstrasse 4, 64390 Erzhausen, Germany, and Aleksandra Kelic-Heil, GSI, Planckstrasse 1, 64291 Darmstadt, Germany 13. MATERIAL AVAILABLE FreeBASIC [c] source files. Executables for Windows [a] and Linux. ReadMe file with technical instructions. 14. CATEGORIES Nuclear spallation Keywords: Spallation, semi-empirical model, deterministic method, even-odd effect. 15. PRACTICAL HINTS The output of the code is written in the "out" folder as ASCII tables. The subfolder "out" that is used by the code for output is created automatically, if it does not exist. SPACS does not overwrite or delete the output files. If the same system is calculated again, the new results are added to the existing file. Files in the folder "out" that are not needed any more should be deleted explicitely. Executables of the SPACS code for Windows[a] and Linux are available. They are easy to use: Just download the ZIP file, extract the files and run SPACS.exe (Windows [a]) or ./SPACS (Linux) in a command window on your computer! Note that several input data files (shell correction energies, particle separation energies, even-odd correction factors) are made available too in order to facilitate the implementation of the parameterization by the interested user (no need to compute these inputs him/her-self). On Windows [a]: --------------- The file SPACS.zip provides an executable of the SPACS code (SPACS.exe). If you want to apply any changes, use an IDE (e.g. FBIDE [b]) for editing any of the source files (*.bas). Compile the main routine SPACS.bas under FreeBASIC [c]. The other files are automatically included in the compilation process. (Compile by pressing the "compile" botton of FBIDE when SPACS.bas is open.) On Linux: --------- The file SPACS.zip provides an executable (SPACS) that runs directly in a terminal by entering "./SPACS". (Do not forget to set the file properties to "execute as a programm".) If you want to make any changes to SPACS, prepare an executable, using an IDE (e.g. GEANY [f]) with the FreeBASIC [c] compiler. SPACS.bas is the main routine. The other files are automatically included in the compilation process. Compile by pressing the "compile" botton of GEANY when SPACS.bas is open or by the command "fbc SPACS.bas". Remark: Installation of additional packages may be required. (See http://www.freebasic.net/ -> Documentation -> User Manual -> Using the FreeBASIC Compiler -> Installing FreeBASIC.) E.g. the graphics output requires the installation of the X11 library. If the graphics does not work, you may suppress it by commenting the line ( #Include "Plotting.bas" ) in SPACS.bas. The Windows version of SPACS may also be used under Wine [e] without any loss of performance. Required input of SPACS: Z and A of heavy reaction partner. Choice of proton or neutron as light reaction partner. Bombarding energy. Quantities available on output of SPACS: Isotopic cross sections (as a function of neutron number for all Z). Z distribution. A distribution. [a] Windows is either a registered trademark or a trademark of Microsoft Corporation in the United States and/or other countries. [b] FBIDE is available from http://fbide.freebasic.net/ with no cost. [c] FreeBASIC is available from http://www.freebasic.net/ with no cost. [e] Wine is a windows compatibility layer for Linux (http://www.winehq.org/). [f] Geany is available from http://www.geany.org/ with no cost. In case of technical problems, please contact schmidt-erzhausen at t-online.de .