Replisome Analysis : ImageJ plugin for the analysis of DNA replication dynamics in bacteria
Welcome to the Replisome Analysis Plugin
This ImageJ plugin is intended to provide an automated analysis of DNA replication dynamics in bacteria.
Intended Use
This plugin works for 2D+t images of bacteria, specifically via differential interference contrast (DIC) microscopy for the bacterial bodies, and a fluorescent channel. The plugin is designed to analyze the dynamics of DNA replication in bacteria, specifically the movement of the replisome.
Example of the bacteria in the DIC channel
Bacteria are assigned to colonies using the DIC channel, and GFP-tagged DNaN in the second channel is used to track the replisome. The plugin can be used to track the movement of the replisome.
Example of the bacteria in the GFP channel
Various plots and statistics can then be generated from the data.
Hardware requirements
The plugin is designed to work with 2D+t images of bacteria. Due to the size of the images, a computer with at least 8GB of RAM is recommended; 16GB is preferred.
Installation
Note
- Please note that due to the hardware available to us, this plugin has only been tested on Windows.
- Please contact us if you encounter any issues on other operating systems.
- On Windows, make sure to have Fiji installed in the root of your drive (e.g.
C:\Fiji.app).
Dependencies
First, install the following dependencies manually :
Note
All the .jar dependencies must go in the jars/ folder of your Fiji installation.
This is not the same as the plugins/jars folder.
- cilj2 : due to the GPU acceleration provided by clij, it is safer to install it from source to ensure there are no drivers issues. Follow this link to install clij2 in Fiji.
- commons-csv : download the 1.8 version from here and place the .jar in the
jars/folder of your ImageJ installation. - xchart : download the 3.8.8 version here and place the .jar in the
jars/folder of your ImageJ installation.
Warning
Make sure to install the dependencies before installing the plugin, with the correct versions.
The plugin may not work if you use the latest version of commons-csv.
Also ensure Fiji is installed in the root of your drive (e.g. C:\Fiji.app).
If you already have XChart installed, make sure to use the correct version. Avoid duplicates in the jars/ folder.
Install from .jar file
To install the plugin, take the provided .jar file in GitHub Packages and place it in the plugins folder of your ImageJ installation.
The plugin will then be available in the ImageJ menu under Plugins > Replisome Analysis.
Usage
For information on how to use the plugin, see the Plugin Usage page.
Troubleshooting
Out of memory issues
The most common issue with the plugin is running out of memory. If you encounter this issue, you can increase the memory available to ImageJ, or try running the workflows separately.
Warning
Memory issues: If you consistently run out of memory, you may want to adjust the memory setting in ImageJ. Go to Edit>Options>Memory & Threads and adjust the memory settings as needed, using no more than 75% of your available RAM. See this page for more information.
See the Plugin Usage page for more information on running the plugin.
Class not found issues
If you do not install clij2 manually, you may face some ClassNotFound issues. To solve this, install clij2 manually and restart ImageJ. Additionally, make sure all the dependencies are correctly installed.
GUI window too big
If, when launching the plugin, the GUI window is too big (this can happen on a 13 inches screen), and you cannot see the path browser or the OK button,
decrease the GUI scale to ~ 0.7 and change the Menu font size to 18 points in Edit > Options > Appearance...
This will allow you to see the full window and use the plugin.
Data availability
OMERO
The plugin is designed to work with 2D+t images of bacteria. This version is intended to run only on the data available on OMERO.
Used images
The images used in this plugin are :
- Merged-1.tif
- Merged-2.tif
- Merged-3.tif
Specifications:
- 2D + time, with 1s frame interval
- 60x 1.4 NA oil objective, 103 um/pixel
- 2 channels :
- Channel 1 : Phase contrast (DIC), Bacteria morphology
- Channel 2 : Fluorescence, replisome foci (sfGFP Fluorescent protein)