Installation under Windows

For detailed instructions, see manual.
For a newer (quicker) installation procedure, see below.

Quick installation under Windows (beta)

This is for Windows only; for instructions how to experimentally (!) install QDSpy under Linux, see here.

Note: I tested different virtual environments for Python to keep the QDSpy installation isolated from the system but none of these were really convincing. The following procedure works but still requires pip for some packages in a conda environment.

1. Install Anaconda (currently with Python v3.11)

2. Clone the branch of choice to a new location on your drive:

   git clone https://github.com/eulerlab/QDSpy.git
   

   or

   git clone -b experimental https://github.com/eulerlab/QDSpy.git
   

3. Change into that folder, create a new conda environment, and activate it:

   cd qdspy
   conda config --add channels conda-forge
   conda create --name qdspy
   conda activate qdspy
   

4. Install packages.

   conda install pip
   pip install pyglet==1.5.7
   pip install moviepy
   conda install qt.py
   conda install numpy
   conda install pywin32
   conda install psutil 
   conda install pyserial 
   conda install hidapi
   

   If you don't care about the conda environment, you can also use the much quicker:

   pip install -r requirements.txt
   

5. Make sure that Windows knows the variable PYTHONPATH set to your QDSpy folder.
   To check, use:

   $env:PYTHONPATH
   

   To set the folder (e.g., for c:\qdspy), use:

   [System.Environment]::SetEnvironmentVariable("PYTHONPATH", $env:PYTHONPATH + ";c:\qdspy", [System.EnvironmentVariableTarget]::User)
   

Troubleshooting

• In case PyQt5 does not load (e.g., ImportError: DLL load failed while importing QtWidgets [...]), try reinstalling PyQt5 from within the conda environment with pip3:

  pip3 install PyQt5 --user --ignore-installed