/imagej

:sparkler: Open scientific N-dimensional image processing :microscope:

Primary LanguageJavaOtherNOASSERTION

Image.sc Forum Join the chat at https://gitter.im/imagej/imagej Open in Gitpod

This is the repository for ImageJ2, a rewrite of the original ImageJ for multidimensional image data, with a focus on scientific imaging. Its central goal is to broaden the paradigm of ImageJ beyond the limitations of the original ImageJ application, to support the next generation of multidimensional scientific imaging.

To ensure backwards compatibility, ImageJ2 has been designed to fully integrate into the original ImageJ user interface. This allows users to keep using ImageJ in familiar ways, while providing the ability to migrate toward more powerful new features as needed.

Under the hood, ImageJ2 completely isolates the image processing logic from the graphical user interface (UI), allowing ImageJ2 commands to be used in many contexts, including headless in the cloud or on a server such as OMERO, or from within another application such as KNIME, Icy or CellProfiler (a Python application).

ImageJ2 has an N-dimensional data model driven by the powerful ImgLib2 library, which supports image data expressed in an extensible set of numeric and non-numeric types, and accessed from an extensible set of data sources. ImageJ2 is driven by a state-of-the-art, collaborative development process, including version control, unit testing, automated builds via a continuous integration system, a bug tracker and more.

We are collaborating closely with related projects including Fiji, SCIFIO and OME, and are striving to deliver a coherent software stack reusable throughout the life sciences community and beyond. For more details, see the SciJava web site.

For more details on the project, see the ImageJ wiki.

LICENSING

ImageJ2 is distributed under a Simplified BSD License; for the full text of the license, see LICENSE.txt.

IMAGEJ2 AS A LIBRARY

From Java

This repository is the main ImageJ2 application, which brings together all of ImageJ2 under the artifact net.imagej:imagej. It is the easiest entry point if you are looking to use ImageJ2 as a library from your own software. E.g., in your Maven pom.xml:

<parent>
  <groupId>org.scijava</groupId>
  <artifactId>pom-scijava</artifactId>
  <version>30.0.0</version>
</parent>
...
<dependency>
  <groupId>net.imagej</groupId>
  <artifactId>imagej</artifactId>
</dependency>

We recommend inheriting from the pom-scijava parent, although it is not required. (If you do not, you will need to include the <version> of ImageJ2 in your <dependency> declaration.)

From other languages

  • JavaScript: Use the imagej module on npm to call ImageJ2 in-process from node.js code.
  • Python: Use the PyImageJ module on PyPi to call ImageJ2 in-process or interprocess from Python code.
  • Ruby, R, LLVM and beyond: Use GraalVM to combine ImageJ2 with Truffle-based languages in the same VM, with shared objects and memory on a single VM heap.
  • Interprocess: Use the ImageJ Server to work with ImageJ2 via a RESTful web services API, between processes on the same machine, or between multiple machines.

DEPENDENCIES

This component depends on other, lower level components, each of which lives in its own repository:

It also includes various "plugin" components at runtime:

See the pom.xml for a complete list of dependencies.

BUGS

For a list of known issues, see the GitHub issues.

Please report any bugs by following the instructions online.