Page history Edit this page How do I edit this website?
Original MediaWiki page

Labkit

The content of this page has not been vetted since shifting away from MediaWiki. If you’d like to help, check out the how to help guide!

Labkit is a user-friendly Fiji plugin for the segmentation of microscopy image data. It offers easy to use manual and automated image segmentation routines that can be rapidly applied to single- and multi-channel images as well as timelapse movies in 2D or 3D. Labkit is specifically designed to work efficiently on big image data and users of consumer laptops can conveniently work with multiple terabytes large image data. This efficiency is achieved by using Imglib2 and BigDataViewer as the foundation of our software. Furthermore, memory efficient and fast random forest based pixel classification based on the Waikato Environment for Knowledge Analysis (WEKA) is implemented, optionally exploiting the power of graphics processing units (GPUs) to gain additional performance and can even be used on high performance computing clusters (HPC) for distributed processing of big image data. Finally, manual tools for ground-truth annotation are available.

Installation

  1. Install Fiji
  2. Install Labkit’s update site:
    1. Start Fiji
    2. From the menu, select HelpUpdate
    3. Click on Manage Update Sites, then select Labkit in the table
    4. Close, click on Apply changes and then Ok
    5. Restart Fiji
  3. Find Labkit in the plugin menu of Fiji, under “Labkit”.

Documentation, tutorials and guidelines

  • The documentation provides details of Labkit functionalities
  • In the tutorials page, you fill find diverse general and advanced tutorials, from manual and automatic segmentation, to macro, GPU-acceleration and running labkit on HPC clusters.
  • The guidelines page gives insight in how to improve the automatic segmentation

FAQ

Is it possible to manually segment a 3D image slice by slice?

Yes, this can be achieved by a workaround: Simple convert your image to 2D+time before opening it with Labkit. In Fiji use “Image > Hyperstacks > Re-order Hyperstack …” to convert your image from 3D to 2D+time.

After starting Labkit the window that should show my image is black?

This often happens if Labkit can’t find proper brightness & contrast settings. Please click the button that says “auto contrast”.

How I manually select the colors and brightness settings that are used to show the image?

Click S on your keyboard. This should show the BigDataViewer brightness & color dialog. Use it to manually adjust those settings.

Can Labkit distinguish more than two classes “foreground” and “background”

Yes, simple click the “Add label” button this will add a new class. You are free to name labels / classes as you would like, simple double click on the label.

How can I change the color of the labels?

Just click on the colored rectangle left of the labels name. This will show a color selection dialog.

Keyboard Shortcuts

Basic Navigation

Labkit is based on BigDataViewer. Navigation the image works as in BigDataViewer, and many shortcuts work too. Click here for a description of the shortcuts.

  • ⌃ Ctrl + ⇧ Shift +  Mouse Wheel to zoom in and out
  • Right Drag to move the image
  • Left Drag to rotate a 3d image
  • Mouse Wheel to scroll through the z-slices of a 3d image

Drawing Tool

  • D +  Left Click to draw with the pencil tool.
  • E +  Left Click to erase with the pencil tool.
  • F +  Left Click to use the flood fill tool.
  • R +  Left Click to remove a connected component.
  • N - switch to next label