CLIJ2

Logo

GPU accelerated image processing for everyone

CLIJ2 home

Installation

Image

Download and install Fiji. Afterwards, click the menu Help > Update... Image Click on Manage Update Sites Image

and activate the CLIJ and CLIJ2 update sites.

Image

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

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 CLIJ2 documentation

Imprint