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).

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:

Compilation Requirements and Build

The minimum requirement to compile PHSD is a Fortran 90 compiler running under Linux, Windows, or macOS platforms (32 or 64 bit). The recommended compilers are GFortran and Intel Fortran Compiler.

On Linux, unzip the compressed source using unzip. Compilation is initiated by the make command (the makefile is already included in the package). After successful compilation, the executable file has the name phsd.exe.

The same makefile runs under Windows Fortran 90 compilers.

To run the code at LHC energies, use make_LHC, which compiles the code with double precision (with the -r8 option).

Input File

Initial parameters are set in inputPHSD. See explanations in the PHSD Manual and examples in the code.

Special Attention

  • IBweight MC: method to simulate impact parameter distribution from Bmin to Bmax.
  • NUM: number of parallel events in each subsequent run ISUBS.
  • ISUBS: number of subsequent runs.
  • iqmdeos: EoS for QMD option IPHQMD=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:

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

Parton transport and hadronization from the dynamical quasiparticle point of view

W. Cassing and E. L. Bratkovskaya - Phys. Rev. C 78 (2008) 034919


Parton-Hadron-String Dynamics: an off-shell transport approach for relativistic energies

W. Cassing and E. L. Bratkovskaya - Nucl. Phys. A 831 (2009) 215-242


Exploring the partonic phase at finite chemical potential within an extended off-shell transport approach

P. Moreau, O. Soloveva, L. Oliva, T. Song, W. Cassing, and E. Bratkovskaya - Phys. Rev. C 100 (2019) 014911

How to cite PHQMD

Parton-Hadron-Quantum-Molecular Dynamics (PHQMD) - A Novel Microscopic N-Body Transport Approach for Heavy-Ion Collisions, Dynamical Cluster Formation and Hypernuclei Production

J. Aichelin, E. Bratkovskaya, A. Le Fevre, V. Kireyeu, V. Kolesnikov, Y. Leifels, V. Voronyuk, G. Coci - Phys. Rev. C 101 (2020) 044905


Dynamical mechanisms for deuteron production at mid-rapidity in relativistic heavy-ion collisions from energies available at the GSI Schwerionensynchrotron to those at the BNL Relativistic Heavy Ion Collider

G. Coci, S. Gläßel, V. Kireyeu, J. Aichelin, C. Blume, E. Bratkovskaya, V. Kolesnikov, and V. Voronyuk. - Phys. Rev. C 108 (2023) 014902