Installation
SlipSurfaceIQ LE runs on Windows and Linux. The easiest way is an installer: it contains Python, Qt and the scientific libraries, so there is nothing else to set up. You can also run the program from source with your own Python.
Installers
The installers for this version are not published yet. The release page has its notes; earlier versions are still available to download.
- Download the package for your system.
- On Windows double-click the MSI. On Linux install it with the command shown, from the folder you downloaded it to; the package manager also installs the Qt desktop libraries it needs.
- Start SlipSurfaceIQ LE from the application menu. On Linux the
slipsurfacecommand works in a terminal too.
Good to know
- Windows: the MSI is not signed yet, so Windows SmartScreen may warn before it runs; choose More info → Run anyway. The program is installed under
Program Files\SlipSurfaceIQ LE, and a later version replaces it. - Linux: the packages need glibc 2.39 or newer and an X11/XWayland desktop. They are tested on Ubuntu 24.04, Fedora 44, openSUSE Leap 16 and current Arch Linux; Tumbleweed uses the openSUSE RPM. openSUSE Leap 15 and SUSE Linux Enterprise 15 are not supported. The RPMs are not signed with a distribution key, so zypper may ask whether to accept them. The program goes to
/opt/slipsurface-iq-le. - Checksums: compare a download with the SHA256 checksums linked under the table above:
sha256sum -c SHA256SUMS --ignore-missingon Linux,Get-FileHash <file> -Algorithm SHA256in Windows PowerShell. - Uninstall through Installed apps on Windows or your package manager on Linux. Your projects and settings are kept.
From source
Running from source needs Python 3.10 or newer (3.11 – 3.14 recommended). The required packages are PySide6 (Qt), NumPy, SciPy, Shapely, ReportLab, ezdxf and QtAwesome; the launchers install them for you.
1. Get the program
Clone the repository, or download it as a ZIP and unpack it:
git clone https://github.com/hdaltuntas/SlipSurfaceIQ-LE
cd SlipSurfaceIQ-LE2. Start it
| System | Command |
|---|---|
| Windows | double-click run_windows.bat |
| Linux | ./run_linux_mac.sh |
macOS has not been tested yet. The program is written to run there too, with the same
./run_linux_mac.shlauncher, but this is not yet confirmed.
On the first run the launcher creates a virtual environment in .venv, installs the requirements and starts the program. It reinstalls them automatically whenever requirements.txt changes.
On Linux the Qt runtime libraries must be present; they normally are on a desktop system. On a minimal installation:
sudo apt install libegl1 libgl1 libxkbcommon0 libfontconfig1 libdbus-1-3 # Debian / Ubuntu
sudo dnf install libglvnd-egl libglvnd-opengl libxkbcommon fontconfig dbus-libs # Fedora
sudo pacman -S libglvnd libxkbcommon fontconfig dbus # Arch Linux
sudo zypper install libglvnd libxkbcommon0 fontconfig libdbus-1-3 # openSUSEManual set-up
python -m venv .venv
# Windows: .venv\Scripts\activate Linux: source .venv/bin/activate
pip install -r requirements.txt
python main.pymain.py can also be opened and run from any IDE (VS Code, PyCharm, Spyder). pip install -e . adds the slipsurface command.
Command line
python main.py # empty project
python main.py examples/anchored_cut.slp.json # open a project file
python main.py --example "ACADS EX1(a)" # open a bundled example
python main.py --list-examples # list the bundled examples
python main.py --check # check Python and the packagesNext
The overview shows a typical workflow; File → Examples opens ready-made models to start from.