From efa2170e5c2d3a69a4e12e2a1762286311f519e7 Mon Sep 17 00:00:00 2001 From: kapoorlab Date: Sun, 3 Sep 2023 07:58:08 +0200 Subject: [PATCH] start jupyter book --- EMBRYOS.md | 7 +++++++ README.md | 4 ++++ _config.yml | 32 ++++++++++++++++++++++++++++++++ _toc.yml | 12 ++++++++++++ 4 files changed, 55 insertions(+) create mode 100644 EMBRYOS.md create mode 100644 _config.yml create mode 100644 _toc.yml diff --git a/EMBRYOS.md b/EMBRYOS.md new file mode 100644 index 0000000..9b7dd46 --- /dev/null +++ b/EMBRYOS.md @@ -0,0 +1,7 @@ +# Confocal and Light Sheet imaged Embryonic cells + +## Ascadian Embryo +In this example we consider a dataset imaged using Light sheet fused from four angles to create a single channel 3D image of Phallusia Mammillata Embryo created using live SPIM imaging. The training data can be found [here](https://figshare.com/articles/dataset/Astec-half-Pm1_Cut_at_2-cell_stage_half_Phallusia_mammillata_embryo_live_SPIM_imaging_stages_6-16_/11309570?backTo=/s/765d4361d1b073beedd5). For this imaging modality we trained only a [UNet model](https://zenodo.org/record/6337699) to segment the interior region of the cells and by using ```slice_merge=True``` and +```expand_labels=True``` in the VollSeg parameter setting we obtained the following segmentation result along with the metrics compared to the ground truth. + + | diff --git a/README.md b/README.md index 3c17028..2ef9439 100644 --- a/README.md +++ b/README.md @@ -9,10 +9,14 @@ [![Twitter Badge](https://badgen.net/badge/icon/twitter?icon=twitter&label)](https://twitter.com/entracod) +VollSeg is not just one segmentation algorithm but is a crafted modular segmentation tool for different model organisms and imaging modalities. For some imaged samples just using U-Net may do the job while for others it could be just StarDist and for some others it could be a combination of the two with or without any denoising or region of interest model. The only choice that remains is how to choose the VollSeg combination for your dataset and that is what we answer in our documentation. + + This project provides the [napari](https://napari.org/) plugin for [VollSeg](https://github.com/kapoorlab/vollseg), a deep learning based 2D and 3D segmentation tool for irregular shaped cells. VollSeg has originally been developed (see [papers](http://conference.scipy.org/proceedings/scipy2021/varun_kapoor.html)) for the segmentation of densely packed membrane labelled cells in challenging images with low signal-to-noise ratios. The plugin allows to apply pretrained and custom trained models from within napari. For detailed demo of the plugin see these [videos](https://www.youtube.com/watch?v=W_gKrLWKNpQ) and a short video about the [parameter selection](https://www.youtube.com/watch?v=7tQMn_u8_7s&t=1s) + ## Installation & Usage Install the plugin with `pip install vollseg-napari` or from within napari via `Plugins > Install/Uninstall Package(s)…`. If you want GPU-accelerated prediction, please read the more detailed [installation instructions](https://github.com/kapoorlab/vollseg-napari#gpu_installation) for VollSeg. diff --git a/_config.yml b/_config.yml new file mode 100644 index 0000000..349ab27 --- /dev/null +++ b/_config.yml @@ -0,0 +1,32 @@ +# Book settings +# Learn more at https://jupyterbook.org/customize/config.html + +title: Segmentation using VollSeg +author: Varun Kapoor +logo: images/kapoorlogo.png + +# Force re-execution of notebooks on each build. +# See https://jupyterbook.org/content/execute.html +execute: + execute_notebooks: force + +# Define the name of the latex output file for PDF builds +latex: + latex_documents: + targetname: vollseg-napari.tex + +# Add a bibtex file so that we can create citations +bibtex_bibfiles: + - references.bib + +# Information about where the book exists on the web +repository: + url: https://github.com/Kapoorlabs-CAPED/vollseg-napari/ # Online location of your book + path_to_book: docs # Optional path to your book, relative to the repository root + branch: master # Which branch of the repository should be used when creating links (optional) + +# Add GitHub buttons to your book +# See https://jupyterbook.org/customize/config.html#add-a-link-to-your-repository +html: + use_issues_button: true + use_repository_button: true \ No newline at end of file diff --git a/_toc.yml b/_toc.yml new file mode 100644 index 0000000..8a8597b --- /dev/null +++ b/_toc.yml @@ -0,0 +1,12 @@ +# Table of contents +# Learn more at https://jupyterbook.org/customize/toc.html + +format: jb-book +root: README + +chapters: + - file: EMBRYOS + - file: MAMMARYGLAND + - file: XENOPUS + - file: SPHEROIDS + - file: MICROTUBULES