ImageJ/FIJI plugin generating contour lines with equal spacing on top of an image (using overlay).
Based/inspired by streamlines project by anvaka and this publication (use it for citation).
You need to download and install ImageJ or FIJI on your computer first.
For FIJI
- add https://sites.imagej.net/Ekatrukha/ to the list of update sites, as follows
- go to Help -> Update and press "Manage update sites" button
- press "Add update site" button and put the following link there https://sites.imagej.net/Ekatrukha/
For ImageJ
- Download and copy the latest version of plugin into the plugins folder of your ImageJ. (for example, in Windows look for C:\Program Files\ImageJ\plugins)
Restart ImageJ/Fiji and plugin will appear in Plugins menu
After plugin launch, rendering parameters window will appear
To find the "vector field of an image", plugin calculates convolution of image with derivative of Gaussian in x and y to estimate intensity gradient at each point. You can specify smoothing radius (SD of Gaussian). The larger the value, less small intensity details are available. For example, here are two images, the left one is build with smoothing radius of 2.0, while the right one with smoothing radius of 10.0 pixels.
Notice that the small spot in the right top corner "disappeared".
This parameter defines, how precisely contour generation routine follows gradient vector field of the image. Smaller value result in more precise contour lines, but also take longer time to generate them. Example below illustrates integration step of 0.05 (left) versus 0.5 pixels (right).
Well, how densely you want contour lines to be plotted. Left image is 3 px, right image is 10 px.
This parameter is a fraction of previous and it defines when the line integration will stop. I.e. end of each line cannot come closer than this distance to already existing lines. For example, on the left image parameter's value is 0.5, while on the right it is 0.1.
With this option checked, plugin will use current selected color (in toolbar or Color Picker) to build lines. Example:
Plugin will use one of the installed ImageJ/Fiji lookup tables (LUTs) to color code each contour with its average intensity. Pay attention, that current minimum and maximum of intensity would be taken from "Brightness/Contrast" settings of the image. In works better if your image uses "dark-to-bright" LUT and you check "Invert LUT" option for contours. In this case brighter lines would be on top of dark image areas and vice versa. In the example below the left image uses inverted "Thermal" LUT for contours, while contour LUT of the image on the right is not inverted.
Plugin will remove open contours (contours with free ends). Examples are below, left image includes open contours, while the right one not.
- v.0.0.4 added criteria for line integration end. Added a possibility to remove open contours.
Developed in Cell Biology group of Utrecht University.
Email katpyxa @ gmail.com for any questions/comments/suggestions.