Skip to content

RoysamLab/TIMING2

 
 

Repository files navigation

What is TIMING?

TIMING is the acronym for Time-lapse Imaging Microscopy in Nanowell Grids. It is a high-throughput single-cell imaging and image processing protocol developed and maintained by Single-Cell Lab, FARSight Group and STIM Laboratory at University of Houston, Houston, Texas.

In TIMING, we put cells in controlled microenvironment, nanowells. The nanowells have the size of 50 um by 50 um, and in one nanowell, there are usually less than 10 cells in total. Different cells are stained with different fluorescent bio-markers. We do 4D imaging (X,Y,w,t) of the cells and analyze their interactions.

Nanowell Slides

The nanowells are fabricated on PDMS slides and in one slide there are approximately 100,000 nanowells. Automatic analysis of huge amount of imaging data is necessary. We build a image processing and analysis pipeline to achieve this. The pipeline contains following steps:

  • Image preprocessing, including spectral unmixing, background subtraction and contrast enhancement
  • Cell Segmentation
  • Cell Tracking
  • Cell Feature Calculation

TIMING could boost immunotherapy. For example, we use TIMING to quantify the killing efficacy of CAR T-cells (Chimeric Antigen Receptor T Cell, a geneticlly modified human T cell) and implement the optimal reprogrammed CAR T-cell for a specific patient.

For more details, see our previous Bioinformatics paper

How about TIMING2?

TIMING2 is all about the updates and improvements of TIMING pipeline, the software part of the whole TIMING protocol. Compared with TIMING pipeline, we have the following key improvements:

(1) A unified TIMING2-pipeline wrapped up in Jupyter Notebook, where user can run different steps easily;

(2) Updated Modules, TIMING2-pipeline have several modules in TIMING pipeline updated, which are faster, easier and more robust

  • EZ_Unmixer, we use an interactive tool EZ_Unmixer to calculate the spectral leakage ratio \lambda, and do linear subtraction with \lambda using the pipeline;

  • Nanowell detection and cropping using faster r-cnn, a more robust nanowell detection module using state-of-art object detector based on convolutional neural networks; fully automatic and no input parameter configuration;

  • GPU-accelerated Cell segmentation module

(3) New Modules, TIMING2 has new module which is not included in TIMING,

  • TIMING2-board, a visualization and re-editing system

TIMING2-board

(4) Cross-Platform compatibility

Requirements:

  • 64-bit computer with at least 2GHz processor running Windows, Linux or Mac
  • CUDA-enabled GPU, memory >= 4 GB recommended
  • Hard drive storage >= 2TB, solid-state hard drive strongly recommended

Installation:

(1) Download this repository and put the folder say C:\Users\TIMING2\

(2) Download auxiliary modules, and copy the folders to C:\Users\TIMING2\

(3) Download and install Anaconda

(4) Create the environments for TIMING2-pipeline and TIMING2-board, open Anaconda Prompt, change to TIMING2 home directory C:\Users\TIMING2, and type python setup_env.py

(5) Set up TIMING2-pipeline, in the prompt, type activate TIMING2-pipeline, and then type python setup_timing2_pipeline.py

(6) Open another Anaconda Prompt, change to TIMING2 home directory, type activate TIMING2-board, and then type python setup_timing2_board.py (independent from step 5)

(7) Have a cup of coffee, will be ready in several minutes.

Usage:

Note: This code is free for non-commerical use only.

(1) Download the TEST Dataset, and put it in the folder, say C:\Users\TIMING2_Datasets_Raw; also, make another directory for the results C:\Users\TIMING2_Datasets_Results;

(2) Run TIMING2-pipeline Jupyter Notebook, make sure to change the following parameters to run the test:

  • CORE_NUMBER = # of CORES available on your machine

  • TIMING_II_Home = "C:\Users\TIMING2\"

  • Data_Raw_DIR = "C:\Users\TIMING2_Datasets_Raw\"

  • Data_DIR = "C:\Users\TIMING2_Datasets_Results\"

(3) Visualize the results; Open a new Anaconda Prompt, activate the visualization and editing environment by typing activate TIMING2- board, change directory to typing cd C:\Users\TIMING2\timing2-viewer\2.0\. Start the visualization system typing python TIMING_Main.py, and you will see a small widget window popping up.

Sample Results:

Sample Results using CAR T-cell (Effector) and A375 -dCD19 (Melanoma Target) can be found here: Nanowell Repository

Contact:

Hengyang Lu: hlu9@uh.edu

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 93.2%
  • Jupyter Notebook 4.6%
  • HTML 2.2%