Focus Documentation

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
1_0:install-source [2018/05/22 11:57]
rdrighetto [gfortran (incl. bindings)] 		1_0:install-source [2024/01/16 10:51] (current)
admin [Getting the source code]
Line 7: Line 7:
 Alternatively the GIT repository can also be cloned (For this, installation of ''git'' is required): Alternatively the GIT repository can also be cloned (For this, installation of ''git'' is required):
  
-''git clone https://github.com/C-CINA/focus.git''+''git clone https://github.com/LBEM-CH/focus.git''
  
  ===== Installing Dependencies =====  ===== Installing Dependencies =====
Line 23: Line 23:
 ==== gfortran (incl. bindings) ==== ==== gfortran (incl. bindings) ====
 Some programs of the kernel are written in fortran. Thus compiling Focus requires a fortran compiler. Note that we only support the GNU fortran compiler ''gfortran''. Dependent on your package source you might have to install some platform dependent binding libraries between fortran and c++. But on Fedora you have to install these additional packages: ''gcc-gfortran'' and ''libgfortran''. Some programs of the kernel are written in fortran. Thus compiling Focus requires a fortran compiler. Note that we only support the GNU fortran compiler ''gfortran''. Dependent on your package source you might have to install some platform dependent binding libraries between fortran and c++. But on Fedora you have to install these additional packages: ''gcc-gfortran'' and ''libgfortran''.
 +On OSX, you can install this via "brew install gcc".
  
 Please make sure to use gfortran **version 5.x** or later. Please make sure to use gfortran **version 5.x** or later.
 +
  
 ==== g++ (incl. bindings) ==== ==== g++ (incl. bindings) ====
Line 36: Line 38:
  
 Make sure that the gcc/g++ from the clang is not used to build otherwise it will fail.   Make sure that the gcc/g++ from the clang is not used to build otherwise it will fail.  
-On OSX, you might have to do "cd /usr/local/bin ; \ln -s g++-7 g++ ; \ln -s gcc-7 gcc" .+On OSX, you might have to do "cd /usr/local/bin ; \ln -s g++-9 g++ ; \ln -s gcc-9 gcc" .
 Or, depending on the g++ and gcc versions that you have installed, you might need to do "cd /usr/local/bin ; \ln -s g++-8 g++ ; \ln -s gcc-8 gcc". Or, depending on the g++ and gcc versions that you have installed, you might need to do "cd /usr/local/bin ; \ln -s g++-8 g++ ; \ln -s gcc-8 gcc".
 ==== libfftw3 ==== ==== libfftw3 ====
 Focus requires fftw version 3.0.0 or later. The package is called ''libfftw3-dev'' on Ubuntu, but on Fedora you have to install ''fftw-devel'' and ''fftw-libs''. You can install this famous library via the package manager or directly from http://www.fftw.org. In such a case use the following commands to compile FFTW: Focus requires fftw version 3.0.0 or later. The package is called ''libfftw3-dev'' on Ubuntu, but on Fedora you have to install ''fftw-devel'' and ''fftw-libs''. You can install this famous library via the package manager or directly from http://www.fftw.org. In such a case use the following commands to compile FFTW:
  
 +<nowiki>
 ./configure --enable-shared --enable-single --enable-threads --enable-sse --enable-sse2 --with-pic; ./configure --enable-shared --enable-single --enable-threads --enable-sse --enable-sse2 --with-pic;
 +</nowiki>
  
-# ( make sure those --enable are actually two minus ("-") characters ) +<nowiki>
 make; make;
 +</nowiki>
  
 +<nowiki>
 sudo make install; sudo make install;
 +</nowiki>
  
 +<nowiki>
 make clean; make clean;
 +</nowiki>
  
 +<nowiki>
 ./configure --enable-shared --enable-threads --enable-sse2 --with-pic; ./configure --enable-shared --enable-threads --enable-sse2 --with-pic;
 +</nowiki>
  
 +<nowiki>
 make; make;
 +</nowiki>
  
 +<nowiki>
 sudo make install sudo make install
 +</nowiki>
  
 ==== Qt5 ==== ==== Qt5 ====
 Compilations of Qt5 is included in all the package managers we listed above. Qt5 can also be downloaded and installed from: http://www.qt.io/download-open-source/ Compilations of Qt5 is included in all the package managers we listed above. Qt5 can also be downloaded and installed from: http://www.qt.io/download-open-source/
 +
 +You also need the "qtscript5-dev - Qt 5 script development files", which are not installed by default with Qt5. 
 +Installing the qtscript5-dev is also needed. 
 +
 +On Linux, the command 
 +
 +''sudo apt-get install qtscript5-dev
 +''
 +
 +solves that problem.
  
 Make sure that after the installation you add Qt5 bin directory to the environment variable $PATH, and that: Make sure that after the installation you add Qt5 bin directory to the environment variable $PATH, and that:
  
-''qmake -query''+''qmake -query 
 +''
  
 gives you correct path to installed Qt libraries. gives you correct path to installed Qt libraries.
Line 70: Line 95:
 **NOTE for Mac OSX Users:** Qt Version 5.9.4 worked fine, while Qt Version 5.10.1 caused the error: **NOTE for Mac OSX Users:** Qt Version 5.9.4 worked fine, while Qt Version 5.10.1 caused the error:
 "build/apps/src/data/moc_ParameterConfiguration.cpp:175:63: error: 'init_priority' attribute is not supported on this platform." "build/apps/src/data/moc_ParameterConfiguration.cpp:175:63: error: 'init_priority' attribute is not supported on this platform."
 +
 +
 ===== Compiling Focus ===== ===== Compiling Focus =====
 Once everything is set up, CMAKE will automatically find the required paths and compile. This all has been scripted and Focus can easily be compiled by running the ''build_all'' script, which take between Once everything is set up, CMAKE will automatically find the required paths and compile. This all has been scripted and Focus can easily be compiled by running the ''build_all'' script, which take between
Line 78: Line 105:
  
 Focus is compiled in two stages. First we check the presence of all required dependencies and in the second stage we compile the entire source tree. Focus is compiled in two stages. First we check the presence of all required dependencies and in the second stage we compile the entire source tree.
 +
 +Upon building, Focus creates a directory "build", in which the configuration and built files are placed.  If compilation fails due to missing or wrong dependencies, and you add those dependencies later, then don't forget to remove the "build" directory before trying to "./build_all" again. Otherwise, the old configuration files in the "build" directory will still be present and steer the compilation into the wrong direction.
  
 === See also: === === See also: ===
Line 83: Line 112:
  
 [[1_0:locating-installation|Default installation directories]] [[1_0:locating-installation|Default installation directories]]
-