-
Notifications
You must be signed in to change notification settings - Fork 4
Home
Welcome to CellTracksColab, your comprehensive platform for analyzing cell migration tracks. Whether you're a beginner or an experienced researcher, our platform offers intuitive guidance every step of the way. You'll find detailed explanations in the notebooks to help you navigate the analysis process. Plus, a test dataset is provided to get you started immediately.
Tutorial 1: Getting Started with CellTracksColab using Google Colab |
Tutorial 2: Using CellTracksColab locally using Jupyter |
Tutorial 3: Using CellTracksColab locally using Google Colab |
CellTracksColab has been tested with tracking outputs from:
TrackMate | CellProfiler | Icy | ilastik | Fiji Manual Tracker |
But may also be compatible with other tracking software exporting tracking results that meet our minimal requirements. Ensure your data is well-organized according to the recommended folder hierarchy. This structure helps in managing and analyzing the data efficiently.
The easiest way to start using CellTracksColab is in the cloud using Google Collaboratory, but it can also be used on your own computer using Jupyter Notebooks.
-
Google Collaboratory: Easy to set up and use with free computational resources.
-
Local Installation: Run on your own hardware for more control and privacy.
We provide three notebooks for loading and analyzing your data depending on its format:
Notebook | Purpose | Required File Format | Link |
---|---|---|---|
CellTracksColab - TrackMate | Load and analyze TrackMate data. More info on how to prepare the data here. | CSV or XML files | |
CellTracksColab - Custom | Analyze data from CellProfiler, ICY, ilastik, or Fiji Manual Tracker. More info on how to prepare the data here. | CSV files | |
CellTracksColab - Viewer | Load and share data in the CellTracksColab format. | CellTracksColab format |
These notebooks require your dataset to be in the CellTracksColab format.
More to come
- Handle TrackMate CSV files structured in a plate format, such as file names commonly produced by incubator microscopes like Incucytes.
- Test Dataset: Start exploring with our test datasets in CellTracksColab CSV format, or TrackMate CSV format.
- Data Structure: Organize with our two-tiered folder hierarchy. Details here.
- Data Requirements: Note that CellTracksColab does not yet support track merging or splitting.
- Estibaliz Gómez-de-Mariscal
- Hanna Grobe
- Joanna W. Pylvänäinen
- Laura Xénard
- Ricardo Henriques
- Jean-Yves Tinevez
- Guillaume Jacquemet
We welcome your insights and improvements! There are several ways you can contribute to the CellTracksColab project:
If you encounter any bugs, have suggestions for improvements, or want to discuss new features, please raise an issue on our GitHub Issues page.
We are excited to see new analysis notebooks built on the CellTracksColab platform. If you have developed a new notebook, please submit it via a pull request. All submitted notebooks should include a test dataset to showcase their functionality. Each notebook will be tested by a member of the team before being released.
We expect all contributors to adhere to our simple code of conduct:
- Be respectful and considerate of others.
- Provide constructive feedback.
- Collaborate openly and honestly.
By participating in this project, you agree to abide by these guidelines.
Thank you for contributing to CellTracksColab! Your support and contributions help us improve and expand the platform for everyone in the community.
Licensed under the MIT License. Details here.
If you use CellTracksColab in your research, please cite the following paper:
Guillaume Jacquemet. (2023). CellTracksColab—A platform for compiling, analyzing, and exploring tracking data. bioRxiv. https://doi.org/10.1101/2023.10.20.563252
---