Merge pull request #142 from nicost/mist

Mist plugin page, first version.
micro-manager · May 7, 2024 · c32b1a3 · c32b1a3
2 parents 0d47352 + 6597fc8
commit c32b1a3
Show file tree

Hide file tree

Showing 7 changed files with 125 additions and 0 deletions.
diff --git a/_pages/MistData.md b/_pages/MistData.md
@@ -0,0 +1,124 @@
+---
+autogenerated: false 
+title: Stitching Micro-Manager data using the Fiji Mist plugin
+layout: page
+---
+
+
+
+<table>
+
+<tr>
+
+<td markdown="1">
+
+**Summary:**
+
+</td>
+
+<td markdown="1">
+
+Use the Fiji Mist plugin to stitch one time point or location and use 
+its output to stitch large datasets.
+
+</td>
+
+</tr>
+
+<tr>
+
+<td markdown="1">
+
+**Authors:**
+
+</td>
+
+<td markdown="1">
+
+Nico Stuurman
+
+</td>
+
+</tr>
+
+<tr>
+
+<td markdown="1">
+
+**License:**
+
+</td>
+
+<td markdown="1">
+
+BSD
+
+</td>
+
+</tr>
+
+<tr>
+
+<td markdown="1">
+
+**Platforms:**
+
+</td>
+
+<td markdown="1">
+
+All supported platforms
+
+</td>
+
+</tr>
+
+
+</table>
+
+## WorkFlow
+
+### Use the Mist plugin in Fiji
+
+The [Microscopy Image Stitching Tool](https://pages.nist.gov/MIST/) is a wonderful Fiji plugin to stitch images based on image content.  
+
+Install it in Fiji using the Fiji updater tool.
+
+To acquire data in Micro-Manager that can be stitched, either use the HCS Site Generator plugin or the Grid Creator in the PositionList to acquire images with about 10% overlap, 
+
+If you would like to have a large (many time points and/or many positions) stitched, first save a a single time point and only the positions that you want stitched in Micro-Manager as Image Stack file.  Under the gear icon of the viewer, select "Duplicate",  Select a single z plane, the number of positions that is in one large field of view (so, if your grid was 8 x 8 images, sleect 64 positions), a single channel and a single time point.
+
+![](/media/Duplicate_Mist.PNG)
+
+Saved data (sorted by type) will look like this:
+
+![](/media/Mist_Files.PNG)
+
+Now open the Mist plugin in Fiji (Plugins > Stitching > Mist).  
+
+![](media/Mist_Input.PNG)
+
+Set "Filename Pattern Type" to "Sequential (that is how Micro-Manager numbers files), Starting point depends on camera rotation, it is nice if your camera is oriented such that you can set the Starting Point to "Upper Left".  Direction: HCS Site Generator "Snake" corresponds to "Horizontal Continuous", TypeWriter to "Horizontal Combing".  Set the Grid Width and Hieiht to the number of images that you have in rows and columns.  
+
+The Filename Pattern is important.  Copy one of the file names from your list (do not forget to include the .tif at the end), and replace the Site number with "{p}" (the Mist plugin uses that as a plcae holder for the expected Site number).  In the Output tab, you tell the Mist plugin where to store its results.  You can check your settings with the Preview button.  Make sure that the resulting image makes sense, then click "Begin Stitching". 
+
+Output (in the directory specified in the "Output" panel, should look like this:
+
+
+![](media/Mist_Output.PNG)
+
+
+The file "img-global-positions-0" will be used by the Micro-Manager mist plugin to stitch the remainder of your data.
+
+In Micro-Manager, open the data you want to stitch (most likely this is a large data set, so use "Open > Virtual"). Click on the Gear icon in the viewer and sleect "Analysis > Stitching using the Mist plugin".   
+
+![](media/Mist_MM.PNG)
+
+
+Make sure that "Mist file:" points to the file "img-global-position-0" thta you just created.  Select the channel, z slice, and time points that you want to stitch, select an output format ("Separate Image Files" is a good option here, since it is most compatible with other software), and set where you would like to sabe the output.  Click "Assemble".  For large datasets, it can take a long time to stitch...
+
+
+Happy stitching, and thank to the team at the NIST that build the  MIST plugin.
+
+
+Nico Stuurman, April 2024
diff --git a/_pages/Version_2.0_Plugins.md b/_pages/Version_2.0_Plugins.md
@@ -24,6 +24,7 @@ applications in microscopy:
 -   [Localization Microscopy](Localization_Microscopy)
 -   [MicroMagellan](MicroMagellan)
 -   [Mightex Polygon](Mightex_Polygon_Plugin)
+-   [Mist Stitching](MistData)
 -   Multi-Andor Control
 -   [MultiChannelShading](MultiChannelShading)
 -   [Point and Shoot Analysis](Point_and_Shoot_Analysis)

diff --git a/media/Duplicate_Mist.PNG b/media/Duplicate_Mist.PNG
diff --git a/media/Mist_Files.PNG b/media/Mist_Files.PNG
diff --git a/media/Mist_Input.PNG b/media/Mist_Input.PNG
diff --git a/media/Mist_MM.PNG b/media/Mist_MM.PNG
diff --git a/media/Mist_Output.PNG b/media/Mist_Output.PNG