Installation

This guide walks you through the installation of two components:

  1. DataQruiser App: our graphical user interface to visualize and interact with your data. You can download and install the application from dataQruiser App Releases.

  2. the qDrive Package: allow you to interact with your measurement data and synchronizing it with the DataQruiser app from python. This document details how to install the qDrive package.

Requirements

  • The minimum Python version is Python 3.7.

It is highly recommended to install the qDrive package in a separate environment to prevent conflicts with other Python packages, especially if older measurement software is in use.

Setting Up the Environment

To create a new environment and install the qDrive package, open the Anaconda prompt and run:

conda create -n qdrive_env python=3.11

If you wish to install qDrive in an existing environment, you can test its compatibility by cloning the environment:

conda create --name myclone --clone my_measurement_env

After installation, ensure compatibility by importing your commonly used packages.

Note

Remember to activate the environment when you open a new terminal or prompt:

conda activate qdrive_env

Spyder users : Ensure Spyder is updated to use PyQt5 >= 5.15.0 to avoid compatibility issues.

Installing the qDrive package

Once your environment is active, install the qDrive package by running:

pip install qdrive==0.2.42

Note

If you want to synchronize core-tools data, install both pulse-lib and core-tools in the qDrive environment by running:

pip install git+https://github.com/stephanlphilips/pulse_lib
pip install git+https://github.com/stephanlphilips/core_tools

After installation, you should be able to run qDrive. For example, to log in, run:

python -c "import qdrive; qdrive.launch_GUI()"

Updating the qDrive package

If the synchronization GUI is open, close it first.

To update qDrive, activate the environment where it was installed and run:

pip install qdrive --upgrade

We recommend restarting the synchronization agent to ensure it uses the latest version. Run the following commands:

python -c "import qdrive; qdrive.restart_sync_agent(); qdrive.launch_GUI()"

Troubleshooting Installation Errors

If you encounter errors during installation, it may be due to package dependencies. To resolve these, update the relevant package by running:

pip install -U package_that_needs_an_update