# 2012-04-09 - ImageJ v2.0.0-beta1

Today, the ImageJDev team is proud to release the first beta of ImageJ2, version 2.0.0-beta1!

ImageJ 2.0.0-beta1 is a “beta”-quality release, meaning the code is not finished. The design is more stable than before but still subject to change until the final 2.0.0 release. It is recommended that people continue to use ImageJ v1.x for critical work.

The ImageJ2 user interface is modeled after ImageJ v1.x as much as possible. However, under the hood, ImageJ2 is a complete redesign of ImageJ. It provides backward compatibility with older versions of ImageJ by bundling the latest v1.x code and translating between “legacy” and “modern” image structures.

## Feature overview

The beta still has many bugs and limitations, but we have achieved several substantial milestones:

• Support for most ImageJ1 plugins and macros
• Many new pixel types (thanks to ImgLib2)
• Multidimensional data beyond 5D (thanks to ImgLib2)
• Import and export of all SCIFIO-supported file formats
• Improved region of interest (ROI) tools
• Truly headless: image processing is separate from user interface
• Easily install additional plugins, including Fiji (over 350 plugins!)
• 175 new and/or reimplemented core ImageJ2 plugins so far
• 125+ bugs fixed

## Known bugs

Many legacy ImageJ plugins and macros work; many others do not. There are still many bugs to be fixed—see the complete list on the ImageJ Trac for full details.

In addition, there are a few issues specifically regarding 2.0.0-beta1:

• On Windows & Linux, you must have Java already installed; ImageJ2 is not bundled with Java, nor will it download it for you.
• On Mac OS X 10.5 Leopard, there is a bug that prevents ImageJ2 from launching successfully. This bug will be fixed in the next beta release, and is already fixed in the development version.
• On Windows, when ImageJ2 first starts, a console message (“Falling back to system Java”) appears, which is merely informative and is safe to ignore. This message will no longer be displayed in the next beta release, and is already fixed in the development version.

## What’s new in the beta

We described the ImageJ2 software design in a previous blog post, which covers both application features (for users) and API design (for developers). Everything discussed there is still true for 2.0.0-beta1. But the first beta also sports several crucial new additions:

### ImageJ Updater

The ImageJ Updater, accessible from the HelpUpdate… command in the menus, is the central mechanism by which users can install new plugins into ImageJ2, as well as keep installed plugins up-to-date. It was adapted and improved from the Fiji Updater, which serves a similar function for the currently available version of Fiji.

From this point forward, we will be deploying future releases of ImageJ2 via the Updater, which means you will not need to manually download or install new application bundles from the web site. Rather, when version 2.0.0-beta2 and beyond are released, running the ImageJ Updater will upgrade your installation to the new version.

Moreover, the utility of the ImageJ Updater is not limited to upgrading ImageJ itself and its built-in plugins. ImageJ2 allows you to access additional update servers, each serving their own collection of plugins. Anyone can create an update site and upload their own plugins to it, making them easily available to the entire ImageJ community. With this mechanism, it is a breeze for plugin authors to publish updates to their plugins, which users of those plugins will receive automatically via the Updater. For further details, see How to set up and populate an update site on the Fiji wiki.

### Installing Fiji plugins

The structure of an ImageJ2 update site is identical to that of a Fiji update site. So if you have already set up an update site accessible via the Fiji Updater, your site will already work out of the box in ImageJ2 as well. And thanks to ImageJ2’s legacy layer allowing execution of legacy ImageJ1 plugins and macros, many or all of the plugins available from your update site will continue to work!

You can install the entire Fiji plugins collection into ImageJ2, by adding the Fiji update site. Choose HelpUpdate… from the menu, click Advanced Mode, Manage update sites, then Add, type Fiji for the name, and for the update site URL, enter:

https://fiji.sc/update/

Once you have installed the Fiji plugins and restarted ImageJ2, they will be available for use. For example, on the left, we see the T1 Head sample image visualized in 3D using Fiji’s 3D Viewer.

There are over 350 plugins that are part of the Fiji distribution, and being able to bring them all into ImageJ2 is a huge step toward full backward compatibility with ImageJ1. Of course, we have not had time to exhaustively test all these plugins, but many should work, and we welcome bug reports regarding those that do not.

Another example can be seen on the right: the Bio-Formats Importer plugin was used to import a file in Applied Precision DeltaVision DV format. The data is displayed in composite color mode with OME-XML metadata visible in its own window.

It is possible to install additional plugins from third party Fiji update sites as well. For example, on the left, we see the VisBio Ortho Stack plugin, installed in ImageJ2 from the LOCI Fiji update site, visualizing part of the MRI Stack sample dataset.

### ImageJ Launcher

Another very useful part of Fiji is the Fiji Launcher, the native executable for invoking Java to launch ImageJ. While ImageJ1’s launcher has improved throughout the years, and has some useful features, the Fiji Launcher has many more. Similar to the ImageJ2 Updater, the new ImageJ2 Launcher adapts and improves the Fiji Launcher, making it part of the core ImageJ2 distribution.

On the right, the executables corresponding to ImageJ2’s target platforms are shown. ImageJ-win64.exe and ImageJ-win32.exe are launchers for ImageJ2 on Windows in 32-bit and 64-bit modes, respectively. Similarly, ImageJ-linux64 and ImageJ-linux32 are the corresponding launchers for Linux. ImageJ-macosx is the Mac OS X launcher for 32- or 64-bit Intel systems, while ImageJ-tiger is the launcher for Mac OS X 32-bit universal binary (Intel or PPC).

On Mac OS X, double-clicking on the ImageJ2 icon launches ImageJ-tiger, which checks your system specifications. If your system is compatible with the newer ImageJ-macosx launcher, it is invoked automatically; otherwise, ImageJ-tiger invokes Java directly. In the future, we may combine the two Windows and Linux launchers in a similar way, but for now it is simpler to provide separate executables so that users may easily and explicitly choose which version of Java to use.

This approach also allows ImageJ2 to be distributed as a single application bundle, rather than needing to download a different archive depending on which operating system you are running. You can even host ImageJ2 on a shared network drive accessible from multiple different operating systems, all from the same base installation, since ImageJ2 stores its settings in each user folder rather than attempting to write to its own base directory (which often fails due to security considerations).

### Better image I/O

ImageJ2 uses the SCIFIO (SCientific Image Format Input/Output) library, the core of Bio-Formats, for reading and writing image files on disk. Doing so provides a uniform, extensible solution to image I/O, as well as a defined way to add support for new file formats that work not just in ImageJ2, but in any software package that uses SCIFIO and/or Bio-Formats.

In tandem with the ImageJ 2.0.0-beta1 release, we are releasing a new alpha version of SLIM Plugin, a plugin for time-domain analysis of spectral lifetime data. It is currently available for Fiji and ImageJ2 as part of the LOCI Fiji plugins.

This initial release is alpha quality and should not be used for serious work. It has been written for ImageJ1, and does not currently work in ImageJ2; however, future releases will be written specifically for ImageJ2.

At the most recent Fiji/ImageJ2 hackathon we focused on interoperability between ImageJ2 and several other software packages, including KNIME, Icy and OMERO. Because ImageJ2 completely isolates image processing logic from user interface, each of these projects can provide robust support for invoking ImageJ2 plugins.

• CellProfiler - Includes support for executing ImageJ2 plugins as part of a pipeline. CellProfiler builds a user interface to harvest plugin input parameters the same way it does for its native modules, then passes the information to ImageJ2 for execution. Results are converted back into CellProfiler data structures once the plugin finishes running.
• KNIME - The KNIME Image Processing nodes add support for image processing within KNIME, including N-dimensional image processing using ImgLib2, as well as initial support for running ImageJ2 plugins as part of a KNIME workflow.
• OMERO - Experimental support for executing ImageJ2 plugins from within OMERO.insight (client-side), as well as initial steps toward execution within OMERO.server (server-side).

### Maven artifacts

We have released all components of ImageJ2 and ImgLib2 as Maven artifacts, available from the ImageJ Maven repository. The groupId for ImageJ2 is “net.imagej” and it is “net.imglib2” for ImgLib2.

For more about the Maven artifacts associated with the release, see this technical note.

You may have noticed the new microscope logo for ImageJ2. This image is not the final logo. The plan is to solicit community submissions for a logo, then vote on the mailing list to decide. The current logo is a placeholder image being used during the beta phase of development.

For more details on the logo including source and design credits, see this readme.