Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
software:mipav_generatefusion [2016/06/23 20:40]
Jon Daniels [Tutorial] added dropbox link to sample data from Hari 		software:mipav_generatefusion [2019/04/20 00:36] (current)
Jon Daniels updated dropbox links
Line 1: Line 1:
 ====== MIPAV Generatefusion  ====== ====== MIPAV Generatefusion  ======
  
-MIPAV is a framework not unlike Fiji, and the generatefusion plugin was developed in collaboration with the Shroff lab.  It does intensity-based registration and joint deconvolution.  You can download MIPAV at [[http://mipav.cit.nih.gov/]] and then install the plugin.+MIPAV is a framework not unlike Fiji, and the generatefusion plugin was developed in collaboration with the Shroff lab.  It does intensity-based registration and joint deconvolution.  You can download MIPAV at [[http://mipav.cit.nih.gov/]] and then install the plugin.  As of early 2019 this is still the cannonical workflow for some groups, though the Shroff lab has been developing a successor software.
  
-In general this software is much slower and more computationally intensive that Fiji MVR.  However, it uses image-based registration so it can register datasets without distinct interest points.  (Image-based registration is in the future plans for MVR per [[http://imagej.1557.x6.nabble.com/3D-affine-transformation-Deskewing-with-anisotropic-voxels-td5013781.html|this thread]] but it is not implemented as of Jan 2016).+In general the MIPAV software is much slower and more computationally intensive that Fiji MVR.  However, it uses image-based registration so it can register datasets without distinct interest points.  (Image-based registration is in the future plans for MVR per [[http://imagej.1557.x6.nabble.com/3D-affine-transformation-Deskewing-with-anisotropic-voxels-td5013781.html|this thread]] but it is not implemented as of Aug 2018).
  
 MIPAV generatefusion is referenced in the 2014 Nature Protocols paper, though some things have changed since.   This is the place to look for updated information. MIPAV generatefusion is referenced in the 2014 Nature Protocols paper, though some things have changed since.   This is the place to look for updated information.
Line 13: Line 13:
 diSPIM image processing involves several steps, including background subtraction, cropping, transformation, fusion, and deconvolution. The first two steps in this process, background subtraction and cropping, are carried out in ImageJ or FIJI, while the remaining steps are carried out in MIPAV. diSPIM image processing involves several steps, including background subtraction, cropping, transformation, fusion, and deconvolution. The first two steps in this process, background subtraction and cropping, are carried out in ImageJ or FIJI, while the remaining steps are carried out in MIPAV.
  
-Sample data for this tutorial is at https://www.dropbox.com/sh/qua01k7v8bi9sge/AAB7ZLN2DN19GPL2lGQFh0nza?dl=0.+You can find [[https://www.dropbox.com/sh/lnhtg37d0hrdile/AABPu2O4wRIGYpKXOIX-Rusza?dl=0 | sample data for this tutorial]], already background-subtracted (-90 Y axis rotation).  There is also a [[https://www.dropbox.com/s/zszff7lelg3vgq6/NIHBeadData.7z?dl=0 | bead dataset]] of unknown origin that can be used to test your MIPAV workflow. 
  
 ==== File Organization ==== ==== File Organization ====
Line 19: Line 20:
 Before describing the image processing, a couple notes on file naming and organization are in order.  These apply to MIPAV only.  Instead of using image metadata, MIPAV uses the file naming and user-input parameters to figure out where each image belongs in the overall experiment. Before describing the image processing, a couple notes on file naming and organization are in order.  These apply to MIPAV only.  Instead of using image metadata, MIPAV uses the file naming and user-input parameters to figure out where each image belongs in the overall experiment.
  
-diSPIM images are originally written as image sequences (with each volume being equivalent to one image sequence). Image sequences are saved in individual folders, and need to be converted into a single .tiff stack for MIPAV to be able to read them. Typically we use bgX( where X is a number) to name the folder containing the background image sequence, and bvX (where X is a number) to name the folders containing the actually data.+diSPIM images are originally written as image sequences (with each volume being equivalent to one image sequence). Image sequences are saved in individual folders, and need to be converted into a single .tiff stack for MIPAV to be able to read them. Typically we use bgX (where X is a number) to name the folder containing the background image sequence, and bvX (where X is a number) to name the folders containing the actually data.
  
 The image sequences for each SPIM arm get their own separate folder. The naming of the SPIM arm folders depends on whether you are using Micro-Manager or Labview. For Labview-based systems, when facing the diSPIM the right-side camera is called SPIMB, and writes to a folder we name SPIMB_unprocessed, while the left. Micromanager uses an opposite camera naming system, so the right-side camera is named SPIMA and writes to a SPIMA_unprocessed folder, while the left-side camera is named SPIMB and writes to a SPIMB_unprocessed folder. Keep track of which naming system you are using as this can affect the rotations done in MIPAV.  (This convention can be changed in Micro-manager without too much difficulty, ask the developers ;-) ). The image sequences for each SPIM arm get their own separate folder. The naming of the SPIM arm folders depends on whether you are using Micro-Manager or Labview. For Labview-based systems, when facing the diSPIM the right-side camera is called SPIMB, and writes to a folder we name SPIMB_unprocessed, while the left. Micromanager uses an opposite camera naming system, so the right-side camera is named SPIMA and writes to a SPIMA_unprocessed folder, while the left-side camera is named SPIMB and writes to a SPIMB_unprocessed folder. Keep track of which naming system you are using as this can affect the rotations done in MIPAV.  (This convention can be changed in Micro-manager without too much difficulty, ask the developers ;-) ).

Trace: