Bio-Formats

Bio-Formats Downloads
Licensing

Page Contents

Previous topic

ImageJ overview

Next topic

Bio-Formats features in ImageJ and Fiji

This Page

Fiji overview

Fiji is an image processing package. It can be described as a distribution of ImageJ together with Java, Java 3D and a lot of plugins organized into a coherent menu structure. Fiji compares to ImageJ as Ubuntu compares to Linux.

Fiji works with Bio-Formats out of the box, because it comes bundled with the Bio-Formats ImageJ plugins.

The Fiji documentation has been combined with the ImageJ wiki; for further details on Bio-Formats in Fiji, see the Bio-Formats ImageJ page.

Upgrading

Upgrading Bio-Formats within Fiji is as simple as invoking the “Update Fiji” command from the Help menu. By default, Fiji even automatically checks for updates every time it is launched, so you will always be notified when new versions of Bio-Formats (or any other bundled plugin) are available.

Manual upgrade

Manually updating your Fiji installation should not be necessary but if you need to do so, the steps are detailed below. Note that although we assume you will be upgrading to the latest release version, all previous versions of Bio-Formats are available from http://downloads.openmicroscopy.org/bio-formats/ so you can revert to an earlier version using this guide if you need to.

  1. Fiji must first be fully updated
  2. Close Fiji
  3. Open the Fiji installation folder (typically named ‘Fiji.app’)
  4. Remove bio-formats_plugins.jar from the ‘plugins’ sub-folder
  5. Remove all of the .jars from the ‘jars/bio-formats’ sub-folder:
    • jai_imageio.jar
    • formats-gpl.jar
    • ome-common.jar
    • turbojpeg.jar
    • ome-xml.jar
    • formats-bsd.jar
    • ome-poi.jar
    • specification.jar
    • mdbtools-java.jar
    • metakit.jar
    • formats-api.jar
  6. Download bio-formats_plugins.jar (from the latest release http://downloads.openmicroscopy.org/bio-formats/) and place it in the ‘plugins’ sub-folder
  7. Download each of the following (from the latest release http://downloads.openmicroscopy.org/bio-formats/) and place them in the ‘jars/bio-formats’ sub-folder:
    • jai_imageio.jar
    • formats-gpl.jar
    • ome-common.jar
    • turbojpeg.jar
    • ome-xml.jar
    • formats-bsd.jar
    • ome-poi.jar
    • specification.jar
    • mdbtools-java.jar
    • metakit.jar
    • formats-api.jar
  8. To Check Version of Bio-Formats Select Help > About Plugins > Bio-Formats Plugins... Check that the version of Bio-Formats matches the freshly downloaded version.
  9. Start Fiji and open any Image file using Plugins > Bio-Formats > Bio-Formats Importer

Note

It is vital to perform all of those steps in order; omitting even one will cause a problem. In particular, make sure that the old files are fully removed; it is not sufficient to add the new files to any sub-directory without removing the old files first.