What's new
Preprocessing
We introduce a new preprocessing module, to correct the background of image stacks before segmentation. The user can choose among two background correction methods.
![preprocessing0](https://github.com/remyeltorro/celldetective/assets/50580806/1aa49585-0a0e-4456-be80-7b40dd025614)
- The first is to fit a 2D model (paraboloid, plane) to each image of the stacks where the non-homogeneous part is filtered out using a threshold on the STD-filtered image. This preprocessing was previously available in the measurement options, but the user could not export the preprocessed image. Both options are now possible.
- The second is a model-free estimate method for the background using the multi-position information to reconstruct a median background within a well. This is a typical background reconstruction method for interference microscopy images (IRM, RICM). The user can select an optimal frame range where cells are less likely to be visible, threshold the least homogeneous parts of the image with the STD-filter technique, and visualize the background reconstructed for each well. If the background is satisfying, it is applied to each image, with an automatic regression to accommodate slight focus loss and intensity variations within a well.
![preprocessing_model_free0](https://github.com/remyeltorro/celldetective/assets/50580806/5fe5dbb4-989a-473c-afc3-f7e8a98cc239)
![preprocessing_model_free_bg](https://github.com/remyeltorro/celldetective/assets/50580806/432c0371-5ab0-487b-ba24-324fbd65c91e)
![preprocessing_model_free_corrected](https://github.com/remyeltorro/celldetective/assets/50580806/60d9d41b-599e-4b2b-9c5e-356faa0b23d2)
Preprocessing protocols can be combined to preprocess independent channels differently. The output is a new stack with the "Corrected" prefix, which can be set as the stack of interest when performing segmentation and measurements.
Threshold-based cell classification
The classifier widget has been expanded with more options to classify tracked cells. The user can now classify cells according to their most likely state (median state), assuming no state change. This option is complementary to the previously implemented "irreversible event" that was able to describe a transition between two states.
![classifier_time_propagation](https://github.com/remyeltorro/celldetective/assets/50580806/86d6817b-85e1-43ca-9027-a3065adba44e)
Furthermore, you can now exclude a cell class from survival analysis.
Neighborhood
We introduce a new and intuitive neighborhood method that matches touching masks as neighbors. To accommodate ambiguities in cell-cell contacts, this type of neighborhood has a tolerance parameter: the border size dilation applied to the masks before neighborhood computation. The counting methods remain strictly identical to the isotropic distance method, introduced previously.
![neighborhood_options](https://github.com/remyeltorro/celldetective/assets/50580806/094ae57c-afe8-44e2-a263-8a52b9885071)
Log
Experimental: a logger is introduced with this version. A json is written in each position folder to keep track of how a position is processed.
Viewers
A viewer class is introduced to gradually replace all image viewers in Celldetective (except for napari). Several new viewers have been introduced to facilitate the setting of analysis parameters:
- a viewer next to the position list, in the control panel header, enables to preview the current stack
- several viewers help set threshold parameters a view preprocessing steps
- a viewer was augmented to set the contour distance in the measurement options
- a viewer was augmented to represent a circle of radius controlled with a slider to set an isotropic neighborhood or estimate cell size when calling a pre-trained Cellpose model
-
The viewers are accompanied by a scalebar either in µm or pixel depending on the purpose of the viewer.
Maintenance
- unitary tests for a large part of the Celldetective core
- code refactoring and layout subclasses
- widget behavior fixes, less crashes
- introduction of searchable combo boxes from superqt and colormap combo boxes
- bug fixes
Contributors
* ksenijader
* remyeltorro
**Full Changelog**: https://github.com/remyeltorro/celldetective/compare/v1.0.2...v1.1.0