Fixing toolbox name Neural_Network_Toolbox -> Deep_Learning_Toolbox.

Internal/checkToolboxes.m

@@ -57,4 +57,4 @@
     disp ('Please install the global optimization toolbox');
 end
 
-end
+end

Internal/intCheckForInstallLib.m

@@ -3,13 +3,15 @@
 boxes = {'Curve Fitting Toolbox',...                                
 'Global Optimization Toolbox',...                           
 'Image Processing Toolbox', ...                             
-'Neural Network Toolbox',...                                
+'Deep Learning Toolbox',...                                
 'Optimization Toolbox',...                                  
 'Parallel Computing Toolbox',...                            
 'Statistics and Machine Learning Toolbox'};
 
 tmp = ver;
 
+disp(struct2table(ver));
+
 
 for ii = 1:numel(boxes)
 found = strfind({tmp.Name}, boxes{ii} );

README.md

@@ -0,0 +1,139 @@
+# SUPERSEGGER
+
+SuperSegger is a completely automated MATLAB-based trainable image cell
+segmentation, fluorescence quantification and analysis suite written by
+the Wiggins lab. It is particularly well suited for high-throughput time
+lapse fluorescence microscopy of in vivo bacterial cells.
+
+SuperSegger is free software: you can redistribute it and/or modify it
+under the terms of the GNU General Public License as published by the
+Free Software Foundation, either version 3 of the License, or (at your
+option) any later version.
+
+For more information about the software please visit the website
+<http://mtshasta.phys.washington.edu/>
+
+A protocol with directions on how to use the software suite can be found
+on the website.
+
+Some basic information here to get you started with :
+
+## Setting the Path
+
+In order for Matlab to be able to find the different pieces of the code
+the SuperSegger folder needs to be in your path. In the Home tab, in the
+Environment section, click Set Path. The Set Path dialog box appears.
+Click add folder with subfolders and add the SuperSegger folder.
+
+## Software Requirements 
+
+In order to use SuperSegger you need to have the MATLAB software with
+the following toolboxes: Image Processing Toolbox Neural Network Toolbox
+a.k.a. Deep Learning Toolbox Statistics and Machine Learning Toolbox
+Global Optimization Toolbox Parallel Computing Toolbox (not necessary)
+
+A Warning about missing toolboxes will be issued if any of the above is
+not found while running SuperSegger. First make sure the above toolboxes
+are installed ( use the AddOn Manager in matlab in the \"Home\" tab.).
+If all toolboxes are installed but you still get these warnings, make
+sure that the filesystem paths where the toolboxes are installed are
+listed under \"Set Path\" in the matlab GUI.
+
+## Software Availability and Documentation
+The website for the software
+can be found at
+<http://mtshasta.phys.washington.edu/website/SuperSegger.php> and the
+software code can be downloaded at the GitHub repository
+<https://github.com/wiggins-lab/SuperSegger/>. The GitHub wiki contains
+tutorials on how to use the software, information about the fields of
+the output, and a general overview of the methods
+<https://github.com/wiggins-lab/SuperSegger/wiki>. In the wiki, the
+Segmenting your images section has a tutorial on how to start image
+segmentation. The SuperSeggerViewer section explains the post processing
+and image visualization tools of SuperSeggerViewerGui. The Output
+section contains all the field definitions of the clist, cell files and
+frame files. For more information on the code, all available methods and
+their dependencies can be found at
+<http://mtshasta.phys.washington.edu/website/superSegger/>.
+
+## Main functions you may need
+The wiki
+(https://github.com/wiggins-lab/SuperSegger/wiki) contains full
+tutorials on how to segment your images and use the tools available. We
+include here the main functions you may need. To start using them type
+in the command line the name of the functions found inside the \'\'.
+
+GUIs : \'superSeggerGui\' : Segments and processes your images. Select
+the folder you want to segment, the parameters of segmentation and click
+\'Start SuperSegger\'. \'superSeggerViewerGui\' : Results of
+segmentation and analysis tools. \'trainingGui\' : Training your own
+segmentation parameters. \'gateToolGui\' : Gui for gating and plotting
+functionalities of clists.
+
+Non - GUI : \'ProcessExp\' : Set your parameters and run
+BatchSuperSeggerOpti. (You can use this instead of superSeggerGui)
+\'gateTool\' : Gating and plotting functionalities for the clist. (Same
+as gateToolGui with more functionality)
+
+You can download a sample dataset and a bootcamp folder from our website
+to try the software.
+
+## Segmentation Parameters 
+Some information about
+the parameters currently provided with the software : 100XEc : Trained
+on E.coli, 60nm/pix . 100XPa : Trained on P.aeruginosa, 60nm/pix.
+60XEcAB1157 : Trained on E.coli AB1157 on M9 pads, 100nm/pix. 60XEcM9 :
+Trained on E.coli on M9 pads, 100nm/pix. 60XEc : Trained on E.coli on LB
+and M9 pads, 100nm/pix. 60XEcLB : Trained on E.coli on LB pads,
+100nm/pix. 60XBay : Trained on A.baylyi on LB pads, 100nm/pix. 60XPa :
+Trained on P.aeruginosa, 100nm/pix. 60XCaulob : Trained on snapshots of
+C.crescentus, 130 nm/pixel.
+
+## General Process and output 
+
+The fluorescence and phase images are processed and aligned. During
+segmentation the image cells are partitioned from the background. Then
+each cell is linked to one cell or a pair of cells in the next frame and
+the cells receive ID numbers. Next, the properties and fluorescence
+characteristics of each cell are calculated. Finally, the program
+outputs the Clist, a table with pertaining information during the cell
+lifetime, and a file for each cell with all the characteristics during
+its lifetime.
+
+## Images - Naming Convention 
+In order to
+segment your images they need to follow our naming convention. The
+naming convention of the image files must be of the following format
+base_name_t\[frame-number\]xy\[xy-number\]c\*.tif. c1 must be the bright
+field and c2,c3 etc are different fluorescent channels.
+
+Example of two time points, two xy positions and one fluorescent channel
+
+`filename_t001xy1c1.tif`\
+`filename_t001xy1c2.tif`\
+`filename_t001xy2c1.tif`\
+`filename_t001xy2c2.tif`\
+`filename_t002xy1c1.tif`\
+`filename_t002xy1c2.tif`\
+`filename_t002xy2c1.tif`\
+`filename_t002xy2c2.tif`
+
+superSeggerGui provides a function to rename your images
+
+## Output 
+SuperSegger generates three different types of outputs:
+Frame files, Clist matrices and Cell files. The frame files (\*seg.mat
+and \*err.mat files) contain information about the specific frame, the
+clist matrices are matrices of cells versus about 100 cellular
+descriptors, and the cell files contain information for each cell. For
+more information about each of these outputs visit the output section of
+the wiki (https://github.com/wiggins-lab/SuperSegger/wiki).
+
+## Collecting Images
+
+SuperSegger is unable to correctly segment images where the cell
+outlines are not clear to the user by eye. Care should still be taken in
+collecting the best possible focused phase images. We recommend that
+users crop out-of-focus regions of the image before the segmentation
+process since these parts of the image are unlikely to yield usable
+data. superSeggerGui provides a function to crop your images.

readme.txt

@@ -21,11 +21,14 @@ Software Requirements
 
 In order to use SuperSegger you need to have the MATLAB software with the following toolboxes:
 Image Processing Toolbox
-Neural Network Toolbox
+Neural Network Toolbox a.k.a. Deep Learning Toolbox
 Statistics and Machine Learning Toolbox
 Global Optimization Toolbox
 Parallel Computing Toolbox (not necessary)
 
+A Warning about missing toolboxes will be issued if any of the above is not found while running SuperSegger. First make sure the above toolboxes are installed (
+use the AddOn Manager in matlab in the "Home" tab.). If all toolboxes are installed but you still get these warnings, make sure that the filesystem paths where the toolboxes are installed are listed under "Set Path" in the matlab GUI.
+
 
 Software Availability and Documentation
 ========================================