/kf5-qt5/education/labplot/INSTALL

0001 To compile LabPlot from source 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 packages
0010         * LaTeX and Poppler version 0.62 or higher (including the devel-package, libpoppler-qt5-devel or similar) to enable LaTeX typesetting in LabPlot
0011                 * Required LaTeX packages: 'color', 'preview' and, in case xelatex or lualatex is used, 'xltxtra'.
0012                 * On Windows you need a LaTeX installation (like MiKTeX or TeX Live) for LaTeX support.
0013                 * On macOS you need a LaTeX installation (like MacTeX) 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                 * To use the backends the corresponding application must be installed
0021                 * The Python backend needs Python 3.8 installed on Windows
0022         * ZLIB and LZ4 to support ROOT (CERN) TH1 histograms (including the devel-package, zlib-devel and liblz4-devel or similar)
0023         * ReadStat for importing serveral statistical data formats (will be build if not available)
0024         * liborigin version 3 or higher for importing Origin project files (will be build if not available)
0025         * Matio for importing binary MATLAB MAT files (including the devel-package, libmatio-devel or similar)
0026         * QXlsx for importing Excel xlsx files (will be build if not available)
0027         * Qt SerialPort to support serial port functionality
0028         * Qt MQTT module (https://github.com/qt/qtmqtt) to support reading and plotting of data from MQTT brokers
0029         * KUserFeedback to support collecting feedback from users
0030         * Discount to support Markdown markup language text
0031
0032 ===============================================================================
0033 To build LabPlot execute
0034 # ./compile
0035
0036 Edit the compile script if you want to use options different from default ones.
0037 E.g. specify a custom installation path via
0038 -DCMAKE_INSTALL_PREFIX=/usr/local
0039
0040 or build a debug build via
0041 -DCMAKE_BUILD_TYPE=debug
0042
0043
0044 LabPlot's cmake configuration script searches for the optional packages and uses them if they are found.
0045 To compile LabPlot without optional dependencies even if they are present on the system, use the following parameters (default is "ON"):
0046 -DENABLE_FFTW=OFF
0047 -DENABLE_HDF5=OFF
0048 -DENABLE_NETCDF=OFF
0049 -DENABLE_FITS=OFF
0050 -DENABLE_LIBCERF=OFF
0051 -DENABLE_CANTOR=OFF
0052 -DENABLE_ROOT=OFF
0053 -DENABLE_READSTAT=OFF
0054 -DENABLE_MATIO=OFF
0055 -DENABLE_MQTT=OFF
0056 -DENABLE_QTSERIALPORT=OFF
0057 -DENABLE_LIBORIGIN=OFF
0058 -DENABLE_TOUCHBAR=OFF
0059 -DENABLE_EXCEL=OFF
0060
0061 Note, by switching off these libraries the feature set of LabPlot will be reduced.
0062
0063 To enable reproducable builds, use
0064 -DENABLE_REPRODUCIBLE=ON
0065
0066 ================================================================================
0067 To run the tests execute
0068
0069 # cd build
0070 # make test
0071
0072 ================================================================================
0073 To install LabPlot execute
0074
0075 # cd build
0076 # make install
0077
0078 ================================================================================
0079 To uninstall LabPlot execute
0080
0081 # cd build
0082 # make uninstall
0083
0084 ================================================================================
0085 To remove all build files in the base directory execute
0086
0087 # rm -rf build