split_cell: Split a cell
In vicstefanou/ViSCA: Cell-Movie Analysis and Visualization

Description Usage Arguments Details Value Prerequisites See Also

Splits a cell in a lineage tree.

1 2	split_cell(LT, cell, Nsplit = 2, cell_list, col_list, Ncols, pixelR, matFolder = getwd(), matFileName, exeFolder, mcrFolder, show = TRUE)

`LT`	The lineage tree where the cell specified in `cell` belongs, an object of class `"igraph"`.
`cell`	The label of the cell in the `LT` to be splitted, a character string. It can be any non-root cell, as returned from `get_cells`.
`Nsplit`	Number of cells for the `cell` to be splitted, an integer value `>=2`. The default value is `2`.
`cell_list`	A list containing all the cell instants of the movie.
`col_list`	A list containing all the colony instants of the movie.
`Ncols`	Number of colonies in the movie, a non-zero positive integer value.
`pixelR`	The pixel ratio in units of length, a non-zero positive numeric value.
`matFolder`	A character string naming the absolute path of the directory where the `.mat` file generated by BaSCA is saved (excluding the last `"/"`). The default value is the current working directory `getwd()`. NOTE: The components should be separated by `"/"` on Windows.
`matFileName`	A character string naming the `.mat` file generated by BaSCA (including the suffix `".mat"`). The filename is relative to the `matFolder`.
`exeFolder`	A character string naming the absolute path of the installation folder of the MATLAB executable (excluding the last `"/"`). NOTE: The components should be separated by `"/"` on Windows.
`mcrFolder`	A character string naming the absolute path of the installation folder of the Matlab Compiler Runtime (MCR) (excluding the last `"/"`). NOTE: The components should be separated by `"/"` on Windows.
`show`	A logical value (`TRUE` or `FALSE`) indicating whether `view_cell` will be called for the mother of the `cell` (if it exists), the `cell` before the split operation and the resulting cells after the split operation. This capability is useful in order to see the result of the function. The default value is `TRUE`.

There is no guarantee that cell will be indeed splitted into Nsplit cells. After the split operation, the resulting cells are sorted by ascending distance between their centroid and the centroid of their mother, if it exists. Otherwise, the order of the resulting cells is random. The original cell is replaced in both LT and cell_list by the first listed cell, which implies best matching. For each one of the remaining resulting cells a single-node (connected) lineage tree (motherless branch) is automatically created.

A named list with the following components:

`LT`	The updated LT with the `cell` replaced, an object of class `"igraph"`.
`cell_list`	The updated cell_list with the `cell` replaced and the rest resulting cells added.
`branches`	A list with the single-node (connected) lineage trees for each one of the rest resulting cells Each branch (element of the list) is an object of class `"igraph"`.