Building GUIs on Linux

If you wish to compile the Qt GUIs yourself, for example to make changes to egs_gui, egs_view, egs_inprz or egs_configure, it is necessary to install the Qt developer tools. The following are instructions to compile dynamically linked EGSnrc Qt graphical user interfaces on Linux. These instructions are meant for users that are well-acquainted with Linux terminal command and environment variables, and who can install software on their computer (otherwise, please seek support from your system administrator).

Note that qmake uses its own compiler configuration, in $QTDIR/mkspecs

Qt5 Instructions

1. Ensure you have installed and configured the EGSnrc on your system.
2. Install the Qt5 development tools, e.g., qt5-default and qt5-qmake for Ubuntu or WSL.
3. Define the QTDIR environment variable as the path of the Qt5 directory, e.g., export QTDIR=/usr/lib/qt5 on Ubuntu (check that the qmake binary is indeed in the $QTDIR/bin/ directory).
4. Define the QT_SELECT environment variable to select Qt5 compilation: export QT_SELECT=qt5.
5. Go to $HEN_HOUSE/egs++/view and issue the make clean; make command. If compilers have changed, first issue make realclean.

To build all GUIs

6. Go to $HEN_HOUSE/gui and issue the command make clean; make to build all of egs_gui, egs_inprz and egs_configure. If compilers have changed, first issue make realclean in each of the three subdirectories.
7. If the compiler complains it cannot find the zlib.h file, install the package that provides this basic header. On Ubuntu, for example, issue the following command in a terminal: sudo apt-get install zlib1g-dev.

To build individual GUIs

6. Go to $HEN_HOUSE/gui/egs_gui and issue the make realclean; make command.
7. Go to $HEN_HOUSE/gui/egs_inprz and issue the make realclean; make command.
8. Go to $HEN_HOUSE/gui/egs_configure and issue the make realclean; make command.
9. If the compiler complains it cannot find the zlib.h file, install the package that provides this basic header. On Ubuntu, for example, issue the following command in a terminal: sudo apt-get install zlib1g-dev.

Qt4 Instructions

In the 2018 release of the master branch, the GUIs are compatible with Qt4.

1. Install the Qt4 development tools (libqt4-dev or libqt4-devel package in many distributions).
2. Define the QTDIR environment variable as the path to the Qt4 development directory on your system. For example, on CentOS issue the command export QTDIR=/usr/lib64/qt4. On Ubuntu issue export QTDIR=/usr/share/qt4.
3. Go to $HEN_HOUSE/egs++/view and issue the make clean; make command. If compilers have changed, first issue make realclean.

To build all GUIs

4. Go to $HEN_HOUSE/gui and issue the command make clean; make to build all of egs_gui, egs_inprz and egs_configure. If compilers have changed, first issue make realclean in each of the three subdirectories.

To build individual GUIs

4. Go to $HEN_HOUSE/gui/egs_gui and issue the make realclean; make command.
5. Go to $HEN_HOUSE/gui/egs_inprz and issue the make realclean; make command.
6. Go to $HEN_HOUSE/gui/egs_configure and issue the make realclean; make command.