Skip to content

rickyota/CSML

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CSML ver. 1.2.1

Cell Segmenter using Machine Learning.
Releases: Software based on this code.
Wiki: Details of CSML.

Description

CSML returns segmented images of fluorescent images, inferred by FCN classifier, tagged images and statistics of each cell.
Classifier is optimized by training and corresponding labeled images.
Statistics contain Centroids, Area, Perimeter, Eccentricity, Major axis, Minor axis, Orientation and Solidity.

Usage of Software

  1. Launch CSML.exe.
  2. Train model (only for the first time).
    1. Drag & Drop the images file and the corresponding binary images file.
    2. Specify name of model.
    3. Press "Start Training" button.
  3. Infer images.
    1. Drag & Drop the images file which you want to segment.
    2. Select the model which you want to use.
    3. Select output folder.
    4. Press "Start Infering" button.
  4. Get segmented images file in output folder.

Notes

  • Click "Run with Example" to use examples.
  • Format of Images is a folder containing images.
  • Accuracy displayed in model list is dot accuracy.

Authors

R. Ota
R. Nakabayashi (for help creating software)

Publication

Ota R, Ide T, Michiue T. A rapid segmentation method of cell boundary for developing embryos using machine learning with a personal computer. Dev Growth Differ. 2021 Oct;63(8):406-416. doi: 10.1111/dgd.12747. Epub 2021 Sep 20. PMID: 34453320.

A novel cell segmentation method for developing embryos using machine learning
Rikifumi Ota, Takahiro Ide, Tatsuo Michiue
bioRxiv 288720; doi: https://doi.org/10.1101/288720


Usage of Code

Please refer to this section if you want to run the codes directly.

Requirement

  • conda

Installation

$ git clone https://github.com/rickyota/CSML.git

You need to use conda to install python dependencies.

$ conda env create --file environment.yml

Usage

  1. Add images to folders in ./data/.
    • Make sure that you set the same image name in label and train folder.
  2. Execute
    $ conda activate csml
    $ bash csml.sh
    
  3. Inferred images are saved in ./result/.

If you want to run inferring step only or run csml with various parameters, refer to csml_onlyinfer.sh and csml_paras.sh.