celldetective 1.3.9.post4__tar.gz → 1.4.0__tar.gz

{celldetective-1.3.9.post4 → celldetective-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: celldetective
-Version: 1.3.9.post4
+Version: 1.4.0
 Summary: description
 Home-page: http://github.com/remyeltorro/celldetective
 Author: Rémy Torro
@@ -44,12 +44,17 @@ Requires-Dist: h5py
 Requires-Dist: cliffs_delta
 Requires-Dist: requests
 Requires-Dist: trackpy
+Requires-Dist: prettyprint
+Requires-Dist: pandas
+Requires-Dist: matplotlib
+Requires-Dist: prettytable
 Dynamic: author
 Dynamic: author-email
 Dynamic: description
 Dynamic: description-content-type
 Dynamic: home-page
 Dynamic: license
+Dynamic: license-file
 Dynamic: requires-dist
 Dynamic: summary
 
@@ -183,26 +188,29 @@ For more information about how to get started, please check the [documentation](
 # How to cite?
 
 If you use this software in your research, please cite the
-[Celldetective](https://www.biorxiv.org/content/10.1101/2024.03.15.585250v3)
-paper (currently preprint):
+[Celldetective](https://elifesciences.org/reviewed-preprints/105302)
+paper (currently a reviewed preprint at eLife):
 
 ``` raw
-@article {Torro2024.03.15.585250,
-    author = {Torro, R{\'e}my and D{\'\i}az-Bello, Beatriz and Arawi, Dalia El and Dervanova, Ksenija and Ammer, Lorna and Dupuy, Florian and Chames, Patrick and Sengupta, Kheya and Limozin, Laurent},
-    title = {Celldetective: an AI-enhanced image analysis tool for unraveling dynamic cell interactions},
-    elocation-id = {2024.03.15.585250},
-    year = {2024},
-    doi = {10.1101/2024.03.15.585250},
-    publisher = {Cold Spring Harbor Laboratory},
-    abstract = {A current challenge in bioimaging for immunology and immunotherapy research lies in analyzing multimodal and multidimensional data that capture dynamic interactions between diverse cell populations. Here, we introduce Celldetective, an open-source Python-based software designed for high-performance, end-to-end analysis of image-based in vitro immune and immunotherapy assays. Purpose-built for multicondition, 2D multichannel time-lapse microscopy of mixed cell populations, Celldetective is optimized for the needs of immunology assays. The software seamlessly integrates AI-based segmentation, Bayesian tracking, and automated single-cell event detection, all within an intuitive graphical interface that supports interactive visualization, annotation, and training capabilities. We demonstrate its utility with original data on immune effector cell interactions with an activating surface, mediated by bispecific antibodies, and further showcase its potential for analyzing extensive sets of pairwise interactions in antibody-dependent cell cytotoxicity events.Competing Interest StatementThe authors have declared no competing interest.},
-    URL = {https://www.biorxiv.org/content/early/2024/11/13/2024.03.15.585250},
-    eprint = {https://www.biorxiv.org/content/early/2024/11/13/2024.03.15.585250.full.pdf},
-    journal = {bioRxiv}
+@article{torroCelldetectiveAIenhancedImage2025,
+  title = {Celldetective: An {{AI-enhanced}} Image Analysis Tool for Unraveling Dynamic Cell Interactions},
+  shorttitle = {Celldetective},
+  author = {Torro, Rémy and Díaz-Bello, Beatriz and Arawi, Dalia El and Dervanova, Ksenija and Ammer, Lorna and Dupuy, Florian and Chames, Patrick and Sengupta, Kheya and Limozin, Laurent},
+  date = {2025-03-10},
+  journaltitle = {eLife},
+  volume = {14},
+  publisher = {eLife Sciences Publications Limited},
+  doi = {10.7554/eLife.105302.1},
+  url = {https://elifesciences.org/reviewed-preprints/105302},
+  urldate = {2025-03-20},
+  abstract = {A current challenge in bioimaging for immunology and immunotherapy research lies in analyzing multimodal and multidimensional data that capture dynamic interactions between diverse cell populations. Here, we introduce Celldetective, an open-source Python-based software designed for high-performance, end-to-end analysis of image-based in vitro immune and immunotherapy assays. Purpose-built for multicondition, 2D multichannel time-lapse microscopy of mixed cell populations, Celldetective is optimized for the needs of immunology assays. The software seamlessly integrates AI-based segmentation, Bayesian tracking, and automated single-cell event detection, all within an intuitive graphical interface that supports interactive visualization, annotation, and training capabilities. We demonstrate its utility with original data on immune effector cell interactions with an activating surface, mediated by bispecific antibodies, and further showcase its potential for analyzing extensive sets of pairwise interactions in antibody-dependent cell cytotoxicity events.},
+  langid = {english},
+  file = {/home/torro/Zotero/storage/VFYBBMQF/Torro et al. - 2025 - Celldetective an AI-enhanced image analysis tool .pdf;/home/torro/Zotero/storage/UGMCKKST/105302.html}
 }
 ```
 
 Make sure you to cite the papers of any segmentation model (StarDist,
-Cellpose) or tracker (bTrack) you used through Celldetective.
+Cellpose) or tracker (bTrack, TrackPy) you used through Celldetective.
 
 # Bibliography
 

{celldetective-1.3.9.post4 → celldetective-1.4.0}/README.md

@@ -128,26 +128,29 @@ For more information about how to get started, please check the [documentation](
 # How to cite?
 
 If you use this software in your research, please cite the
-[Celldetective](https://www.biorxiv.org/content/10.1101/2024.03.15.585250v3)
-paper (currently preprint):
+[Celldetective](https://elifesciences.org/reviewed-preprints/105302)
+paper (currently a reviewed preprint at eLife):
 
 ``` raw
-@article {Torro2024.03.15.585250,
-    author = {Torro, R{\'e}my and D{\'\i}az-Bello, Beatriz and Arawi, Dalia El and Dervanova, Ksenija and Ammer, Lorna and Dupuy, Florian and Chames, Patrick and Sengupta, Kheya and Limozin, Laurent},
-    title = {Celldetective: an AI-enhanced image analysis tool for unraveling dynamic cell interactions},
-    elocation-id = {2024.03.15.585250},
-    year = {2024},
-    doi = {10.1101/2024.03.15.585250},
-    publisher = {Cold Spring Harbor Laboratory},
-    abstract = {A current challenge in bioimaging for immunology and immunotherapy research lies in analyzing multimodal and multidimensional data that capture dynamic interactions between diverse cell populations. Here, we introduce Celldetective, an open-source Python-based software designed for high-performance, end-to-end analysis of image-based in vitro immune and immunotherapy assays. Purpose-built for multicondition, 2D multichannel time-lapse microscopy of mixed cell populations, Celldetective is optimized for the needs of immunology assays. The software seamlessly integrates AI-based segmentation, Bayesian tracking, and automated single-cell event detection, all within an intuitive graphical interface that supports interactive visualization, annotation, and training capabilities. We demonstrate its utility with original data on immune effector cell interactions with an activating surface, mediated by bispecific antibodies, and further showcase its potential for analyzing extensive sets of pairwise interactions in antibody-dependent cell cytotoxicity events.Competing Interest StatementThe authors have declared no competing interest.},
-    URL = {https://www.biorxiv.org/content/early/2024/11/13/2024.03.15.585250},
-    eprint = {https://www.biorxiv.org/content/early/2024/11/13/2024.03.15.585250.full.pdf},
-    journal = {bioRxiv}
+@article{torroCelldetectiveAIenhancedImage2025,
+  title = {Celldetective: An {{AI-enhanced}} Image Analysis Tool for Unraveling Dynamic Cell Interactions},
+  shorttitle = {Celldetective},
+  author = {Torro, Rémy and Díaz-Bello, Beatriz and Arawi, Dalia El and Dervanova, Ksenija and Ammer, Lorna and Dupuy, Florian and Chames, Patrick and Sengupta, Kheya and Limozin, Laurent},
+  date = {2025-03-10},
+  journaltitle = {eLife},
+  volume = {14},
+  publisher = {eLife Sciences Publications Limited},
+  doi = {10.7554/eLife.105302.1},
+  url = {https://elifesciences.org/reviewed-preprints/105302},
+  urldate = {2025-03-20},
+  abstract = {A current challenge in bioimaging for immunology and immunotherapy research lies in analyzing multimodal and multidimensional data that capture dynamic interactions between diverse cell populations. Here, we introduce Celldetective, an open-source Python-based software designed for high-performance, end-to-end analysis of image-based in vitro immune and immunotherapy assays. Purpose-built for multicondition, 2D multichannel time-lapse microscopy of mixed cell populations, Celldetective is optimized for the needs of immunology assays. The software seamlessly integrates AI-based segmentation, Bayesian tracking, and automated single-cell event detection, all within an intuitive graphical interface that supports interactive visualization, annotation, and training capabilities. We demonstrate its utility with original data on immune effector cell interactions with an activating surface, mediated by bispecific antibodies, and further showcase its potential for analyzing extensive sets of pairwise interactions in antibody-dependent cell cytotoxicity events.},
+  langid = {english},
+  file = {/home/torro/Zotero/storage/VFYBBMQF/Torro et al. - 2025 - Celldetective an AI-enhanced image analysis tool .pdf;/home/torro/Zotero/storage/UGMCKKST/105302.html}
 }
 ```
 
 Make sure you to cite the papers of any segmentation model (StarDist,
-Cellpose) or tracker (bTrack) you used through Celldetective.
+Cellpose) or tracker (bTrack, TrackPy) you used through Celldetective.
 
 # Bibliography
 

celldetective-1.4.0/celldetective/__init__.py

@@ -0,0 +1 @@
+from ._version import __version__

celldetective-1.4.0/celldetective/_version.py

@@ -0,0 +1 @@
+__version__ = "1.4.0"

{celldetective-1.3.9.post4 → celldetective-1.4.0}/celldetective/events.py

@@ -52,7 +52,7 @@ def switch_to_events(classes, event_times, max_times, origin_times=None, left_ce
 	>>> event_times = [5, 10, 15]
 	>>> max_times = [20, 20, 20]
 	>>> origin_times = [0, 0, 5]
-	>>> events, survival_times = switch_to_events_v2(classes, event_times, max_times, origin_times, FrameToMin=0.5)
+	>>> events, survival_times = switch_to_events(classes, event_times, max_times, origin_times, FrameToMin=0.5)
 	# This would process the events considering left censorship and convert survival times to minutes.
 	
 	"""
@@ -189,6 +189,7 @@ def compute_survival(df, class_of_interest, t_event, t_reference=None, FrameToMi
 	assert class_of_interest in cols,"The requested class cannot be found in the dataframe..."
 	assert t_event in cols,"The event time cannot be found in the dataframe..."
 	left_censored = False
+	first_detections = None
 
 	if not pairs:
 		groupby_cols = ['position','TRACK_ID']
@@ -209,10 +210,7 @@ def compute_survival(df, class_of_interest, t_event, t_reference=None, FrameToMi
 		assert t_reference in cols,"The reference time cannot be found in the dataframe..."
 		first_detections = df.groupby(groupby_cols)[t_reference].max().values
 	
-
-	print(f"{classes=} {event_times=} {max_times=} {first_detections=}")
 	events, survival_times = switch_to_events(classes, event_times, max_times, origin_times=first_detections, left_censored=left_censored, FrameToMin=FrameToMin, cut_observation_time=cut_observation_time)
-	print(f"{events=} {survival_times=}")
 
 	ks = KaplanMeierFitter()
 	if len(events)>0: