CellSegAnalysis 0.1.0

CellSeg is cell segmentation shape analysis library

CellSeg

A generalist algorithm to analyse cell shape from 3D labeled image.

This code is made to analyse cell shape from 3D labeled image. It is divide in three parts:

• Prerequisite that will create image containing one cell. This is mandatory to fasten the following analysis.
• We determine edges and faces associated to each cell. Quality of this analysis is dependant of the quality of the labeled image. There is no segmentation correction.
• Analysis of cells, faces and edges.

There is a Python API to allow user to integrate CellSeg into your custom workflow.

Input/Output and datas organisation

Input

In order to be able to use this project. You first need to segment you image using CellPose (or any other software that gives 3D label image). You need to be satisfied by your label image, since there is no manual correction (only filter can be apply to remove cells that has a volume below a threshold for example).
Then, you can perform 3D cell segmentation with CellSeg.

Output and datas organisation

You can generate ply/obj file for each cells.

Datas are organised as half-edge structures. The vertex, edge, face and cell tables are interconnected to represent and navigate through the mesh's elements.

We generate 7 csv files, that can be populated later during the analysis part. - __cell_df.csv__ contains measure relative to the cell, such as volume, number of neighbours, orientation, curvature - __cell_plane_df.csv__ contains plane measure, such as orientation, anisotropy, area, perimeter - __edge_df.csv__ contains measure relative to the edge such as length (real & shortest), curvature, the 3 connected cells - __edge_pixel_df.csv__ contains pixels coordinates of each edge and the 3 connected cells - __face_df.csv__ contains coordinates of the middle of the face, the lengths, the angles - __face_edge_pixel_df.csv__ contains coordinates of the edges associated to the face, and the coordinates of the middle of the face - __face_pixel_df.csv__ contains pixels coordinates of each face and the 2 connected cells and edges

Prerequisite

It creates two folders names "npz" and "obj_mesh" that stores numpy array of binary one cell image and ply/obj file of each cell respectively. npz file are mandatory for the analyse, while obj_mesh allows to visualise cells in 3D with Blender. All files are named after the cell id in the original image.

Segmentation

This part consists of analysing the labelled image in order to determine neighbouring relationship between cells; contact between two cells (i.e. face); contact between three cells (i.e. edge).

Analysis

Cell information (cell_df.csv)

Volume $vol_c=nb_{pixel}*voxel_{size}$ Coordinate of line in the middle of the cell : $mid_{line}$ Real distance of $mid_{line}$ : $D_r$ Short distance of $mid_{line}$ : $D_s$ Curvature index $1-(D_s/D_r)$

Cell plane information (cell_plane.csv)

Plane measure : Anisotropy $major/minor$ Orientation $\alpha = arctan2(y_orient/x_orient)$ Area Perimeter

Edge information (edge_df.csv)

• Real distance $D_r$
• Short distance $D_s$
• Curvature index $1-(D_s/D_r)$

Face information (face_df.csv)

:warning: Only lateral face (coloured face in scheme) id of cell1 & cell2 id of edge1 & edge2 Centre of the face Width Angles (reference: centre of the face)

Install

See INSTALL.md for a step by step install.

Troubleshooting

Kernel crash due to lack of memory: reduce the number of core used for parallelized task.

Roadmap

• Add GUI with python or as a Napari plugin