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

TreeJ

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!

File

TreeJ_-1.0.0-SNAPSHOT.jar

Source

on GitHub


This plugin contains an interface to reconstruct interactively and recursively a cell lineage from a static labeled image. It allows to :

  • merge two sister cells on the image
  • construct a lineage tree displayed on the interface
  • annotate the constructed tree
  • extract some set of images related to TreeJ functions
  • save as a tree file compatible with other tree viewer and/or TreeJ

Installation

  • Download the .jar and place it in the Plugins directory of the ImageJ/Fiji directory or
  • In Fiji, add the TreeJ site to your list of update sites:
    1. Select HelpUpdate… from the menu to start the updater.
    2. Click on Manage update sites.
    3. Activate the TreeJ update site and close the dialog.
    4. Click Apply changes and restart ImageJ.

TreeJ is now accessible in PluginsTreeJ.

Usage

Input

TreeJ should be launched on a 2D or 3D labeled image (8 bits, 16 bits or 32 bits). The labeling can be discontinuous and watershed lines, if present, are not a problem. The region labels with zero are considered as the background. As TreeJ changes labels in the image, the input image is protected but the output images may have a different depth.


Tree construction

To link two sister cells (in Pair cells panel):

  • click on them on the image, it actualizes the corresponding fields (Label1 and Label2)
  • or write label numbers in fields Label1 and Label2

Apply to validate the pairing

Reset to put fields in their initial state.

To make a modification (in Unpair or tag panel):

  • select the erroneous mother cell with click+Ctrl (or Click+pom on MACOS) and
  • or write the label number in the Label field

Validate with the Unpair button.


Tree annotation

  • if Tag field is filled during linking action, the created mother cell will have the tag
  • select the cell (⌃ Ctrl +  Left Click) or enter its label number in the label field of the unpair and tag panel and enter the tag in the field “Tag”

Apply to validate the tagging.


Image output

  • TreeJ doesn’t modify the input image. To extract the modified shown image : use Current view
  • an image of cells from a Substree
  • an image of all cells coming from a mother tagged with the wanted tag

Tree

To saved tree information, two possible formats :

The drawing tree can be exported to a PDF file (named with the input image name) with the Export to PDF button.


Example

From a segmented image of an Arabidospsi thaliana embryo of 122 cells (FigA), a cell lineage have been backtracked until the 16 cell stage configuration.

  • Current view extraction gives the figB, as TreeJ merges sister cells. We see the eight external domains, and there are eight internal domains like shown on the figD (obtain with the external layer and suspensor removing).
  • For each domain we can reconstruct the lineage and obtain a tree with TreeJ (see Fig right : a tree of an external apical domain).
  • We tagged internal domains of the embryo and extracted the corresponding image them with From Tag (figC).

Visit the Github to have information on the development of TreeJ.

See the related paper.

  1. GNU Lesser General Public License
    The GNU Lesser General Public License (LGPL) is a free, open source license for software and other kinds of works.
  2. Why Closed-Source Is Wrong
    This page has a few war stories about having to fight with developing software where you should not need to fight.
  3. GNU General Public License
    The GNU General Public License (GPL) is a free, open source license for software and other kinds of works.
  4. Apache Software License
    The Apache License is a permissive free software license, imposing minimal restrictions on the redistribution of covered software.
  5. Detect Information Loss
    How to detect various forms of information loss in images
  6. Eclipse Public License
    The Eclipse Public License (EPL) is a free, open source software license.
  7. Color Image Processing
    Images with color come in three different forms: pseudo-color, 24-bit RGB image, or color composite image.
  8. Why Open Source?
    This page highlights the benefits of open source software.
  9. BIG Licensing
    Components distributed via the BIG-EPFL update site were developed by the Biomedical Imaging Group (BIG) at the École Polytechnique Fédérale de Lausanne (EPFL).
  10. Public Domain
    Software in the public domain disclaims all copyright interest, being freely available to everyone for any purpose, with no attribution or acknowledgement required.
  11. Deconvolution
    corrects the systematic error of blur (loss of contrast in smaller features) in optical systems such as fluorescence microscopy images.
  12. Visualization
    is a set of techniques for graphically illustrating scientific data, enabling scientists to better understand, illustrate, and glean insight from their data.
  13. BSD Licenses
    BSD licenses are a family of permissive free software licenses, imposing minimal restrictions on the redistribution of covered software.
  14. Voxelization
    Voxelization is the process of converting a data structures that store geometric information in a continuous domain (such as a 3D triangular mesh) into a rasterized image (a discrete grid).
  15. MIT License
    The MIT License is a permissive free software license, imposing minimal restrictions on the redistribution of covered software.
  16. Licensing
    This page describes the legal structure of ImageJ and SciJava projects.