CLIJ

Logo

GPU-accelerated image processing in ImageJ using CLIJ

View the Project on GitHub clij/clij-docs

Installation

Download and install Fiji. Afterwards, click the menu Help > Update... and activate the [CLIJ update site](installationInFiji.

Image

After restarting Fiji, CLIJ is successfully installed, if you find a menu entry Plugins > ImageJ on GPU (CLIJ).

Testing the installation

You can execute this macro to see if CLIJ and graphics card drivers are installed correctly. In case of issues, consult the troubleshooting section or contact us via image.sc.

Windows and MacOS

On Windows and MacOS the installation should work right away in case the computer has a built-in Intel HD or AMD Ryzen GPU. In case dedicated AMD or NVidia GPUs are used, special drivers might have to be installed. Search for more information about drivers on the websites of the GPU vendors.

Windows: AMD and NVidia graphics cards

In case of processing large images and/or working with large kernels, errors may pop up when using NVidia or AMD graphics cards on Windows. The issue is related to a timeout of the operating system interrupting processing on the GPU. Add the following entries keys to the windows registry and restart the computer:

[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\GraphicsDrivers]
"TdrDelay"=dword:0000003c
"TdrDdiDelay"=dword:0000003c

Be really careful when doing this. Don’t do it, if you’re not aware what that means. Ask you IT department for support. Read the BSD3 license file for details on why we’re not responsible for your actions on your computer. More technical background information:

https://docs.microsoft.com/en-us/windows-hardware/drivers/display/tdr-registry-keys

https://community.amd.com/thread/180166

https://support.microsoft.com/en-us/help/2665946/display-driver-stopped-responding-and-has-recovered-error-in-windows-7

Linux

Linux users need to install drivers for OpenCL, even on Intel HD GPUs. It is recommended to install the packages beignet and ocl-icd-devel.

Back to CLIJ documentation

Imprint