/stable-kf5-qt5/education/labplot/INSTALL

0001 To compile LabPlot following packages are required:
0002         * CMake version 3.2.0 or higher
0003         * ECM (extra cmake modules)
0004         * KDE Frameworks 5.16.0 or higher (including the devel-package),
0005                 optional 5.28.0 or higher for syntax highlighting
0006         * Qt version 5.6 or higher (including the devel-package, libqt5-devel or similar)
0007         * GSL version 1.15 or higher (including the devel-package, gsl-devel or similar)
0008
0009 optional
0010         * LaTeX to enable LaTeX typesetting in LabPlot, requires also 'convert' from ImageMagick and 'dvips'.
0011                 * Required LaTeX packages: 'color', 'preview' and, in case xelatex or lualatex are used, 'xltxtra'.
0012                 * On Windows you need a LaTeX installation (like MiKTeX) and ghostscript for LaTeX support.
0013                 * On macOS you need a LaTeX installation (like MacTeX) and ImageMagick for LaTeX support.
0014         * FFTW version 3.3 or higher (including the devel-package, fftw3-devel or similar)
0015         * HDF5 version 1.8 or higher (including the devel-package, hdf5-devel or similar)
0016         * NetCDF version 3 or higher (including the devel-package, netcdf-devel or similar)
0017         * CFITSIO version 3 or higher to support FITS data format (including the devel-package, cfitsio-devel or similar)
0018         * libcerf version 1.0 or higher to support complex error and related functions (including the devel-package, libcerf-devel or similar)
0019         * Cantor version 19.12 or higher (including the devel package, cantor-devel or similar)
0020         * ZLIB and LZ4 to support ROOT (CERN) TH1 histograms (including the devel package, zlib-devel and liblz4-devel or similar)
0021         * ReadStat for importing serveral statistical data formats (will be build if not available)
0022         * Qt SerialPort to support serial port functionality
0023         * Qt MQTT module (https://github.com/qt/qtmqtt) to support reading and plotting of data from MQTT brokers
0024
0025
0026 ===============================================================================
0027 To build LabPlot execute
0028 # ./compile
0029
0030 Edit the compile script if you want to use options different from default ones.
0031 E.g. specify a custom installation path via
0032 -DCMAKE_INSTALL_PREFIX=/usr/local
0033
0034 or build a debug build via
0035 -DCMAKE_BUILD_TYPE=debug
0036
0037
0038 LabPlot's cmake configuration script searches for the optional packages and uses them if they are found.
0039 To compile LabPlot without optional dependencies even if they are present on the system, use the following parameters (default is "ON"):
0040 -DENABLE_FFTW=OFF
0041 -DENABLE_HDF5=OFF
0042 -DENABLE_NETCDF=OFF
0043 -DENABLE_FITS=OFF
0044 -DENABLE_LIBCERF=OFF
0045 -DENABLE_CANTOR=OFF
0046 -DENABLE_ROOT=OFF
0047 -DENABLE_READSTAT=OFF
0048 -DENABLE_MQTT=OFF
0049 -DENABLE_QTSERIALPORT=OFF
0050 -DENABLE_LIBORIGIN=OFF
0051
0052 Note, by switching off these libraries the feature set of LabPlot will be reduced.
0053
0054 To enable reproducable builds, use
0055 -DENABLE_REPRODUCIBLE=ON
0056
0057 ================================================================================
0058 To run the tests execute
0059
0060 # cd build
0061 # make test
0062
0063 ================================================================================
0064 To install LabPlot execute
0065
0066 # cd build
0067 # make install
0068
0069 ================================================================================
0070 To uninstall LabPlot execute
0071
0072 # cd build
0073 # make uninstall
0074
0075 ================================================================================
0076 To remove all build files in the base directory execute
0077
0078 # rm -rf build