Skip to content

Latest commit

 

History

History
90 lines (62 loc) · 4.1 KB

README.md

File metadata and controls

90 lines (62 loc) · 4.1 KB

CEM Dataset

PWC

Code for the paper: CEM500K, a large-scale heterogeneous unlabeled cellular electron microscopy image dataset for deep learning

About the Dataset

Typical EM datasets are created and shared to further biological research. Often that means that the sample size is n=1 (one instrument, one sample preparation protocol, one organism, one tissue, one cell line, etc.) and usually such datasets are hundreds of gigabytes to terabytes in size. For deep learning it is obviously true that a neural network trained on a dataset of 100 images from 100 different EM experiments will generalize better than the equivalent trained on 100 images from 1 EM experiment. CEM500K is an attempt to build a better dataset for deep learning by collecting and curating data from as many different EM experiments as possible. In total, we put together data from 102 unrelated EM experiments. Here's a breakdown of the biological details:

About Pre-trained Weights

Using CEM500K for unsupervised pre-training, we demonstrated a significant improvement in the performance of a 2D U-Net on a number of 2D AND 3D EM segmentation tasks. Pre-trained models not only achieved better IoU scores than random initialization, but also outperformed state-of-the-art results on all benchmarks for which comparison was possible. Even better CEM500K pre-training enabled models to converge much more quickly (some models took only 45 seconds to train!). See evaluation for a quick and easy way to use the pre-trained weights.

Right: Example benchmark datasets. Left: IoU score improvements over random init. using CEM500K pre-trained weights (bottom row). See paper for more details.

Getting Started

First clone this repository:

git clone https://github.com/volume-em/cem-dataset.git

If using conda, install dependencies in a new environment:

cd cellemnet
conda env create -f environment.yml

Otherwise, required dependencies can be installed with another package manager (pip):

  • torch
  • torchvision
  • segmentation-models-pytorch
  • albumentations
  • h5py
  • mlflow
  • simpleitk
  • scikit-learn
  • imagehash

Download the Dataset

The latest iteration of the CEM dataset is CEM1.5M. Images and metadata are available for download through EMPIAR ID 11035.

Pre-trained weights

Currently, pre-trained weights are only available for PyTorch. For an example of how to use them see evaluation/benchmark_configs and notebooks/pretrained_weights.ipynb.

Model architecture Pre-training method Dataset Link
ResNet50 MoCoV2 CEM500K https://zenodo.org/record/6453140#.Y5inAC2B1Qg
ResNet50 SWaV CEM1.5M https://zenodo.org/record/6453160#.Y5iznS2B1Qh

Data Curation

For image deduplication and filtering routines see the dataset directory README. Results on a small example 3D image volume can be reviewed in notebooks/deduplication_and_filtering.ipynb.

Citing this work

Please cite this work.

@article {Conrad2021,
	author = {Conrad, Ryan and Narayan, Kedar},
	doi = {10.7554/eLife.65894},
	issn = {2050-084X},
	journal = {eLife},
	month = {apr},
	title = {{CEM500K, a large-scale heterogeneous unlabeled cellular electron microscopy image dataset for deep learning}},
	url = {https://elifesciences.org/articles/65894},
	volume = {10},
	year = {2021}
}