lsm3d¶

The Level Set Method (LSM)¶

The main idea of the level set method in image segmentation is to evolve a contour until it fits a desired object in the image. A level set function (LSF) is defined on the image (one value per pixel), and the contour is defined as it's zero crossing points. The function is positive inside the contour and negative outside of it. At each time step, the values of the LSF are updated in each pixel, and thus the zero crossing points change and the contour evolves. The LSF's evolution is such that an energy is minimized, which in turn is usually based on the image properties (gradient, intensity...) and the geometrical aspects of the contour (curvature, size...).

lsm_contour --> detects the outer surface of the tissue¶

The LSM is initialized with a linear threshold, which roughly separates the background from the cells. The threshold is linear in order to adjust for the image intensity variation along the z-axis. The function takes +c0 values inside the initial contour and -c0 outside, the area in the contour being the background. The contour evolves attracted mainly by the maximum gradient, corresponding to the edge of the cell walls. There are also a curvature term, to obtain a smoother contour, and an accelerating area term to push the contour towards the boundaries. At each time step, the background growth is measured. The algorithm stops when the growth stays in a small interval near zero for ten consecutive iterations.

Usage¶

In order to check the syntax, just lounch the binary without any argument. It will give as output

Usage : lsm_contour img t_up t_down a b smooth perUp perDown
Examples for parameter values:
------------------------------
img : grayscale image of cells, (.inr or .inr.gz)
Upper threshold : t_up = 20
Down threshold : t_down = 5
Area term : a = 0 (0.5, 1)
Curvature term : b = 0 (1)
Gaussian filter : smooth = 1 (0, if image already filtered)
Stop criteria : the contour evolution is in [perDown,perUp] for 10 consecutive iterations
     perUp = 0.002, perDown = -0.002

In order to test it on an image file "t3_cut.inr.gz", lounch the binary with parameters :

lsm_contour t3_cut.inr.gz 20 10 0 0 1 0.002 -0.002

The detected contour is in the directory "t3_cut_LSMcont20-10a0b0s1".

lsm_cells --> for cellular segmentation or nuclei detection¶

The detection of cell-shapes is done in 3 steps :
- eroding the watershed segmentation and initialize a function for each cell
- evolve independently each cell's contour, attract by the maximal gradient (the inside edge of the cell walls)
- evolve simultaneously every cell's contour, attract by the maximal intensity (center of the cell walls)
In the last step, every cell evolves for one iteration and then possible overlap is checked. An overlap region is considered not segmented. A cell can't evolve in an other cell area : overlap can only happen in a same iteration. At each iteration, the growth of the segmented areas is measured, and the algorithm stops when this growth becomes null.

Usage¶

You can recall the syntax any time by lounching the binary without any argument:

Usage : lsm_cells img img_wat img_contour erosion [a b smooth lsm_type]
----------------- 
img : grayscale image of cells, (.inr or .inr.gz)
img_wat : image of seeds, (.inr or .inr.gz)
img_contour : mask, where cells do not evolve, (.inr or .inr.gz)
              if 'None', then cells can evolve on the whole image
erosion : amount of erosion of seeds for initialisation (uint8) --> -2, 0, 2
              if 0, then no erosion or dilation
              if negative, then a dilation is performed
a : area term (float) --> 0 or 0.5 or 1 (the default is 0.5)
              if negative, the object retracts
              if positive, the object inflates
b : curvature term (float) --> 0 or 1 (the default is 0)
gamma : scale parameter (float>0) --> 0.5 or 1 (the default is 1)
smooth : gaussian blur to apply to the image (int) --> 0 or 1 (the default is 0)
lsm_type : image, gradient or hessien based evolution --> 'i', 'g' or 'h' (the default is g)

Applying it to the image "t3_cut.inr.gz" as the level sets are initialised by the watershed segmentation of the same image

lsm_cells t3_cut.inr.gz t3_cut_wat.inr.gz t3_cut_LSMcont20-10a0b0s1/t3_cut_LSMcont20-10a0b0s1.inr.gz 2 0.3 0 0.2 1 'h'

you will get the new segmentation in the "t3_cut_wat_cellLSM-d2-a0.3-b0-g0.2-s1-h" folder.