Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
Zellige-core
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Build
Pipelines
Jobs
Pipeline schedules
Artifacts
Deploy
Releases
Container Registry
Model registry
Operate
Environments
Monitor
Incidents
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
IdA Public
Zellige-core
Commits
ce46bc61
Commit
ce46bc61
authored
3 years ago
by
Céline TREBEAU
Browse files
Options
Downloads
Patches
Plain Diff
update of README file
parent
47eaa67d
No related branches found
No related tags found
1 merge request
!31
Gui modifications
Pipeline
#80267
passed
3 years ago
Stage: build
Stage: test
Stage: deploy
Stage: versioning
Changes
1
Pipelines
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
README.md
+84
-21
84 additions, 21 deletions
README.md
with
84 additions
and
21 deletions
README.md
+
84
−
21
View file @
ce46bc61
# Zellige

<img
src=
"doc/zellige_pipeline.jpg"
width=
"150"
height=
"150"
alt=
"drawing"
/>
<img
src=
"doc/zellige_pipeline.jpg"
>
#
#
Workflow
#
Zellige : 3D fluorescence microscopic images surface extraction tool.
The program takes a 3D stack as input and generates the projection of all surfaces contained in the 3D stack as 2
D
image
s
. Th
at
pro
cess can be divided into 3 stages :
Zellige is a software tool allowing the automated extraction of a non-prescribed number of various surfaces from a 3
D
image
acquired by fluorescence microscopy
. Th
e
pro
gram is available through a FIJI plugin.
-
first the selection of all the pixels belonging to any selectedPixels
-
second the regrouping of those selected pixels to produce a height map for each selectedPixels
-
third the use of each height map to extract a projection according to a given projection's method (only MIP for now).
**Table of content.**

*
[
Citation.
](
#citation
)
*
[
Motivation
](
#motivation
)
*
[
Installation.
](
#installation
)
*
[
Description.
](
#description
)
*
[
Example datasets.
](
#example-datasets
)
*
[
Usage.
](
#usage
)
## Build
+
[
Other projection tools.
](
#other-projection-tools
)
````
## Citation.
mvn clean install
If you use this work for your research, please cite the paper it is described in:
> __Extracting multiple surfaces from 3D microscopy images in complex biological tissues with the Zellige software tool.__
>
> Céline Trébeau, Jacques Boutet de Monvel, Gizem Altay, Jean-Yves Tinevez, Raphaël Etournay
>
> bioRxiv 2022.04.05.485876; doi: https://doi.org/10.1101/2022.04.05.485876
## Motivation
The quantitative study of epithelium development by fluorescence microscopy requires either the dissection of the
epithelium to discard all potential contaminating structure (in terms of signal) surrounding it or the acquisition of
all the epithelium adjacent structures allowing to have a more accurate state of the epithelium in its biological and
physical environment. The latter approach requires to segment each structure separately. Most existing methods allow for
the extraction of a single surface witch has to be smooth, and presenting a sufficiently high signal intensity and
contrast and usually fail otherwise. These methods so far do not address the need to extract several surfaces of
interest within the same volume. We developed Zellige, a tool allowing the automated extraction of a non-prescribed
number of surfaces of varying inclination, contrast, and texture from a 3D image. The tool requires the adjustment of a
small set of control parameters, for which we provide an intuitive interface implemented as a Fiji plugin.
## Installation.
As a FIJI plugin (https://fiji.sc/) ,Zellige can be installed directly within
the
[
Fiji updater
](
https://imagej.net/ImageJ_Updater
)
.
In the
`Manage update sites`
window, check the
`Zellige`
plugin. Click the
`Close`
button, then the
`Apply changes`
button. After the plugin is downloaded, restart Fiji. The plugin can then be launched from the _Plugins > Zellige_ menu
item.
## Description.
Zellige performs projection of multiple surfaces of interest on a 2D plane from a 3D image. For now, it can only be used
on 1-channel 3D images presenting one or several surfaces. The program takes a 3D stack as input and generates the
projection of all surfaces contained in the 3D stack as 2D images. That process can be divided into 3 stages :

-
first the selection of all the pixels belonging to any surface
-
second the regrouping of those selected pixels to produce a
**height map**
for each surface
-
third the use of each height map to extract a projection.
The height-map is then used to extract a projection from the 3D image. A fixed offset can be specified separately for
each channel, and is used to collect intensity in planes above or below the reference surface. Several planes, specified
by a ∆z parameter, can be accumulated to generate a better projection, averaging the pixel values or taking the maximum
value of these planes.
## Example datasets
https://zenodo.org/record/6376584
https://zenodo.org/record/6376594
https://zenodo.org/record/6376582
https://zenodo.org/record/6376566
https://zenodo.org/record/6376542
````
## Usage
The plugin is currently in development
````
````
## Pipelines
https://gitlab.pasteur.fr/ctrebeau/zellige-core/-/pipelines
\ No newline at end of file
After installation, the plugin is located in the
`Plugins >`
menu of Fiji. The Zellige window is divided in 3 parts
corresponding to each step of the program. Its UI is a single window divided in 3 for each stage (selection,
construction and projection):
### Other projection tools.
There are several other tools to generate this kind of projections:
-
Local Z projector, an ImageJ plugin :
-
Stack Focuser, an ImageJ plugin: https://imagej.nih.gov/ij/plugins/stack-focuser.html
-
SurfCut, an Image macro: https://bmcbiol.biomedcentral.com/articles/10.1186/s12915-019-0657-1
-
PreMosa, a standalone software: https://academic.oup.com/bioinformatics/article/33/16/2563/3104469
-
Extended Depth of Field, an ImageJ plugin: http://bigwww.epfl.ch/demo/edf/
-
Min. Cost Z Surface, an ImageJ plugin: https://imagej.net/Minimum_Cost_Z_surface_Projection
-
FastSME and SME, MATLAB software for the extraction of smooth-manifold
structures: https://openaccess.thecvf.com/content_cvpr_2018_workshops/w44/html/Basu_FastSME_Faster_and_CVPR_2018_paper.html
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment