Pathfinding software for triple-axis spectrometers.

• TAS-Paths' website can be found under www.ill.eu/tas-paths.
• The documentation is available here.

Steps to try out the pathfinding functionality:

• Move existing or add new walls or obstacles to the scene.
• Open the configuration space dialog using the "Calculation" -> "Angular Configuration Space..." menu item.
• Click the "Update Path Mesh" button in the configuration space dialog to compute the roadmap corresponding to the current instrument and wall configuration.
• Click the "Move Current Position" and "Move Target Position" radio buttons and click in the configuration space plot to set and move the start and target positions, respectively.
• A path from the start to the target position is calculated. It can be directly traced by clicking the "Go" button in the main window's "Path Properties" dock window.

• Install all required software for building (see list of external dependencies below):
  • On Ubuntu: sudo apt install git wget build-essential cmake libboost-all-dev qtbase5-dev libqt5svg5-dev libcgal-dev libqhull-dev libqcustomplot-dev swig libpython3-dev.
  • On Fedora: sudo dnf install git wget gcc cmake boost-devel qt5-qtbase-devel qt5-qtsvg-devel CGAL-devel qhull-devel qcustomplot-qt5-devel swig python3-devel.
• Clone the source repository: git clone https://code.ill.fr/scientific-software/takin/paths.
• Go to the repository's root directory: cd paths.
• Get the external dependencies: ./setup/get_libs.sh.
• Rebuild the latest versions of libraries with possible C++20 issues (see below): ./setup/rebuild_libs.sh.
• Get the external licenses (for a release package): ./setup/get_3rdparty_licenses.sh.
• Build TAS-Paths using: ./setup/release_build.sh.
• Optionally create a package on Ubuntu using:
  • ./setup/deb/mk.sh jammy for Ubuntu 22.04 or
  • ./setup/deb/mk.sh focal for Ubuntu 20.04.
• The application can be started via ./build/taspaths.

• Install the Homebrew package manager.
• Install all required software for building: brew install git wget gcc cmake boost boost-python3 qt@5 cgal qhull swig python.
• Clone the source repository: git clone https://code.ill.fr/scientific-software/takin/paths.
• Go to the repository's root directory: cd paths.
• Get the external dependencies: ./setup/get_libs.sh.
• Rebuild the latest versions of libraries with possible C++20 issues (see below): ./setup/rebuild_libs.sh.
• Get the external licenses (for a release package): ./setup/get_3rdparty_licenses.sh.
• Build TAS-Paths using: ./setup/release_build.sh.
• Optionally create a package using ./setup/osx/mk.sh.
• The application can be started via ./build/taspaths.

• Install all required software for building: sudo dnf install mingw64-gcc mingw64-gcc-c++ mingw64-boost mingw64-qt5-qtbase-devel mingw64-qt5-qtsvg mingw64-python3.
• Clone the source repository: git clone https://code.ill.fr/scientific-software/takin/paths.
• Go to the repository's root directory: cd paths.
• Get the external dependencies: ./setup/get_libs.sh.
• Rebuild the latest versions of libraries with possible C++20 issues (see below): ./setup/rebuild_libs.sh mingw.
• Get the external licenses (for a release package): ./setup/get_3rdparty_licenses.sh.
• Build TAS-Paths using: ./setup/release_build.sh mingw.
• Optionally create a package on Ubuntu using ./setup/mingw/mk.sh.

Because TAS-Paths uses the still relatively new C++20 standard, there may be compatibility issues with older versions of some libraries.

• In case of compilation errors involving QHull, get and compile the latest version directly from its source. This C++20 compatibility issue was solved in late 2022.
• In case of Boost compilation errors, e.g. if Boost's auto_buffer.hpp complains that std::allocator<...>::pointer is missing (which was removed in C++20), get and compile the latest version directly from its source. This C++20 compatibility issue was solved in early 2020.