Troubleshooting

This section provides solutions to common issues that may arise when using the QTCAD software.

mach-o file, but is an incompatible architecture (have ‘x86_64’, need ‘arm64’)

If you see an error such as the following:

E   ImportError: dlopen(/opt/homebrew/Caskroom/miniconda/base/envs/qtcad/lib/python3.10/site-packages/fmm3dpy/hfmm3d_fortran.cpython-310-darwin.so, 0x0002):
 tried: '/opt/homebrew/Caskroom/miniconda/base/envs/qtcad/lib/python3.10/site-packages/fmm3dpy/hfmm3d_fortran.cpython-310-darwin.so'
  (mach-o file, but is an incompatible architecture (have 'x86_64', need 'arm64')),
   '/System/Volumes/Preboot/Cryptexes/OS/opt/homebrew/Caskroom/miniconda/base/envs/qtcad/lib/python3.10/site-packages/fmm3dpy/hfmm3d_fortran.cpython-310-darwin.so'
    (no such file), '/opt/homebrew/Caskroom/miniconda/base/envs/qtcad/lib/python3.10/site-packages/fmm3dpy/hfmm3d_fortran.cpython-310-darwin.so'
     (mach-o file, but is an incompatible architecture (have 'x86_64', need 'arm64'))

This is a known issue with the fmm3dpy package on Apple Silicon processors (e.g. Apple M1). As explained in Package installation with conda (recommended), please create a new conda environment in osx-64 mode with:

softwareupdate --install-rosetta
** RESTART YOUR SHELL **
CONDA_SUBDIR=osx-64 conda env create -f qtcad-mac.yml

Gmsh fails to install due to the absence of graphics-related libraries

On some systems, the Gmsh package may fail to install due to the absence of graphics-related libraries. This is particularly common on headless servers.

To fix this problem, you can install the required graphics libraries using the following command:

sudo apt-get install -yq --no-install-recommends make libglu1-mesa libxi-dev libxmu-dev libglu1-mesa-dev libgl1-mesa-glx libc6-dev libxrender1 libxcursor1 libxft2 libxinerama1