You are here: Start » PyAVL » Troubleshooting

Troubleshooting

ImportError: DLL load failed while importing AVL (Windows)

The wrapper depends on AVL.dll. If Python cannot locate it:

  • Ensure you ran pip install from the correct directory. The build hook packages all required DLLs into the wheel.
  • Confirm you are running 64-bit Python 3.12 or later.

ImportError: DLL load failed while importing AVLDL (Windows)

The DL wrapper depends on AVLDL.dll and CUDA/OnnxRuntime DLLs:

  • Ensure both PyAVL and PyAVL-DL are installed via pip install.
  • Ensure the Deep Learning add-on is installed on the machine.
  • For GPU inference, verify CUDA drivers are installed.

ImportError: cannot open shared object (Linux)

If the shared libraries cannot be found:

  • Confirm the pip install completed without errors. On Linux, pip packages all shared library dependencies directly into the wheel.
  • Re-run pip install from the installation directory to refresh the package.

ModuleNotFoundError: No module named 'AVL'

Python cannot find the extension module:

  • Run pip show pyavl and confirm the installation is present.
  • Confirm you are using the same Python environment where the package was installed.

ModuleNotFoundError: No module named 'AVLDL'

Python cannot find the DL extension module:

  • Run pip show pyavl-dl and confirm the installation is present.
  • PyAVL-DL depends on PyAVL. Run pip show pyavl to confirm PyAVL is also installed.

Wrong Python Version

PyAVL requires Python 3.12 or later. Verify:

python --version

If the output is earlier than Python 3.12, switch to Python 3.12 or a newer release before importing.

TypeError: unsupported operand type(s)

The operator is not defined for the given combination of types. For example, two vectors cannot be multiplied with *, and a float cannot be added to a Location. See Operators on Geometry Types and Working with Matrices for the supported combinations.

Hints

  • Use a virtual environment to isolate dependencies and avoid version conflicts.
  • Use the help() function to explore available functions and their signatures at the Python prompt.
  • .pyi stub files sit alongside the extension module and enable IDE code completion and static type checking.
  • PyAVL-DL requires PyAVL. Install PyAVL first, then PyAVL-DL.

See Also

Previous: Image Acquisition