--------------------------------------------------------------
         Go4 Release Package v6.4.5 (build 60405)
                      June 2026
--------------------------------------------------------------
    The GSI Online Offline Object Oriented (Go4) Project
    Experiment Data Processing at EE department, GSI
--------------------------------------------------------------
Authors: Joern Adamczewski-Musch      (1999-)
         Mohammad Al-Turany           (2000-2004)
         Sven Augustin [Python]       (2015-)
         Denis Bertini                (2001-2004)
         Hans Georg Essel             (1999-2010)
         Marc Hemberger               (1999-2000)
         Sergey Linev                 (2002-)
---------------------------------------------------------------
Copyright (C) 2000- Gesellschaft f. Schwerionenforschung, GSI
                    Planckstr. 1, 64291 Darmstadt, Germany
Contact:            http://go4.gsi.de
---------------------------------------------------------------
This software can be used under the license agreements as stated
in Go4License.txt file which is part of the distribution.
---------------------------------------------------------------

GO4 PACKAGE

This package was tested on

• openSUSE Leap 42.2, openSUSE Tumblweed 20260430
• Debian 7.0, Debian 8.10 (32 bit and 64bit), Debian 9, Debian 11, Debian12, Debian 13
• macOS 10.14.6
• compilers: gcc 10.2, gcc 11.2, gcc 12.2, gcc 13.2, gcc 15.2

REQUIREMENTS

• ROOT 6.34 or higher (recommended 6.40)
• Qt6.8 or higher (recommended 6.10)

ROOT INSTALLATION

Install the ROOT framework Version >=6.28/00. See instruction how download and compile ROOT on http://root.cern Recommended way to build ROOT - compile it and use from compilation path:

 [shell] tar xzf root_v6.40.00.source.tar.gz
 [shell] mkdir build_640
 [shell] cd build_640
 [shell] cmake ../root_v6.40.00
 [shell] make -j
 [shell] source bin/thisroot.sh

To use web-based graphics (required for Mac) qt6web option should be enabled:

 shell> cmake ../root_v6.40.00 -Dwebgui=ON -Dqt6web=ON

Check after ROOT compilation that everything is fine by calling:

 shell> root-config --version

If actual version is printed, such ROOT installation can be used for go4. If command fails, one should configure environment call

 shell> source /path/to/root/bin/thisroot.sh

QT INSTALLATION

This Go4 distribution can be built with following Qt 6.4 and higher. Most modern Linux distributions provide Qt libraries, utilities and include files. Typically one should install qt6-gui-devel, qt6-webenginecore-devel and qt6-webenginewidgets-devel packages. Normally Go4 able to detect Qt installation and will compile correspondent version of Go4 GUI.

If there is no Qt installed on your system, or Go4 is not able to use it correctly, one should download it from https://www.qt.io/download anf follow instruction how it should be installed. After compilation set environment variables e.g.

shell> export QTDIR=$PWD
shell> export PATH=$PATH:$QTDIR/bin
shell> export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$QTDIR/lib

QT installation on Mac OS X

Go4 QtROOT GUI on Mac works only with web-based ROOT graphics. For that one requires latest qt6 with QWebEngine support. Most simple way is to use brew:

shell> brew install qt

Qt6 should be installed before ROOT and ROOT compilation should include -Dqt6web=ON flag.

GO4 COMPILATION WITH CMAKE

Create build directory and call

shell> cmake "path_to_source_dir"
shell> make -j

One also can specify several options for cmake:

-Dhdf5=ON - enable HDF5 support, requires installed HDF5 library
-DCMAKE_INSTALL_PREFIX=/home/user/custom/dir - configure custom directory for installation

RUNNING GO4 GUI

During compilation "go4login" script is generated, where all necessary environment variables for ROOT, Qt and Go4 are set. It can be copied in any suitable location (accessible via PATH variable) and called:

shell> source <build_path>/go4login

After that go4 gui and user analysis can be started from any directory.

shell> go4

Please read the Go4 Manual $GO4SYS/docs/Go4Introduction.pdf for further information on adopting your analysis and how to use the GUI.

Please read the ROOT Users guide (available at https://root.cern) for any questions concerning the ROOT system itself.

Please contact the Go4 developer team for any bug reports and wishes!

GO4 INSTALLATION AFTER CMAKE BUILD

If go4 build cmake, it can be used directly from build directory. If required, one can install it with the command:

shell> make install

It will copy files to configured installation path

GO4 ON WINDOWS

Install using binary distribution

To use ROOT6 and Go4 on Windows, it is necessary to install Microsoft Visual Studio. There is free "Community" version which can be found on https://visualstudio.microsoft.com/downloads/ website. During installation C++ components should be installed.

For the go4 there is windows installer file, which provides Go4 with correspondent ROOT and Qt6 libraries. It is recommended to install it in directory without spaces like "C:\Soft\go4". After installation Go4 icon created in the windows menu and on desktop - it runs go4 gui.

User analysis compilation

To compile any user analysis, start "x64 Native Tools Command Prompt VS 2022" and:

call C:\Soft\go4\go4login.bat
mkdir C:\Soft\analysis
cd C:\Soft\analysis
cmake c:\Soft\go4\examples\Go4ExampleSimple
cmake --build . --config Release -- /maxcpucount

To run it, one should specify directory "C:\Soft\analysis\Release" as analysis directory in "Launch Analysis" widget.

Go4 compilation from sources on Windows

First of all, install Qt6 with WebEngine support on Windows. Then start "x64 Native Tools Command Prompt VS 2022" and compile ROOT:

set PATH=%PATH%;C:\Qt\6.8.3\msvc2022_64\bin
mkdir C:\Soft\root
cd C:\Soft\root
cmake c:\git\root -Droot7=ON -DCMAKE_CXX_STANDARD=17 -Dwebgui=ON -Dqt6web=ON
cmake --build . --config Release -- /maxcpucount

Then compile Go4:

call C:\Soft\root\bin\thisroot.bat
mkdir C:\Soft\go4
cd C:\Soft\go4
cmake c:\git\go4
cmake --build . --config Release -- /maxcpucount