cellects 0.2.2__tar.gz → 0.3.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. {cellects-0.2.2 → cellects-0.3.2}/PKG-INFO +20 -9
  2. {cellects-0.2.2 → cellects-0.3.2}/README.md +109 -101
  3. {cellects-0.2.2 → cellects-0.3.2}/pyproject.toml +4 -1
  4. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/core/cellects_threads.py +51 -185
  5. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/core/motion_analysis.py +74 -45
  6. cellects-0.3.2/src/cellects/core/one_image_analysis.py +787 -0
  7. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/core/program_organizer.py +172 -130
  8. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/core/script_based_run.py +13 -23
  9. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/gui/first_window.py +7 -4
  10. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/gui/image_analysis_window.py +46 -36
  11. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/gui/ui_strings.py +15 -15
  12. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/image_analysis/image_segmentation.py +21 -77
  13. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/image_analysis/morphological_operations.py +9 -15
  14. cellects-0.3.2/src/cellects/image_analysis/one_image_analysis_threads.py +360 -0
  15. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/image_analysis/shape_descriptors.py +1068 -1067
  16. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/utils/formulas.py +3 -1
  17. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/utils/load_display_save.py +2 -2
  18. {cellects-0.2.2 → cellects-0.3.2}/src/cellects.egg-info/PKG-INFO +20 -9
  19. {cellects-0.2.2 → cellects-0.3.2}/src/cellects.egg-info/requires.txt +3 -0
  20. {cellects-0.2.2 → cellects-0.3.2}/tests/test_formulas.py +4 -4
  21. {cellects-0.2.2 → cellects-0.3.2}/tests/test_image_segmentation.py +20 -14
  22. {cellects-0.2.2 → cellects-0.3.2}/tests/test_morphological_operations.py +108 -0
  23. {cellects-0.2.2 → cellects-0.3.2}/tests/test_motion_analysis.py +10 -22
  24. {cellects-0.2.2 → cellects-0.3.2}/tests/test_network_functions.py +0 -4
  25. cellects-0.3.2/tests/test_one_image_analysis.py +401 -0
  26. {cellects-0.2.2 → cellects-0.3.2}/tests/test_program_organizer.py +11 -8
  27. {cellects-0.2.2 → cellects-0.3.2}/tests/test_shape_descriptors.py +0 -1
  28. cellects-0.2.2/src/cellects/core/one_image_analysis.py +0 -1082
  29. cellects-0.2.2/src/cellects/image_analysis/one_image_analysis_threads.py +0 -230
  30. cellects-0.2.2/tests/test_one_image_analysis.py +0 -259
  31. {cellects-0.2.2 → cellects-0.3.2}/LICENSE +0 -0
  32. {cellects-0.2.2 → cellects-0.3.2}/setup.cfg +0 -0
  33. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/__init__.py +0 -0
  34. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/__main__.py +0 -0
  35. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/config/__init__.py +0 -0
  36. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/config/all_vars_dict.py +0 -0
  37. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/core/__init__.py +0 -0
  38. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/core/cellects_paths.py +0 -0
  39. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/gui/__init__.py +0 -0
  40. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/gui/advanced_parameters.py +0 -0
  41. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/gui/cellects.py +0 -0
  42. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/gui/custom_widgets.py +0 -0
  43. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/gui/if_several_folders_window.py +0 -0
  44. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/gui/required_output.py +0 -0
  45. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/gui/video_analysis_window.py +0 -0
  46. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/icons/__init__.py +0 -0
  47. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/icons/cellects_icon.icns +0 -0
  48. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/icons/cellects_icon.ico +0 -0
  49. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/image_analysis/__init__.py +0 -0
  50. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/image_analysis/cell_leaving_detection.py +0 -0
  51. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/image_analysis/network_functions.py +0 -0
  52. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/image_analysis/oscillations_functions.py +0 -0
  53. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/image_analysis/progressively_add_distant_shapes.py +0 -0
  54. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/utils/__init__.py +0 -0
  55. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/utils/decorators.py +0 -0
  56. {cellects-0.2.2 → cellects-0.3.2}/src/cellects/utils/utilitarian.py +0 -0
  57. {cellects-0.2.2 → cellects-0.3.2}/src/cellects.egg-info/SOURCES.txt +0 -0
  58. {cellects-0.2.2 → cellects-0.3.2}/src/cellects.egg-info/dependency_links.txt +0 -0
  59. {cellects-0.2.2 → cellects-0.3.2}/src/cellects.egg-info/entry_points.txt +0 -0
  60. {cellects-0.2.2 → cellects-0.3.2}/src/cellects.egg-info/top_level.txt +0 -0
  61. {cellects-0.2.2 → cellects-0.3.2}/tests/test_based_run.py +0 -0
  62. {cellects-0.2.2 → cellects-0.3.2}/tests/test_cell_leaving_detection.py +0 -0
  63. {cellects-0.2.2 → cellects-0.3.2}/tests/test_load_display_save.py +0 -0
  64. {cellects-0.2.2 → cellects-0.3.2}/tests/test_progressively_add_distant_shapes.py +0 -0
  65. {cellects-0.2.2 → cellects-0.3.2}/tests/test_utilitarian.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.2
