StrobeLight Plugin

A slightly more detailed description of the plugin can be found here

Installation

If you are starting with a stock version of Micromanager, you will need to install both the modified dc1394 adapter and the java plugin. All files can be found in /Volumes/JData/JPeople/Common/CommonCode/StrobeLightFiles. You can download them temporarily and put them anywhere you want, but for the following instructions to make sense, just copy the whole StrobeLightFiles folder to your desktop. You will be able to delete it after installation.

Modified dc1394 adapter

The dc1394 adapter is written in C++, and may need to be recompiled for your computer. In the ~/Desktop/StrobeLightFiles folder you should see ./micromanager1.3, ./dc1394, and ./DeviceAdapters. The last two are copies, since the /dc1394 is contained in /DeviceAdapters, which is contained in /micromanager1.3. For this description, I will work with the full source in ./micromanager1.3.

First, make sure you have a sensible source directory. I use ~/src:

$ mkdir ~/src 

if it doesn't exist.

Then copy the source code there:

$ cp -r ~/Desktop/StrobeLightFiles/micromanager1.3 ~/src

You might need to navigate to the DeviceAdapters (or even the micromanager1.3) folder and configure it

$ cd ~/src/StrobeLightFiles/micromanager1.3/DeviceAdapters
$ ./configure --without-imagej

You can try to tell the config where your ImageJ is, but it doesn't matter since you're not trying to build the whole thing. Just get the adapter to compile. So go to the dc1394 folder, clean it and build it:

$ cd ~/src/StrobeLightFiles/micromanager1.3/DeviceAdapters/dc1394
$ make clean
$ make

You should now have a bunch of files and directories. Check to see that you have a .libs directory:

$ ls -al

Should produce something like:

drwxr-xr-x  14 ahodge  staff     476 15 Oct 16:59 .
drwxr-xr-x  80 ahodge  staff    2720 15 Oct 16:55 ..
-rw-r--r--@  1 ahodge  staff    6148 12 Jun 15:34 .DS_Store
drwxr-xr-x   3 ahodge  staff     102 15 Oct 16:58 .deps
drwxr-xr-x   9 ahodge  staff     306 15 Oct 16:59 .libs
-rw-r--r--   1 ahodge  staff   18056 15 Oct 16:53 Makefile
-rw-r--r--   1 ahodge  staff     444 12 Jun 15:03 Makefile.am
-rw-r--r--   1 ahodge  staff   17446 12 Jun 16:13 Makefile.in
-rw-r--r--@  1 ahodge  staff   70388 15 Sep 15:30 dc1394.cpp
-rw-r--r--@  1 ahodge  staff    8655 29 Jul 16:52 dc1394.h
-rw-r--r--   1 ahodge  staff     897 15 Oct 16:59 dc1394.la
-rw-r--r--   1 ahodge  staff     272 15 Oct 16:58 dc1394.lo
-rw-r--r--   1 ahodge  staff  610636 15 Oct 16:58 dc1394.o
-rw-r--r--@  1 ahodge  staff    1543 12 Jun 15:03 license.txt
mac1041-10:dc1394 ahodge$ 

Have a look in the .libs directory and see that you have something like:

drwxr-xr-x   9 ahodge  staff      306 15 Oct 16:59 .
drwxr-xr-x  14 ahodge  staff      476 15 Oct 16:59 ..
-rwxr-xr-x   1 ahodge  staff   369392 15 Oct 16:59 dc1394.0.so
drwxr-xr-x   3 ahodge  staff      102 15 Oct 16:59 dc1394.0.so.dSYM
-rw-r--r--   1 ahodge  staff  2007712 15 Oct 16:59 dc1394.a
lrwxr-xr-x   1 ahodge  staff       12 15 Oct 16:59 dc1394.la -> ../dc1394.la
-rw-r--r--   1 ahodge  staff      898 15 Oct 16:59 dc1394.lai
-rw-r--r--   1 ahodge  staff   610636 15 Oct 16:58 dc1394.o
lrwxr-xr-x   1 ahodge  staff       11 15 Oct 16:59 dc1394.so -> dc1394.0.so
mac1041-10:.libs ahodge$ 

Finally, back-up your stock adapter and link to the new one:

$ cd /Applications/MicroManager
$ mv libmmgr_dal_dc1394 libmmgr_dal_dc1394ORIGINAL
$ ln -s ~/src/StrobeLightFiles/micromanager1.3/DeviceAdapters/dc1394/.libs/dc1394.so

Run Micromanager with a dc1394 camera to make sure everything is OK.

*Note After all that work, the .so file is all you really need. If HD space is an issue, and you don't plan to change it ever again you can copy it somewhere safe and delete the micromanager1.3 directory from ~/src. Just change the link accordingly.

Java Plugin

This plugin works from the ImageJ plugins directory rather than the Micromanager one. There is a new way to use it as a Micromanager plugion directly, which would be better, but for now I'm leaving it this way. Installing it is just a matter of copying the files to the appropriate directories. You'll need the class files, jar, and a swingx jar all together:

$ cp -rp  ~/src/StrobeLightFiles/MicroManagerPlugin/StrobePlugin /Applications/Micro-Manager1.3/plugins
$ cp -rp  ~/src/StrobeLightFiles/MicroManagerPlugin/StrobePlugin.jar /Applications/Micro-Manager1.3/plugins
$ cp -rp  ~/src/StrobeLightFiles/MicroManagerPlugin/swingx-1.0.jar /Applications/Micro-Manager1.3/plugins

or do it using the finder window.

Operation

To run the plugin, first make sure you have a Point Grey dc1394 camera installed on the rig. Presumably the plugin will work for other cameras with the same features, but I can't say for sure.

  1. Launch Micromanager
  2. Click on the ImageJ window that appears (to make sure you get the ImageJ menu bar instead of the Micromanager one):
  3. Select Plugins>StrobePlugin>StrobeLight from the menu (Note: If the Micromanager GUI is the active window, you will see a “Plugins” item in the menu bar, but it will not give you access to the StrobeLight plugin.)
  4. Set the properties as desired in the GUI:
  5. Once your properties are set, click “View Live” to start.
  6. While running, the “view Live” button will toggle to “Stop.” If clicked, the images will remain, and a new group of video windows will be created when you resume streaming.

Log In