iEBE-MUSIC

This is a repository is an overarching numerical framework for event-by-event simulations of relativistic heavy-ion collisions.

If you have any questions, please email to the iEBE-MUSIC google groups, iebe-music@googlegroups.com

Setup & Ingradients:

All the code packages can be downloaded from online git repositories. Please use codes/get_code_packages.sh to download the code packages and codes/compile_code_packages.sh to compile all the packages before event-by-event simulations.

Initial conditions:

IPGlasma
3DMCGlauber: a 3D Monte-Carlo Glauber model for heavy-ion collisions

Pre-equilibrium evolution:

KoMPoST

Hydrodynamics:

MUSIC

Particlization & hadronic transport:

iSS + UrQMD

Usage:

type ./generate_jobs.py -h for help information

Parameters:

Users can pass model parameters through a python script parameters_dict_user.py. It contains multiple dictionaries, which are related to each code module inside the iEBE-MUSIC framework. This script will update the master parameters dictionaries in config/parameters_dict_master.py. One can read config/parameters_dict_master.py for all the available parameters options for each module. If a user want to modify any parameters, he can add it in the parameters_dict_user.py.

initial_dict

The initial_dict dictionary specify the type of the initial condition to use,

IPGlasma
3DMCGlauber

For the IPGlasma initial condition, the user needs to specify the HDF5 database filename.

For the 3DMCGlauber initial condition,

If database_name : "self", initial condition will be generated on the fly with the rest part of the simulations.
If database_name : database_file, the code package will use the pre-generated initial coniditions stored in the database (HDF5).

music_dict

The music_dict has all the parameters to run MUSIC for (3+1)D hydrodynamic simulations.

'Initial_profile': 9,  for IPGlasma initial condition
    - 9: IPGlasma (full Tmunu),
    - 91: e and u^\mu,
    - 92: e only,
    - 93: e, u^\mu, and pi^\munu
'Initial_profile': 13,  for 3D MCGlauber initial condition
    - 13: 3D MCGlauber initial condition with dynamical initialization,
    - 131: 3D MCGlauber initial condition with instantaneous initialization

Settings on NERSC:

The clusters on NERSC does not use utf-8 as default. To run the script properly, one needs to add the following commands in the ~/.bashrc.ext file,

export PYTHONIOENCODING=utf-8
export LC_CTYPE=en_US.UTF8

Docker Support

The iEBE-MUSIC has its official docker image on docker hub iebe-music.

Coding Style

We use YAPF to impose coding format for the python scripts. Before every commit, please use

yapf -i filename.py

to apply the uniformed format to the source code files

chunshen1987/iEBE-MUSIC