2
2
  Name: cellects
3
- Version: 0.2.2
3
+ Version: 0.3.2
4
4
  Summary: Cell Expansion Computer Tracking Software.
5
5
  Author: Aurèle Boussard
6
6
  License: GNU GENERAL PUBLIC LICENSE
@@ -714,17 +714,24 @@ Requires-Dist: mkdocstrings[python]; extra == "doc"
714
714
  Requires-Dist: mkdocs-gen-files; extra == "doc"
715
715
  Requires-Dist: mkdocs-autorefs; extra == "doc"
716
716
  Requires-Dist: pymdown-extensions; extra == "doc"
717
+ Requires-Dist: mkdocs-literate-nav; extra == "doc"
718
+ Requires-Dist: mkdocs-section-index; extra == "doc"
719
+ Requires-Dist: mkdocs-jupyter; extra == "doc"
717
720
 
718
- Cellects: Cell Expansion Computer Tracking Software
719
- ===================================================
721
+ <h1>
722
+ <img src="https://raw.githubusercontent.com/Aurele-B/cellects/main/.github/icon.png"
723
+ width="42"
724
+ style="vertical-align: middle; margin-right: 12px;">
725
+ Cellects: Cell Expansion Computer Tracking Software
726
+ </h1>
720
727
 
721
728
  [![PyPI version](https://img.shields.io/pypi/v/cellects.svg?style=flat-square)](https://pypi.org/project/cellects/)
722
729
  ![PyPI - Downloads](https://img.shields.io/pypi/dm/cellects)
723
730
  [![Python versions](https://img.shields.io/pypi/pyversions/cellects.svg?style=flat-square)](https://pypi.org/project/cellects/)
724
731
  [![License](https://img.shields.io/pypi/l/cellects.svg?style=flat-square)](https://github.com/Aurele-B/cellects/blob/main/LICENSE)
725
732
  [![Stars](https://img.shields.io/github/stars/Aurele-B/cellects.svg?style=flat-square)](https://github.com/Aurele-B/cellects/stargazers)
726
- ![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/Aurele-B/Cellects/.github%2Fworkflows%2Fci.yml)
727
- ![Coverage](https://Aurele-B.github.io/cellects/badges/coverage.svg)
733
+ ![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/Aurele-B/Cellects/.github%2Fworkflows%2Frelease.yml)
734
+ ![Coverage](https://raw.githubusercontent.com/Aurele-B/cellects/gh-pages/badges/coverage.svg)
728
735
 
729
736
  Description
730
737
  -----------
@@ -734,7 +741,8 @@ Cellects’ main strengths are its broad scope of action, automated computation
734
741
  easy installation and user-friendly interface.
735
742
 
736
743
  <figure>
737
- <img src="doc/static/UserManualFigure1.png" alt="Cellects first window" class="center" width="600">
744
+ <img src="doc/static/UserManualFigure1.png" alt="Cellects first window"
745
+ style="display:block;float:none;margin-left:auto;margin-right:auto;width:100%">
738
746
  <figcaption><strong>Figure 1:</strong> Cellects first window</figcaption>
739
747
  </figure>
740
748
 
@@ -761,9 +769,12 @@ Cellects
761
769
 
762
770
  ## 📚 Documentation
763
771
 
764
- Full documentation is available in the [docs](https://aurele-b.github.io/Cellects/) folder and includes:
765
- - [**User Manual**](https://aurele-b.github.io/Cellects/first-analysis/): Step-by-step workflows for data localization, image analysis and video tracking
766
- - [**Advanced Features**](https://aurele-b.github.io/Cellects/advanced/): Customization options, batch processing, parameter tuning.
772
+ Cellects' workflow is described in a [complete documentation](https://aurele-b.github.io/Cellects/). It includes:
773
+ - [**What is Cellects**](https://aurele-b.github.io/Cellects/what-is-cellects/): Purpose of the software, usable data and introduction of its user manual
774
+ - [**Setting up a first analysis**](https://aurele-b.github.io/Cellects/first-analysis/): Step-by-step workflows for data localization, image analysis and video tracking
775
+ - [**Improving the analysis**](https://aurele-b.github.io/Cellects/advanced/): Customization options, batch processing, parameter tuning.
776
+ - [**Use cases**](https://aurele-b.github.io/Cellects/use-cases/): Real-world cases using the GUI (interface) and the API (scripts).
777
+ - [**Contributing**](https://aurele-b.github.io/Cellects/contributing/): Report bugs and feature requests; contribute; testing and documentation processes.
767
778
  - [**API Reference**](https://aurele-b.github.io/Cellects/api/): Auto-generated from source code docstrings (see [Build Documentation]).
768
779
 
769
780
  ---
@@ -1,101 +1,109 @@
1
- Cellects: Cell Expansion Computer Tracking Software
2
- ===================================================
3
-
4
- [![PyPI version](https://img.shields.io/pypi/v/cellects.svg?style=flat-square)](https://pypi.org/project/cellects/)
5
- ![PyPI - Downloads](https://img.shields.io/pypi/dm/cellects)
6
- [![Python versions](https://img.shields.io/pypi/pyversions/cellects.svg?style=flat-square)](https://pypi.org/project/cellects/)
7
- [![License](https://img.shields.io/pypi/l/cellects.svg?style=flat-square)](https://github.com/Aurele-B/cellects/blob/main/LICENSE)
8
- [![Stars](https://img.shields.io/github/stars/Aurele-B/cellects.svg?style=flat-square)](https://github.com/Aurele-B/cellects/stargazers)
9
- ![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/Aurele-B/Cellects/.github%2Fworkflows%2Fci.yml)
10
- ![Coverage](https://Aurele-B.github.io/cellects/badges/coverage.svg)
11
-
12
- Description
13
- -----------
14
-
15
- Cellects is a tracking software for organisms whose shape and size change over time.
16
- Cellects’ main strengths are its broad scope of action, automated computation of a variety of geometrical descriptors,
17
- easy installation and user-friendly interface.
18
-
19
- <figure>
20
- <img src="doc/static/UserManualFigure1.png" alt="Cellects first window" class="center" width="600">
21
- <figcaption><strong>Figure 1:</strong> Cellects first window</figcaption>
22
- </figure>
23
-
24
- ---
25
-
26
- ## 🚀 Installation (Short version)
27
- Install using our Windows installer: [Cellects_installer.exe](https://github.com/Aurele-B/Cellects/releases/)
28
-
29
- Or, install via pip:
30
- ```bash
31
- pip install cellects
32
- ```
33
- Any difficulties? follow our [complete installation tutorial](https://aurele-b.github.io/Cellects/installation/)
34
-
35
- ---
36
-
37
- ## 🎯 Quick Start
38
- Run in terminal:
39
- ```bash
40
- Cellects
41
- ```
42
-
43
- ---
44
-
45
- ## 📚 Documentation
46
-
47
- Full documentation is available in the [docs](https://aurele-b.github.io/Cellects/) folder and includes:
48
- - [**User Manual**](https://aurele-b.github.io/Cellects/first-analysis/): Step-by-step workflows for data localization, image analysis and video tracking
49
- - [**Advanced Features**](https://aurele-b.github.io/Cellects/advanced/): Customization options, batch processing, parameter tuning.
50
- - [**API Reference**](https://aurele-b.github.io/Cellects/api/): Auto-generated from source code docstrings (see [Build Documentation]).
51
-
52
- ---
53
-
54
- ## 🧪 Use Cases
55
-
56
- See [use cases](https://aurele-b.github.io/Cellects/use-cases/) for real-world examples:
57
- - Automated Physarum polycephalum tracking using GUI
58
- - Automated Physarum polycephalum tracking using API
59
- - Colony growth tracking
60
-
61
- ---
62
-
63
- ## 🛠 Contributing
64
-
65
- We welcome contributions!
66
- 1. Fork the repository and create a new branch.
67
- 2. Submit issues/PRs via [GitHub](https://github.com/Aurele-B/cellects/issues).
68
-
69
- For developer workflows, see [**Contributing**](https://aurele-b.github.io/Cellects/contributing/).
70
-
71
- ---
72
-
73
- ## 📌 License & Citation
74
-
75
- GNU GPL3 License (see [LICENSE](https://github.com/Aurele-B/cellects/blob/main/LICENSE)).
76
-
77
- To cite Cellects, use:
78
- ```bibtex
79
- @article{boussard2024cellects,
80
- title={Cellects, a software to quantify cell expansion and motion},
81
- author={Boussard, Aur{\`e}le and Arrufat, Patrick and Dussutour, Audrey and P{\'e}rez-Escudero, Alfonso},
82
- journal={bioRxiv},
83
- pages={2024--03},
84
- year={2024},
85
- publisher={Cold Spring Harbor Laboratory}
86
- }
87
- ```
88
-
89
- ---
90
-
91
- ## 🧪 Testing
92
-
93
- Run unit tests with:
94
- ```bash
95
- pytest
96
- ```
97
-
98
- ---
99
-
100
- ## Resources
101
- - [Usage example (video)](https://www.youtube.com/watch?v=N-k4p_aSPC0)
1
+ <h1>
2
+ <img src="https://raw.githubusercontent.com/Aurele-B/cellects/main/.github/icon.png"
3
+ width="42"
4
+ style="vertical-align: middle; margin-right: 12px;">
5
+ Cellects: Cell Expansion Computer Tracking Software
6
+ </h1>
7
+
8
+ [![PyPI version](https://img.shields.io/pypi/v/cellects.svg?style=flat-square)](https://pypi.org/project/cellects/)
9
+ ![PyPI - Downloads](https://img.shields.io/pypi/dm/cellects)
10
+ [![Python versions](https://img.shields.io/pypi/pyversions/cellects.svg?style=flat-square)](https://pypi.org/project/cellects/)
11
+ [![License](https://img.shields.io/pypi/l/cellects.svg?style=flat-square)](https://github.com/Aurele-B/cellects/blob/main/LICENSE)
12
+ [![Stars](https://img.shields.io/github/stars/Aurele-B/cellects.svg?style=flat-square)](https://github.com/Aurele-B/cellects/stargazers)
13
+ ![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/Aurele-B/Cellects/.github%2Fworkflows%2Frelease.yml)
14
+ ![Coverage](https://raw.githubusercontent.com/Aurele-B/cellects/gh-pages/badges/coverage.svg)
15
+
16
+ Description
17
+ -----------
18
+
19
+ Cellects is a tracking software for organisms whose shape and size change over time.
20
+ Cellects’ main strengths are its broad scope of action, automated computation of a variety of geometrical descriptors,
21
+ easy installation and user-friendly interface.
22
+
23
+ <figure>
24
+ <img src="doc/static/UserManualFigure1.png" alt="Cellects first window"
25
+ style="display:block;float:none;margin-left:auto;margin-right:auto;width:100%">
26
+ <figcaption><strong>Figure 1:</strong> Cellects first window</figcaption>
27
+ </figure>
28
+
29
+ ---
30
+
31
+ ## 🚀 Installation (Short version)
32
+ Install using our Windows installer: [Cellects_installer.exe](https://github.com/Aurele-B/Cellects/releases/)
33
+
34
+ Or, install via pip:
35
+ ```bash
36
+ pip install cellects
37
+ ```
38
+ Any difficulties? follow our [complete installation tutorial](https://aurele-b.github.io/Cellects/installation/)
39
+
40
+ ---
41
+
42
+ ## 🎯 Quick Start
43
+ Run in terminal:
44
+ ```bash
45
+ Cellects
46
+ ```
47
+
48
+ ---
49
+
50
+ ## 📚 Documentation
51
+
52
+ Cellects' workflow is described in a [complete documentation](https://aurele-b.github.io/Cellects/). It includes:
53
+ - [**What is Cellects**](https://aurele-b.github.io/Cellects/what-is-cellects/): Purpose of the software, usable data and introduction of its user manual
54
+ - [**Setting up a first analysis**](https://aurele-b.github.io/Cellects/first-analysis/): Step-by-step workflows for data localization, image analysis and video tracking
55
+ - [**Improving the analysis**](https://aurele-b.github.io/Cellects/advanced/): Customization options, batch processing, parameter tuning.
56
+ - [**Use cases**](https://aurele-b.github.io/Cellects/use-cases/): Real-world cases using the GUI (interface) and the API (scripts).
57
+ - [**Contributing**](https://aurele-b.github.io/Cellects/contributing/): Report bugs and feature requests; contribute; testing and documentation processes.
58
+ - [**API Reference**](https://aurele-b.github.io/Cellects/api/): Auto-generated from source code docstrings (see [Build Documentation]).
59
+
60
+ ---
61
+
62
+ ## 🧪 Use Cases
63
+
64
+ See [use cases](https://aurele-b.github.io/Cellects/use-cases/) for real-world examples:
65
+ - Automated Physarum polycephalum tracking using GUI
66
+ - Automated Physarum polycephalum tracking using API
67
+ - Colony growth tracking
68
+
69
+ ---
70
+
71
+ ## 🛠 Contributing
72
+
73
+ We welcome contributions!
74
+ 1. Fork the repository and create a new branch.
75
+ 2. Submit issues/PRs via [GitHub](https://github.com/Aurele-B/cellects/issues).
76
+
77
+ For developer workflows, see [**Contributing**](https://aurele-b.github.io/Cellects/contributing/).
78
+
79
+ ---
80
+
81
+ ## 📌 License & Citation
82
+
83
+ GNU GPL3 License (see [LICENSE](https://github.com/Aurele-B/cellects/blob/main/LICENSE)).
84
+
85
+ To cite Cellects, use:
86
+ ```bibtex
87
+ @article{boussard2024cellects,
88
+ title={Cellects, a software to quantify cell expansion and motion},
89
+ author={Boussard, Aur{\`e}le and Arrufat, Patrick and Dussutour, Audrey and P{\'e}rez-Escudero, Alfonso},
90
+ journal={bioRxiv},
91
+ pages={2024--03},
92
+ year={2024},
93
+ publisher={Cold Spring Harbor Laboratory}
94
+ }
95
+ ```
96
+
97
+ ---
98
+
99
+ ## 🧪 Testing
100
+
101
+ Run unit tests with:
102
+ ```bash
103
+ pytest
104
+ ```
105
+
106
+ ---
107
+
108
+ ## Resources
109
+ - [Usage example (video)](https://www.youtube.com/watch?v=N-k4p_aSPC0)
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "cellects"
7
- version = "0.2.2"
7
+ version = "0.3.2"
8
8
  description = "Cell Expansion Computer Tracking Software."
9
9
  readme = "README.md"
10
10
  license = { file = "LICENSE" }
@@ -51,6 +51,9 @@ doc = [
51
51
  "mkdocs-gen-files",
52
52
  "mkdocs-autorefs",
53
53
  "pymdown-extensions",
54
+ "mkdocs-literate-nav",
55
+ "mkdocs-section-index",
56
+ "mkdocs-jupyter",
54
57
  ]
55
58
 
56
59
  [project.urls]