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.