EMU development is now happening directly in the official Micro-Manager repository.

What is EMU?

Micro-Manager controls the devices on your microscope using device properties (e.g. laser on/off). All device properties can be accessed through the device property browser. However, controlling the microscope through a long list of properties is cumbersome, slow and rather aimed at the microscope engineer than at the user. While interactions with device properties can be facilitated by using configuration preset groups or the quick access plugin, these cannot replace a user interface (UI) tailored to the microscope.

Tailored interfaces have the advantage of rendering the control of the microscope intuitive. However, tailoring the UI often means hard-coded references to the specific device properties of the microscope and a need to recompile it every time something changes on the microscope.

Easier Micro-manager User interface (EMU) offers means to make your Micro-Manager interface reconfigurable:

• Rapid design compatible with drag and drop softwares (e.g. Eclipse WindowBuilder).
• Functional Micro-Manager UI with only few lines of code thanks to EMU's back-end.
• Flexible and transferable: easy and intuitive configuration through EMU's interface.

Check out the EMU guide for a quick introduction, a user guide and a programming guide. Resources are linked at the bottom of this page.

How to install EMU?

EIn Micro-Manager 2.0, EMU is now available from the Plugin menu, under "User Interface".

If you wish to install it from the source code, then follow the next steps:

1. Download and install Micro-Manager 2-gamma.

2. Install git (for windows users: git bash, or for os mac users: source forge)

3. Download the Java SE Development Kit 8. Set the environment variable JAVA_HOME to the JDK 1.8 folder path (windows).

4. Download and install Maven.

5. Using the git console, go to the folder you wish to install EMU in and type (omitting the $):

   $ git clone https://github.com/jdeschamps/EMU.git

6. Navigate to the EMU folder and compile it using the path to Micro-manager:

   Windows (git bash)

   $ cd emu
   $ ./compileAndDeploy-Win.sh "C:\Program\Path\to\MicroManager2gamma"

   macOs

   $ cd emu
   $ sh compileAndDeploy-Mac.sh /Application/Path/to/MicroManager2gamma/

   Note: the script requires bash, which is shipped with the git console on Windows.

   Note: the EMU .jar shipped with Micro-Manager will be overwritten (it is located in the /mmplugins/ folder).

7. Install an EMU plugin by placing the plugin compiled .jar file in "C:\Program\Path\to\MicroManager2gamma\EMU" or use the default plugins.

Note: For macOs users, few manual steps might be required to start Micro-manager.

Cite us

Deschamps, J., Ries, J. EMU: reconfigurable graphical user interfaces for Micro-Manager. BMC Bioinformatics 21, 456 (2020). doi.org/10.1186/s12859-020-03727-8

EMU plugins and resources

Guide

The EMU guide offers both a description of EMU menus for users and a programming guide for implementing your own EMU plugin.

Examples

EMU plugin examples: these projects include an empty base project, a simple UI for controlling lasers and a filterwheel, an interface for a commercial laser and the example plugin from the publication.

Tutorial

Tutorial for Eclipse Windows Builder: a detailed walk through on how to easily assemble an EMU user interface using drag and drop software.

htSMLM

The Ries lab is using its own advanced EMU plugin to control automated localization microscopes: htSMLM.

Javadoc

The javadoc is available here.

Contact

If you have any question regarding EMU, or want to develop your own EMU plugin, post it on image.sc and tag @jdeschamps.