Documentation

The Mars platform provides a collection of Fiji/ImageJ2 commands for performing a wide variety of common image processing and analysis tasks. This page provides documentation of the ImageJ2 commands and the graphical user interface for molecule classification.

To start learning how to use Mars, we recommend first working through the introductory Let’s Make a Molecule Archive and exploring the examples, and videos on the Mars YouTube channel, then dig further into the documentation.

Script writers and java developers can get started using the Mars development tutorial. Complete javadoc for the mars-core API can be found here. Mars naming conventions can be found here.

Data Requirements

Supported Image Formats

Mars stores image metadata using an enhanced version of the Open Microscopy Environment (OME) format. This format provides a universal nomenclature for the storage of 6D images (X, Y, Z, C, T at multiple positions) collected in biological microscopy experiments. More information on the format and further requirements can be found in the OME section. Mars image processing commands work best with images opened using SCIFIO that provides translators to OME format. SCIFIO can be activated in ImageJ or Fiji under Edit>Options>ImageJ2… Once activated, File>Open will use SCIFIO by default. An enhanced SCIFIO reader (mars-scifio) compatible with data collected using MicroManager 1.4 and 2.0 is available through the mars update site.

Mars image processing commands will also work with ordinary videos opened in ImageJ using other methods, such as the BioFormats plugin. However, in this case, metadata is generated using best guesses and may be less accurate. The Mars image processing commands assume that different excitation wavelengths and filter combinations are stored in different channels. We appreciate that many labs in the single-molecule community develop their own custom microscopes and collection formats. If excitation wavelength or emission filters are changed between frames and not stored in different channels, these videos will need to be converted. In most cases, the built-in tools in Fiji can handle this conversion process. For example:

  • If each excitation wavelength was collected as a separate video, these can all be opened and combined as different channels using the Image>Color>Merge Channels… command.

  • If alternating frames were captured using different excitation wavelengths, the Image>Stacks>Tools>Deinterleave can be used to split the sequence into two videos and the Merge Channels… command can then be used to recombine as two different channels.

  • If the setup has two cameras for different emission wavelengths collected at the same time, the individual videos can be combined into single larger images using the Image>Stacks>Tools>Combine command and the Molecule Integrator (multiview) command could be used for combined integration.

These are just a couple examples of the many possibilities for conversion available using the Image>Stacks>Tools and Image>Color menus. Custom scripts might be required for more complex situations. As an example, we have written a conversion script for the videos in the static FRET example workflow.

We are eager to help make sure Mars supports other image formats that we have not yet encountered in our own work and happy to help write conversion scripts to make Mars more accessible. Please get in touch by making a post on the ImageJ forum with the mars tag and/or mention @karlduderstadt to make sure we are notified.

Command Reference

Image

Peak Finder Counting and subpixel localization of molecules.
DNA finder Find and fit linear DNA molecules
Peak Tracker Find, subpixel localize, and track molecules.
Object Tracker Fit and track unspecified objects based on segmentation.
Molecule Integrator Integrate the fluorescence of molecules.
Molecule Integrator (multiview) Integrate the fluorescence of molecules in a multiview setup.

Image > Util

Beam Profile Corrector Correct images for non-uniform beam profile.
Gradient Calculator Calculate the vertical gradient for images.
Overlay Channels Combine different colors into one image set.

Molecule

Open archive Use this command to open an archive.
Open virtual store Use this command to open a virtually stored archive.
Build archive from table Generate a Molecule Archive using a table with a molecule index column.
Build DNA archive Builds a DNA Archive from a SingleMoleculeArchive and a list of DNA ROIs
Merge Archives Merges a set of Molecule Archives.
Merge Virtual Stores Merges a set of virtual Molecule Archives.

Molecule > Util

Add time Retrieve and add time information from metadata.
Drift Corrector Correct the molecule coordinates for sample drift during the measurement.
Region Difference Calculator Add parameter for difference between two regions.
Variance Calculator Add variance parameter for molecules.

Table

Open table Load csv or yamt format tables.
Sort Sort table rows by column values.
Filter Filter table rows.

Table > Import

Import IJ1 Table Convert a table in the IJ1 format (f.e. ResultsTable) to a MarsTable
Import TableDisplay Convert a table in the SciJava format (f.e. TableDisplay) to a Marstable

Kinetic Change Point Analysis (KCP)

Change Point Finder Find kinetic changes points for a Molecule Archive.
Single Change Point Finder Find single change point positions.
Sigma Calculator Estimate background sigma level during optimization of change point detection.

Transform ROIs

Transform ROIs Transform PointRois using an Affine2D transform.

Import

LUMICKS h5 Open Lumicks h5 optical tweezers datasets.
Single-molecule dataset (SMD) Open json Single-molecule dataset (SMD) datasets.

Mars Rover

Accompanying the Mars software is the GUI: Mars Rover. This user interface helps to analyse, process, and filter the data in a streamlined and reproducible manner. To familiarise yourself with the most commonly used features explore the Let’s Make a Molecule Archive tutorial.

Toolbar Tabs

Toolbar Save, edit and delete.
Rover dashboard Main features of the dataset and scriptable widgets.
Experiments Metadata and data analysis log.
Molecules UIDs with data tables and plot options.
Comments Build-in text editor to annotate data sets.
Settings Archive specific settings.

For an extensive overview of the scriptable widgets visit the scriptable widgets page.