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.