United Generators

Introduction

The United Generators project was launched by the Virtual Institute 146 VI-SIM in September 2005 following a proposal of Herbert Ströbele. The goal was to facilitate comparison between various models (see below) and/or various experiments (HADES, FOPI, CERES, NA49, CBM). The package at present allows to convert output of various event generators to a generic root format. Common analysis operations like boosting from CMS to LAB, adding two-particle correlations, decaying the particles, smearing of momenta or acceptance cuts etc. are implemented as tasks in the analysis chain and affect the content of an event but keep its structure unchanged. This means they can be applied any number of times and in any order. The events can be subsequently translated to the experimental data format of the individual experiments (beyond the scope of United Generators), or used as the input to the detector simulation, or a simple physics analysis can be done directly. The figure below depicts the data flow. The colored blobs are the ones for which the implementation already exists.  

The converters implemented so far are listed below. 

converter

author

date

urqmd2u

Dariusz Miskowiec

2006

venus2u

Dima Kresan

2006

hsd2u

Dima Kresan

2006

pluto2u

Romain Holzmann

2006

evtgenX2u

Dima Kresan

2006

ampt2u

James Hostetter

2008

hijing2u

James Hostetter

2010

therminator2u

Daniel Wielanek

2012

epos2u

Marek Szuba

2013

Download

To get the first feeling have a look at small samples of pp events converted to the United Generators format:
 


Download one of them, start root, and type e.g.

TFile::Open("ampt.root","read");
events->Draw("TMath::Hypot(fPx,fPy):fPz");
events->Draw("fParticles.fT:fParticles.fZ");
events->Draw("fParticles.fY:fParticles.fX","fParticles.fPx>0.5");

To use the full functionality of the UNIGEN classes, or to convert your event generator data to UNIGEN format, please download the complete package from GitHub

https://github.com/FairRootGroup/UniGen/archive/v2.3.tar.gz

To build the library please prepare the root environment by setting ROOTSYS and adding $ROOTSYS/bin to the PATH and $ROOTSYS/lib to LD_LIBRARY_PATH (or by calling your favorite rootlogin script). Prepare the unigen environment by sourcing config/unigenlogin. Then type make. See README for details

Implementation

The "converters" (urqmd2u, venus2u, hsd2u, etc.) are standalone programs which read output files of event generators and produce root files with events in the common root format. Each root file contains one URun object and one tree; the tree consists of UEvents; a UEvent contains UParticles. A UEvent represents a snapshot of an event. In most cases this is the freeze-out state. Sometimes one is interested in the temporal development of a collision; in this case several subsequent UEvents will represent snapshots taken at different times. These are called "event steps"; the members fNes and fStepNr of UEvent allow to recognize this case. 

Development

The internal stuff like minutes of the meetings is in this wiki page . From 2005 till mid 2010 the UNIGEN software was managed by Dima Kresan, then for 3 years by Marek Szuba. After a few maintenance-free years, as of the end of 2019, Dima Kresan is again in charge. This webpage is maintained by Dariusz Miskowiec.


Loading...