CLIJx-Assistant is under development. Please install it only in a separate Fiji installation. Do not use it for routine research yet. Planned release is summer 2021. Stay tuned.
- Download and unpack Fiji
- Start Fiji and run its update using the menu
Help > Update
- Click on "Manage update sites" and activate the three updates sites "clij", "clij2" and "clijx-assistant".
- Click on "Close"
- Click on "Apply Changes"
- Restart Fiji
Installation was successful if you find the CLIJx-Assistant starting point button in Fijis tool bar:
There are extensions available, e.g. for BoneJ, ImageJ, ImageJ2, ImageJ 3D Suite, Imglib2, MorphoLibJ and SimpleITK. To make use of them, please also activate these update sites:
- clijx-assistant-extensions
- 3D ImageJ Suite
- BoneJ
- IJPB-Plugins
Download and upack ImageJ and some jar-files:
- clij2-imagej_-2.2.0.19-jar-with-dependencies.jar
- clijx-weka_-0.30.1.19.jar
- clijx_-0.30.1.19.jar
- clijx-assistant_-0.4.2.19.jar
Please put these jar files in the plugins sub-directory of ImageJ:
Installation in ImageJ was ok, if the menu Plugins > ImageJ on GPU (CLIJx-assistant) appeared.
Click on Start CLIJx-Assistant to try it out.
If a window with a green frame appears, it worked!
Download and install MicroManager 2 and some jar files:
- clij2-imagej_-2.2.0.19-jar-with-dependencies.jar
- clijx-weka_-0.30.1.19.jar
- clijx_-0.30.1.19.jar
- clijx-assistant_-0.4.2.19.jar
Please put these jar files in the plugins\Micro-Manager sub-directory of MicroManager:
Start MicroManager and check if the installation worked as in the ImageJ section above.
During multi-dimenionsal acquisition, just Start CLIJx-Assistant and use the right click menu to setup a workflow:
In case of any issues, please refer to the more detailed installation instructions of CLIJ2 and the trouble shooting section.
Windows users may have to install graphics cards drivers downloaded from the vendors website (AMD, NVidia). The driver delivered by Windows Update is not sufficient.
When using an AMD graphics card in recent Macs, you may want to turn OFF the option "Automatic graphics switching" under System Preferences / Energy Saver. Thanks to Tanner Fadero for finding this out.
Also under linux, installation of drivers from the vendors website is necessary (AMD, NVidia). Furthermore, when working with Intel graphics, it might be necessary to install packages such as "ocl-icd-devel" to make Fiji / CLIJ discover the right GPU devices.
If you want to export your workflows notebook style with ImageJ Macro Markdown, please also activate the "IJMMD" update site in Fiji.
In order to build Fiji plugins, please install Java Development kit, version 8 or higher, e.g. OpenJDK.
Furthermore, please download and install git and maven.
For technical reasons, the /bin/ folder of the git installation must be added to the PATH of the operating system.
Furthermore, it is recommended to add maven to the path as well.
(How to:
Windows
Linux
MacOS
).
After installing git, maven and the JDK, please enter appropriate paths under Plugins > ImageJ on GPU (CLIJx-Assistant) > Options > Build and Run options
The above mentioned tools allow you to compile Fiji plugins. In order to edit the code conveniently, it is recommended to install an Integrated Development Environment (IDE) such as IntelliJ or Eclipse.
If you want to implement workflows using CLIc in C++, please follow the installation instructions here.
For exporting workflows to Icy Protocols, it might be handy to start Icy from ImageJ. Therefore, download and install Icy
and enter its location under Plugins > ImageJ on GPU (CLIJx-Assistant) > Options > Build and Run options.
If you want to run Python and/or Napari from Fiji, please install a conda environment, e.g. via mini-conda.
Using conda, create a conda environment e.g. named te_oki:
conda create --name te_oki
Activate the environment:
conda activate te_oki
Install dependencies, either via conda install or
pip install pyopencl napari ipython matplotlib numpy pyclesperanto_prototype scikit-image jupyter
Within this environment you can run generated clEsperanto python scripts.
If the name of your conda environment differs, please configure it under Plugins > ImageJ on GPU (CLIJx-Assistant) > Options > Build and Run options
For running pyimagej python code, please follow the installation instructions on the pyimagej github page.
CLIJx-Assistant uses modern graphics cards to ensure real-time image processing experience. Therefore, it is recommended to utilize state-of-the art graphics computing units (GPUs). When considering purchasing modern GPUs, please take into account:
- Memory size: As image processing is memory-bound look out for GPUs with large memory. For typical scenarios, it is recommended to buy GPUs with at least 8 GB of GDDR6 RAM memory.
- Memory Bandwidth: GPU vendors specify their products computing capabilities with various terminology and metrics. Look out for memory bandwidth: typical GDDR5-based GPUs have a memory bandwidth < 100 GB/s. Quite some GDDR6 GPUs for example offer > 400 GB/s. Thus, GDDR6-based GPUs may compute image processing results about 4 times faster!
- Integrated GPUs: If you desire processing images in long workflows, it might make sense to use integrated GPUs with access to huge amounts of DDR4-memory. They are more affordable.
You can check the capabilities of your graphics processing units by selecting a device using the menu `Plugins > ImageJ on GPU (CLIJx) > Change default CL device```
The menu Plugins > ImageJ on GPU (CLIJx) > Memory Display allows you to overview available memory and memory consumption while building your workflow.
Back to CLIJx-Assistant