Software/Geant4/Installation/Qt: Difference between revisions

From PBTWiki
Jump to navigation Jump to search
(Created page with "=== Qt4 === ; Website : http://qt-project.org ; Latest version : 4.8.6 (24 April 2014) ; Source tarball : <code>src/geant4-prerequisites/qt/qt-everywhere-opensource-src-4.8.6.ta...")
 
No edit summary
 
(5 intermediate revisions by one other user not shown)
Line 1: Line 1:
=== Qt4 ===
== Introduction ==
 
<code>Qt</code> [https://en.wikipedia.org/wiki/Qt_(software) "is a cross-platform application framework that is widely used for developing application software that can be run on various software and hardware platforms with little or no change in the underlying codebase, while still being a native application with the capabilities and speed thereof"].
 
For <code>Geant4</code>, the <code>Qt</code> headers and libraries are required in order to allow visualisation and interaction through the <code>Qt</code> user interface.
 
== Details ==


; Website : http://qt-project.org
; Website : http://qt-project.org
; Latest version : 4.8.6 (24 April 2014)
; Source URL : http://download.qt.io/official_releases/qt/5.6/5.6.0/submodules/
; Source tarball : <code>src/geant4-prerequisites/qt/qt-everywhere-opensource-src-4.8.6.tar.gz</code>
; Installed Production version : 5.6.0 (13 May 2016)
; Source code : <code>src/geant4-prerequisites/qt/qtbase-opensource-src-5.6.0.tar.gz</code>
; Installed Development version : 5.8.0 (20 October 2017)
; Central Repository : https://github.com/qt/qt5
 
== Installation Notes ==
 
<code>Geant4</code> supports <code>Qt 4.6</code> or higher (<code>Qt 4.8</code> or higher on Mac).
 
<code>Qt</code> is available in a number of different versions and with a vast array of submodules.  Only the "qtbase" submodule is required to compile all the elements required for <code>Geant4</code>.  The various different installer and source code options can be found at: http://www.qt.io/download-open-source/
 
For installation, <code>Qt</code> does not support installation into a sandbox directory (i.e. there are no options <code>prefix</code> or <code>DESTDIR</code> defined for command <code>make install</code>) and must be given the installation directory with the <code>-prefix</code> option.  As such, to recompile <code>Qt</code> for different target directories, the <code>configure</code> script must be rerun with a modified <code>-prefix /path/to/dest</code> option.  This has to be managed manually as can be seen in the installation commands below.
 
The tarball extracts to a rather long folder name. To follow the installation commands below, rename this to <code>src/qt-5.6.0</code>.
 
Some instructions on the correct package to download and the various compilation flags were provided by Ben Morgan at Warwick, along with this configuration script:
 
https://github.com/SuperNEMO-DBD/homebrew-cadfael/blob/master/Formula/qt5-base.rb
 
== Installation ==
 
When downloading software, the downloaded tarball (or other <code>Zip</code> archive) should be placed in an appropriately named directory in <code>/unix/pbt/software/src</code>: the instructions below assume that the directory is <code>/unix/pbt/software/src/qt</code>.
 
The source code should then be extracted into a suitable subdirectory in <code>/unix/pbt/software/build</code>.  The extracted source code directory can only be deleted once the software has been built and installed.
 
=== Installation from Central Repository ===
 
After the latest version has been pulled from its [https://github.com/qt/qt5 central repository] and placed within <code>/unix/pbt/software/src/qt</code>, create a build directory within the PBT software directory from which you can compile the code:
 
<pre>
cd /unix/pbt/software/build/
mkdir qt-5.8.0
cd qt-5.8.0
</pre>
 
<code>Qt</code> is then compiled using its <code>/configure</code> script with the following options. '''Note:''' Here, the software is to be installed into the development software directory using the command <code>-prefix /unix/pbt/software/dev/qt-5.8.0</code>. Define this as appropriate for your system.
 
<pre>
../../src/qt/configure -prefix /unix/pbt/software/dev/qt-5.8.0 -verbose -release -opensource -confirm-license -system-zlib -qt-libpng -qt-libjpeg -qt-freetype -qt-pcre -nomake tests -nomake examples -pkg-config -c++std c++14 -qt-xcb -fontconfig -system-freetype
</pre>
 
'''Note:''' the installation options used here are specific to <code>Qt v5.8.0</code> and are taken from Ben Morgan's [https://github.com/SuperNEMO-DBD/homebrew-cadfael/blob/master/Formula/qt5-base.rb script]. If installing a different version of <code>Qt</code>, it is likely that the configuration options may need to be different for your system.
 
<code>Qt</code> can then be compiled and installed using the usual commands:


Notes:
<pre>
* <code>Qt5</code> version 5.3.1 is available but not officially supported by <code>Geant4</code>.
make
* For installation, <code>Qt4</code> does not support installation into a sandbox directory (i.e. there are no options <code>prefix</code> or <code>DESTDIR</code> defined for command <code>make install</code>). This has to be managed manually as can be seen in the installation and stow commands.
make install
* The tarball extracts to a rather long folder name. To follow the installation commands below, rename this to <code>src/qt-4.8.6</code>.
</pre>


Installation commands:
=== Installation from source code ===
 
==== Source Code Extraction ====
 
<pre>
cd /unix/pbt/software/src/geant4-prerequisites/qt
tar -xvz -f qtbase-opensource-src-5.6.0.tar.gz
mv qtbase-opensource-src-5.6.0 qt-5.6.0
</pre>
 
==== Build And Install ====
 
It is possible to build for the '''Production''' environment without deleting the <code>Qt build</code> directory created for the '''Development''' installation, meaning that significant time is saved when running <code>make</code>. 
However, it isn't recommended to do so as the '''Production''' installation ends up referencing components within <code>/unix/pbt/software/dev</code> which is not desirable as the two environments are no longer independent. 
As such, these instructions assume one is building from scratch for each environment: to do so, make sure that the <code>build/qt</code> directory is deleted before recreating it for the subsequent build and install.
 
Also, although it is possible to install straight to the '''Production''' environment, it is highly discouraged to do so without first compiling a '''Development''' version.
 
===== Development Environment =====


<pre>
<pre>
cd /unix/pbt/software/build
cd /unix/pbt/software/build
../src/qt-4.8.6/configure -prefix /unix/pbt/software/dev -prefix-install -docdir /unix/pbt/software/dev/share/doc/qt4 -plugindir /unix/pbt/software/dev/share/qt-4.8.6/plugins -importdir /unix/pbt/software/dev/share/qt-4.8.6/imports -datadir /unix/pbt/software/dev/share/qt-4.8.6/data -translationdir /unix/pbt/software/dev/share/qt-4.8.6/translations -examplesdir /unix/pbt/software/dev/share/qt-4.8.6/examples -demosdir /unix/pbt/software/dev/share/qt-4.8.6/demos -release -opensource -optimized-qmake -opengl
mkdir -pv qt/qt-5.6.0
cd qt/qt-5.6.0
../../../src/geant4-prerequisites/qt/qt-5.6.0/configure -prefix /unix/pbt/software/dev/qt-5.6.0 -release -opensource -confirm-licence -nomake tests -nomake examples -optimized-qmake -opengl -qt-xcb
make
make
make install
make install
</pre>
</pre>


Stow commands:
===== Production Environment =====


<pre>
<pre>
cd /unix/pbt/software/dev
cd /unix/pbt/software/build
mkdir -p stow/qt-4.8.6/bin
mkdir -pv qt/qt-5.6.0
mv bin/assistant bin/designer bin/lconvert bin/linguist bin/lrelease bin/lupdate bin/moc bin/pixeltool bin/q* bin/rcc bin/uic* bin/xml* stow/qt-4.8.6/bin/
cd qt/qt-5.6.0
mv include stow/qt-4.8.6/
../../../src/geant4-prerequisites/qt/qt-5.6.0/configure -prefix /unix/pbt/software/prod-sl6 -release -opensource -confirm-licence -nomake tests -nomake examples -optimized-qmake -opengl -qt-xcb
mkdir -p stow/qt-4.8.6/lib
make
mv lib/libQt* lib/pkgconfig stow/qt-4.8.6/lib/
make install
mkdir -p stow/qt-4.8.6/share/doc
mv share/doc/qt4 stow/qt-4.8.6/share/doc/
mv share/qt-4.8.6 stow/qt-4.8.6/share/
mv tests stow/qt-4.8.6/share/
cd /unix/pbt/software/dev/stow
stow qt-4.8.6
</pre>
</pre>

Latest revision as of 10:11, 20 October 2017

Introduction

Qt "is a cross-platform application framework that is widely used for developing application software that can be run on various software and hardware platforms with little or no change in the underlying codebase, while still being a native application with the capabilities and speed thereof".

For Geant4, the Qt headers and libraries are required in order to allow visualisation and interaction through the Qt user interface.

Details

Website
http://qt-project.org
Source URL
http://download.qt.io/official_releases/qt/5.6/5.6.0/submodules/
Installed Production version
5.6.0 (13 May 2016)
Source code
src/geant4-prerequisites/qt/qtbase-opensource-src-5.6.0.tar.gz
Installed Development version
5.8.0 (20 October 2017)
Central Repository
https://github.com/qt/qt5

Installation Notes

Geant4 supports Qt 4.6 or higher (Qt 4.8 or higher on Mac).

Qt is available in a number of different versions and with a vast array of submodules. Only the "qtbase" submodule is required to compile all the elements required for Geant4. The various different installer and source code options can be found at: http://www.qt.io/download-open-source/

For installation, Qt does not support installation into a sandbox directory (i.e. there are no options prefix or DESTDIR defined for command make install) and must be given the installation directory with the -prefix option. As such, to recompile Qt for different target directories, the configure script must be rerun with a modified -prefix /path/to/dest option. This has to be managed manually as can be seen in the installation commands below.

The tarball extracts to a rather long folder name. To follow the installation commands below, rename this to src/qt-5.6.0.

Some instructions on the correct package to download and the various compilation flags were provided by Ben Morgan at Warwick, along with this configuration script:

https://github.com/SuperNEMO-DBD/homebrew-cadfael/blob/master/Formula/qt5-base.rb

Installation

When downloading software, the downloaded tarball (or other Zip archive) should be placed in an appropriately named directory in /unix/pbt/software/src: the instructions below assume that the directory is /unix/pbt/software/src/qt.

The source code should then be extracted into a suitable subdirectory in /unix/pbt/software/build. The extracted source code directory can only be deleted once the software has been built and installed.

Installation from Central Repository

After the latest version has been pulled from its central repository and placed within /unix/pbt/software/src/qt, create a build directory within the PBT software directory from which you can compile the code: 

cd /unix/pbt/software/build/
mkdir qt-5.8.0
cd qt-5.8.0

Qt is then compiled using its /configure script with the following options. Note: Here, the software is to be installed into the development software directory using the command -prefix /unix/pbt/software/dev/qt-5.8.0. Define this as appropriate for your system. 

../../src/qt/configure -prefix /unix/pbt/software/dev/qt-5.8.0 -verbose -release -opensource -confirm-license -system-zlib -qt-libpng -qt-libjpeg -qt-freetype -qt-pcre -nomake tests -nomake examples -pkg-config -c++std c++14 -qt-xcb -fontconfig -system-freetype

Note: the installation options used here are specific to Qt v5.8.0 and are taken from Ben Morgan's script. If installing a different version of Qt, it is likely that the configuration options may need to be different for your system.

Qt can then be compiled and installed using the usual commands: 

make 
make install

Installation from source code

Source Code Extraction

cd /unix/pbt/software/src/geant4-prerequisites/qt
tar -xvz -f qtbase-opensource-src-5.6.0.tar.gz
mv qtbase-opensource-src-5.6.0 qt-5.6.0

Build And Install

It is possible to build for the Production environment without deleting the Qt build directory created for the Development installation, meaning that significant time is saved when running make. However, it isn't recommended to do so as the Production installation ends up referencing components within /unix/pbt/software/dev which is not desirable as the two environments are no longer independent. As such, these instructions assume one is building from scratch for each environment: to do so, make sure that the build/qt directory is deleted before recreating it for the subsequent build and install.

Also, although it is possible to install straight to the Production environment, it is highly discouraged to do so without first compiling a Development version.

Development Environment
cd /unix/pbt/software/build
mkdir -pv qt/qt-5.6.0
cd qt/qt-5.6.0
../../../src/geant4-prerequisites/qt/qt-5.6.0/configure -prefix /unix/pbt/software/dev/qt-5.6.0 -release -opensource -confirm-licence -nomake tests -nomake examples -optimized-qmake -opengl -qt-xcb
make
make install
Production Environment
cd /unix/pbt/software/build
mkdir -pv qt/qt-5.6.0
cd qt/qt-5.6.0
../../../src/geant4-prerequisites/qt/qt-5.6.0/configure -prefix /unix/pbt/software/prod-sl6 -release -opensource -confirm-licence -nomake tests -nomake examples -optimized-qmake -opengl -qt-xcb
make
make install
Retrieved from "https://www.hep.ucl.ac.uk/pbt/pbtWiki/index.php?title=Software/Geant4/Installation/Qt&oldid=1166"