Running the GUI when installed from source

[bgswaroop]

Unable to bring up the GUI after installing from source. I have cloned your repo and installed the relevant Python packages in a virtual environment. Note- PyQt6 is also installed. After activating the virtual environment, I tried to run the GUI by issuing the command:

Attempt 1

cd yeaz
python GUI_main.py

However, I get the following error:

Traceback (most recent call last):
File "/Users/guru/Documents/DSSC/Tools/YeaZ-GUI/yeaz/GUI_main.py", line 86, in
from .disk import Reader as nd
ImportError: attempted relative import with no known parent package

Attempt 2

I have also tried to run the program from the parent directory (i.e, Yeaz-GUI), with the command:

python yeaz/GUI_main.py
This also resulted in the same error as in Attempt1.

Attempt 3

Following some advice online, I tried to run the python code again from the parent directory (i.e, Yeaz-GUI), this time as a module using:

python -m yeaz.GUI_main
The code exits without displaying any error, and I was not sure what was happening.

Setup used to run the code:

I have used the following configuration to run the code:

• MacOS Sequoia 15.3.1
• MacBookPro M3 Pro, 18GB RAM
• Python Version: 3.13.2
• Due to issues using the h5py and imagecodecs versions, mentioned in the requirements.txt, I have used the following set of Python packages:
  contourpy==1.3.1
  cycler==0.12.1
  et_xmlfile==2.0.0
  filelock==3.17.0
  fonttools==4.56.0
  fsspec==2025.2.0
  h5py==3.13.0
  imagecodecs==2024.12.30
  imageio==2.37.0
  Jinja2==3.1.5
  kiwisolver==1.4.8
  lazy_loader==0.4
  MarkupSafe==3.0.2
  matplotlib==3.10.0
  mpmath==1.3.0
  munkres==1.1.4
  nd2reader==3.3.0
  networkx==3.4.2
  numpy==2.2.3
  opencv-python-headless==4.11.0.86
  openpyxl==3.1.2
  packaging==24.2
  pandas==2.2.3
  pillow==11.1.0
  PIMS==0.7
  pyparsing==3.2.1
  PyQt6==6.5.2
  PyQt6-Qt6==6.8.2
  PyQt6_sip==13.10.0
  python-dateutil==2.9.0.post0
  pytz==2025.1
  scikit-image==0.25.2
  scipy==1.15.2
  setuptools==75.8.0
  six==1.17.0
  sklearn==0.0
  slicerator==1.1.0
  sympy==1.13.1
  tifffile==2025.2.18
  torch==2.6.0
  tqdm==4.66.1
  typing_extensions==4.12.2
  tzdata==2025.1
  wheel==0.45.1
  xmltodict==0.14.2

If there is a problem with my configuration, then I would expect to see some error message. Since there is no error message logged to the console, this makes me believe there might be some other issue running the code. In the section Running the GUI, I did not find a mention of how to run the GUI when installed from source. The point "3. Run the program with the command yeaz", only describes the way to powerup the GUI when yeaz is directly installed as a package from pip (i.e., with pip install yeaz).

Any help would be appreciated.

[bgswaroop]

I managed to run the code, with the following workaround with Python modules:

Create a Python script at the root directory, i.e., all the package directories must be a subdirectory of this directory. (See the discussion in this SO post, and the suggestion in the linked comment).

Following the advice given above, I have created main.py in the YeaZ-GUI directory which is the root of this repository, with the following contents:

import yeaz.__main__ as gui

if __name__ == '__main__':
  # Run the GUI
  gui.run() 

Calling this method fixes the issue with the Python relative imports. it would be nice if this could be fixed in the main repository as well. I can submit a pull request if needed.

If the authors of this repo have any other solution, I am eager to learn.