Skip to content

Fiji Command – Isotropic Reconstruction (Retina)

Benjamin Wilhelm edited this page Jan 25, 2019 · 3 revisions

This page helps you getting started with the Fiji command for isotropic reconstruction on Retina images.

About the Command

The command can be used to perform an isotropic reconstruction on two-channel 3D images of Retina. In the background, a TensorFlow model is downloaded and applied to rotated and upsampled versions of the image and the results are combined by calculating the geometric mean of them.

Try it

Install and setup Fiji as described in the Installation Instructions.

Open an image

Download exemplary image data or use your own images for the following steps.

Start Fiji and open an image by choosing a file on your computer.

For this model, the image must be a 3D two-channel image with the axis X, Y, Channel, and Z.

Run the Command

To run the model choose Plugins > CSBDeep > Demo > Isotropic Reconstruction - Retina. A new window with parameters will pop up.

  • Number of tiles: Number of tiles the image is split into to prevent memory issues. Increase this value if the Fiji process uses too much memory and Batch size is already at 1.
  • Overlap between tiles: How much the tiles overlap. 32 is a good value to prevent border artifacts if Number of tiles is greater than 1.
  • Scale Z: The size of one pixel in the Z dimension.
  • Batch size: Number of 2D planes executed in parallel. Decrease this number if the Fiji process uses too much memory.

After that, the command will run. A new window will pop up which informs you about the status of the execution.

Interpret the Results

The command will output two images: called 'result' and 'control':

  • result: The location parameter μ of a Laplace distribution. Can be interpreted as the reconstructed image.
  • control: The scale parameter b of a Laplace distribution. This value is high if the network was less sure about the real value of the image.

NOTE: The control image is currently not shown by the plugin.

See the supplemental material for more detailed information.

To get a better overview of the result you can:

  • Display both channels: Open Image > Color > Channels Tool... and choose Composite.
  • Adjust the color balance: Open Image > Adjust > Color Balance... and click on Auto for both channels.
  • Display orthogonal views: Choose Image > Stacks > Orthogonal Views.

Troubleshooting

Out of memory exception/ high memory usage

If the image processed at once is too large the model will allocate too much memory and fail with an out of memory exception or consume all the available system memory. The plugin solves this problem by tiling the image into multiple smaller images and merging them again after the model was executed.

You can decrease the number of images processed in parallel by setting a lower value for the parameter 'Batch size'.

Slow execution

Running the model is computationally expensive and will take some time. Try the following things to speed it up:

  • Use a GPU: Neural networks can be executed much more efficiently on GPUs.

    If you have access to a more or less powerful Nvidia GPU you should use it. See Installation Instructions - GPU support

    The progress window will display a warning if you do not use a GPU:

  • Use a more powerful computer: If you have access to a powerful computer use it rather than your laptop.