FJFI heavy ion group

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
One has to start with the correct CBM-ROOT (up to date - 22.10.2022) this is just at a development stage, therefore not present in the official GitLab master branch!!

Recommended is to set up a new directory where you will download this version of CBM-ROOT (something like /u/USERNAME/fwall/) and there use the following command:
''git clone -b my_master https://git.cbm.gsi.de/l.chlad/cbmroot.git''

To install this version of CBM-ROOT copy the /u/lchlad/CBM/cbmroot/myInstal.sh into your /u/USERNAME/fwall/cbmroot/ directory, and modify there the path to install destination "CMAKE_INSTALL_PREFIX" so that it does not collide with your installation of official CBM-ROOT (e.g. add at the end "_fwall"). Then just execute the script
''bash myInstall.sh''
and hopefully, all goes well :) The compilation of code should go smooth, check what is the bug and if you don't know how to solve it, complain to me **l.chlad@gsi.de** . After the compilation the installation part is executed, sometimes it can happen that "for no good reason" it gets stuck (no new line for > 3 minutes). Try to kill it "Ctrl+Z" and execute the script again, usually, this helps to move on.

----

In "cbmroot.git" is reference also to cbmroot_geometry. This repository is also in development right now, and has not been merged into the official one. The link is in ''cbmroot/external/InstallGeometry.cmake'' (if you clone the "my_master" branch then it will point already to the correct repository -> nothing is needed). But one can also only work on the geometry itself, for that go to directory "/u/USERNAME/fwall/" and use the following command to clone the repository with some first version of FWALL:
''git clone -b lch_fwall https://git.cbm.gsi.de/l.chlad/cbmroot_geometry.git''

Structure of cbmroot_geometry:
  * definition of materials: ''media.geo''
  * directory with macros defining CBM setups for simulations: ''setup/'' (e.g. ''setup/setup_sis100_hadron_fwall.C'')
  * separate directories with geometry files (.geo.root or .geo.info) per each detector (e.g. ''fwall/'')
  * separate directories with macros creating these files: ''macro/DETECTOR/'' and within subdirectories ''fair/'' or ''mcbm/'' (e.g. ''macro/fwall/fair/create_fwallgeo_firstShot.C'')


How it works in 2 examples:
  - ''macro/fwall/fair/create_fwallgeo_testModules.C'' -> meant only for visual inspection of the definition of individual modules!! Each module size is defined with its dimensions plus the needed definition of dimensions for the channel for WLS fibre (curvature at corners, distance from the edge, width and depth). The macro reads the material properties from ''media.geo'' file and constructs geoVolumes for each size of the module, e.g. ''TGeoVolume* smallModule    = ConstructSmallModule( "smallModule",  smallCellSize,  wallThickness, &infoFile)''. Then these virtual volumes are placed into the mother volume with a specific module index (this is important as each volume has to have unique name!!) and the position of the centre, using: ''fwall->AddNode(smallModule, iModule, new TGeoTranslation(xCurrentModuleCentre,yCurrentModuleCentre,0))''. The modules are placed one next to each other. After that the constructed fwall is positioned into the cave: ''top->AddNode(fwall, 0, fwallTrans)''. The modules are built via common function ''ConstructGeneralModule(many parameters)'' in which the modules are constructed with basic geometrical volumes and transformations.
  - ''macro/fwall/fair/create_fwallgeo_firstShot.C'' -> the only difference is in the positioning of modules into ''TGeoVolume fwall''. Done in a way that there are 4 inner modules missing (beam) and then going outwards small modules in array 6x4, medium modules 3 in x direction and 2 in y, large modules 2 in both x and y directions. If one want to change the layout then change the variables: ''nSmallCells_X, nSmallCells_Y, nMediumCells_X, nMediumCells_Y, nLargeCells_X, nLargeCells_Y''. To change the dimensions of modules: ''wallThickness, small/medium/largeCellSize''.

----

Running simulation with a defined setup (consisting the FWALL)

If you have developed new FWALL geometry
  - within X2Go:
  - make sure you will have OpenGL library (''export LIBGL_ALWAYS_INDIRECT=1'')
  - load proper version of CBM-ROOT (''source /u/USERNAME/fwall/cbmroot/build_LINUXVERSION/consig.sh --prepend'')
  - go to the macro which will create the geometry and run the macro ('' root -l 'create_fwallgeo_firstShot.C("v22a")' '')
  - move created files into the intended directory (''mv fwall_v22a.* /u/USERNAME/fwall/cbmroot_geometry/fwall/'')
  - define new or modify CBM setup to include your new geometry (e.g. within ''setup/setup_sis100_hadron_fwall.C'' the correct tag must be specified ''TString fwallGeoTag     = "v22a"'')
  - these changes should be propagated into GitLab (git add, git commit, git push)
  - finally the ''/u/USERNAME/fwall/cbmroot/external/InstallGeometry.cmake'' must be updated to the proper commit hash with these changes
  - re-install the CBM-ROOT

Make use of the geometry within
  - logged-in to virgo-debian10.hpc.gsi.de
  - using the ''cbmroot/macro/run/run_tra_file.C'' with **setup_sis100_hadron_fwall** in the default parameter
  - execute either manually ''root -l -b -q run_tra_file.C'' or with sendJobArrayScript.sh as described in repository XXXX