Download the PHSD-PHQMD User Guide for a full overview of the PHSD and PHQMD modes, build and run instructions, initial conditions, dynamics and technical information.
User Guide
PHSD-PHQMD: Build and Run Notes
Build and run notes for PHSD-PHQMD, including setup, input flags, and output files.
Overview
The PHSD-PHQMD code is a unified framework for the microscopic description of heavy-ion (A+A), proton-induced reactions (p+A and p+p), as well as pion-induced reactions (pi+A, pi+N).
User Guide PDF
How to Run the PHSD-PHQMD Code
The code can be run in two modes: PHSD and PHQMD.
That is controlled by the flag IPHQMD set in the inputPHSD file:
IPHQMD = 0: HSD/PHSD dynamicsIPHQMD = 1: propagation with QMD dynamics
Compilation Requirements
PHSD requires a Fortran 90 compiler and can be built on Linux, Windows, or macOS (32- or 64-bit platforms). The recommended compilers are GFortran, Intel Fortran Compiler (ifort), and ifx.
On Linux, the recommended build system is cmake
(version >= 3.15).
After a successful build, the executable is generated as
phsd.exe.
For calculations at LHC energies, a dedicated build target can be used to
enable double precision (equivalent to the -r8 option).
How to Build
Linux
First extract the source package, then build the code in a separate directory:
unzip phsd_source.zip
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make
By default, gfortran is used. If supported, link-time optimization
is enabled automatically.
To compile with Intel Fortran (ifort):
cmake -DCMAKE_Fortran_COMPILER=ifort -DCMAKE_BUILD_TYPE=Release ..To compile with Intel LLVM Fortran (ifx):
cmake -DCMAKE_Fortran_COMPILER=ifx -DCMAKE_BUILD_TYPE=Release ..If supported by the compiler, interprocedural optimization is enabled automatically.
For LHC-energy runs with double precision, use the dedicated target:
make make_LHCInput File
Initial parameters are set in inputPHSD.
Special Attention
IBweight MC: method to simulate impact parameter distribution fromBmintoBmax.NUM: number of parallel events in each subsequent runISUBS.ISUBS: number of subsequent runs.iqmdeos: EoS for QMD optionIPHQMD=1(0: hard EOS without M.D.I;1: soft EoS;2: soft EoS with momentum dependence).
Output Files
The parameter for output level (how much information is written out) is
called ILOW. The default value is ILOW = 12, which provides
the basic outputs:
phsd.datfor all particles on an event-by-event basis using OSCAR format (forILOW = 10, 11, 12) in ASCII formatFinaloutROOT: similar output in ROOT formatfort.888for general output and parameter settingsfort.80for complementary information and errors (for control purposes only)
If ILOW < 12, for example 11, the ROOT output file is empty.
Note for ROOT output: In the makefile there is a check
for ROOT availability. Only in that case the ROOT output file
FinaloutROOT will be generated.
How to cite PHSD-PHQMD code
If you use the PHSD–PHQMD code in your scientific work, please cite it as “PHSD–PHQMD code v.X.X in PHSD (or PHQMD) mode” following the version numbering given on the PHSD–PHQMD web page:
https://phsd-phqmd.github.io/index.html
Please state explicitly which mode of the code has been used in your calculations and refer to the corresponding model name and citations already listed above:
- PHSD mode: the PHSD microscopic transport approach [1-3] (the first three PHSD references shown above).
- PHQMD mode: the PHQMD microscopic transport approach [4,5] (the two PHQMD references shown above).