Building GUIs on Linux

If you wish to make changes to or recompile the Qt GUIs such as egs_gui, egs_view, egs_inprz or egs_configure, it will be necessary to install Qt developer tools. The following are instructions to compile dynamically linked EGSnrc Qt graphical user interfaces on linux.

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

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 to point to the location of the Qt4 development directory on your system. For example, on CentOS issue the command export QTDIR=/usr/lib64/qt4. On Ubuntu run 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 make clean; make command to build all of egs_gui, egs_inprz and egs_configure. If compilers have changed, first issue make realclean in each of the 3 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

Qt5 Instructions

In the current 2018 develop branch and future releases, the Qt GUIs are compatible with Qt5 (and Qt4).

1. Ensure you have installed and configured the EGSnrc develop branch.
2. Install the Qt5 development tools, e.g., qt5-default and qt5-qmake for Ubuntu or WSL.
3. Set the QTDIR environment variable to the path of the Qt5 directory, e.g., export QTDIR=/usr/lib/qt5 on Ubuntu. The qmake binary should be in $QTDIR/bin/ directory.
4. It may be necessary to define the QT_SELECT environment variable, e.g., 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 make clean; make command to build all of egs_gui, egs_inprz and egs_configure. If compilers have changed, first issue make realclean in each of the 3 subdirectories.

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