SMASH (Simulating Many Accelerated Strongly-interacting Hadrons) is a relativistic hadronic transport approach for the dynamical description of heavy-ion reactions. Please see Phys. Rev. C 94, 054905 (2016) for details and, if you are using SMASH, cite this reference together with the software DOI for the specific code version employed. A BibTeX entry for the software DOI is found on the respective Zenodo pages.
See CONTRIBUTING for development hints. A complete User Guide as well as a more detailed development documentation are available for the latest version of the code. For documentation of older versions, refer to links in the releases pages.
If Pythia is used, please cite the following references (both article and the codebase release you used):
- A comprehensive guide to the physics and usage of PYTHIA 8.3, C. Bierlich et al; SciPost Phys. Codebases 8 (2022), DOI:
10.21468/SciPostPhysCodeb.8, also available on arXiv; - SciPost Phys. Codebases 8-r8.3 (2022), DOI:
10.21468/SciPostPhysCodeb.8-r8.3.
Report issues on GitHub or contact us by ✉️ email.
In the following you can find a minimal quick start guide. Refer to the INSTALL file for more detailed information.
SMASH is known to compile and work on 64-bit little endian machines (most CPUs are such) with UNIX-like operating systems (e.g. GNU/Linux, MacOS) and one of the following compilers (which have the required C++17 features):
| Compiler | Required version |
|---|---|
| GCC | 8.0 or higher |
| Clang | 7.0 or higher |
| Apple clang | 11.0 or higher |
Any different operating system and/or compiler and/or endianness is not officially supported and SMASH will ask you to continue at your own risk before compilation.
SMASH requires the following tools and libraries:
| Software | Required version |
|---|---|
| CMake | 3.16 or higher |
| GNU Scientific Library (GSL) | 2.0 or higher |
| Eigen3 library | 3.0 or higher |
| Pythia | 8.310 |
Support for ROOT, HepMC3 and Rivet output is automatically enabled if a suitable version is found on the system:
| Software | Required version |
|---|---|
| ROOT | 5.34 or higher |
| HepMC3 | 3.2.3 or higher |
| Rivet | 3.1.4 or higher |
From within the SMASH repository, use the following commands to build the codebase in a separate directory:
mkdir build
cd build
cmake -DPythia_CONFIG_EXECUTABLE=/path/to/pythia8310/bin/pythia8-config ..
makePlease note that the make command builds everything (executables, tests and libraries) and might take a while.
You can use make smash if you are interest in the SMASH executable only or use make smash_shared to exclusively build the libraries (needed e.g. in another project using SMASH as library).
You can run SMASH with specific settings (e.g. at a given collision energy or impact parameter) by modifying the config.yaml file, for example with
vi config.yaml
./smashRefer to the section below for more information.
If you want to install SMASH system-wide (into /usr/local) use
make installcmake command.
We strongly advise you to further refer to the INSTALL file for more guidance, especially if you encounter any issues.
As an alternative to building or installing SMASH, a Docker image of the latest or recently tagged version can be pulled from the Github container registry. Get the newest version with
docker pull ghcr.io/smash-transport/smash:newestStart the container with
docker run -it ghcr.io/smash-transport/smash:newestA ready-to-use executable of SMASH is found in the smash_bin directory.
Run it as explained below.
If needed, SMASH can also be built inside the container as explained in the previous section (the SMASH source files and Pythia are also found in the /SMASH directory).
Two container versions of SMASH are offered:
- a small version (
ghcr.io/smash-transport/smash) with a minimal set of dependencies pre-installed and - a large version with all possible external dependencies, e.g. ROOT, HepMC and Rivet, already included (
ghcr.io/smash-transport/smash-max).
Note that running SMASH inside of a Docker container might negatively affect performance. More information about containers usage can be found here.
Our Docker images are prepared for the x86-64 CPU architecture.
To make them compatible with computers with ARM CPUs (like in the case of Apple M1 and M2 chips),
docker must be launched with the --platform=linux/amd64 option.
For example:
docker run --platform=linux/amd64 -it ghcr.io/smash-transport/smash:newestHowever, this is not always guaranteed to work and it might be necessary to build an image for the ARM architecture, as described here.
SMASH ships example configuration files for running in the collider, box, sphere, and list mode (Modus in the configuration jargon).
By default, i.e. by running ./smash, the simulation is set up from the collider configuration file, called config.yaml, and using the default particles and decay modes files (particles.txt and decaymodes.txt, respectively).
They are located in the repository input folder.
Additionally, example configuration files for the box, sphere and list modus can be found in the respective directories input/{box,sphere,list}. If needed, e.g. in the case of a box simulation, different default particles and decay modes files can be used. Examples for these are also provided in input/box.
Finally, for the list modus, an input list file to be read in is required and an example is provided as input/list/example_list0.
In general, to run SMASH with a non-default configuration file, use the -i command.
For example, for the sphere or list example file, from the build folder, use:
./smash -i ../input/sphere/config.yaml
./smash -i ../input/list/config.yamlFurthermore, if using non-default particles and decay modes files is necessary, these can be specified through the -p and -d options.
In the box and the dileptons example, always from the build folder, this means:
./smash -i ../input/box/config.yaml -p ../input/box/particles.txt -d ../input/box/decaymodes.txt
./smash -i ../input/dileptons/config.yaml -d ../input/dileptons/decaymodes.txtAll available command line options for SMASH can be viewed with
./smash -hTo run SMASH completely silently for production runs, we recommend to suppress the standard output via e.g.
./smash > /dev/nulland it might be useful to redirect warnings and error messages, that will still be displayed, to a file:
./smash > /dev/null 2> /path/to/error-and-warnings-fileSMASH is licensed under the terms of the GNU General Public License, Version 3 or above. The build scripts are licensed under terms of the BSD 3-clause license. For more information, see LICENSE.
SMASH source and documentation are provided to check and reproduce published results of the authors. Cooperation and joint projects with outside researchers are encouraged and comparison to results by experimental collaborations is supported. If you are interested in starting a project, please contact us to avoid interference with current thesis topics. If your project involves changes to the code, please refer to CONTRIBUTING for coding guidelines and helpful tools. SMASH can also be used as a 3rd party library, for examples see the examples folder in the repository.