get_cand_mother_cells: Find candidate mothers
In vicstefanou/ViSCA: Cell-Movie Analysis and Visualization

Description Usage Arguments Value Prerequisites See Also

Returns the candidate mother cells for the root of a motherless branch in a lineage tree.

1 2	get_cand_mother_cells(branch, LT, Nd = 1, Ncands = 5, cell_list, col_list, Ncols, show = FALSE)

`branch`	The connected lineage tree (motherless branch) for which to find candidate mothers, an object of class `"igraph"`.
`LT`	The lineage tree where the candidate mothers of the `branch` will belong, an object of class `"igraph"`.
`Nd`	Maximum number of daughters for a cell in the `LT` to be considered as a candidate mother, a positive integer value. The default value is `1`.
`Ncands`	Maximum number of candidate mothers to be returned, a non-zero positive integer value. The default value is `5`. Use value `NULL` to return all candidate mothers.
`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.
`show`	A logical value (`TRUE` or `FALSE`) indicating whether `view_cell` will be called for the root of the `branch` and the candidate mothers. This capability is useful in order to choose the desired mother cell and call `add_branch`. The default value is `FALSE`. See the Prerequisites section of `view_cell` in order to be able to use value `TRUE`.

The labels of the candidate mothers, a vector of character strings. Candidate mothers are sorted by ascending distance between their centroid and the centroid of the root of the branch, which implies best matching. In case no candidate mothers are found, NULL is returned.

This function can be used by BaSCA users, importing the data with import_basca.

Users of Oufti or SuperSegger who imported the data with import_oufti or import_ss, respectively, are excluded from using this function, as no colony list was returned.

If import_json was used for importing the data, it is necessary that cell list elements have the centroid and colId components and colony list elements have the ULcorner component. See import_json for more details. In other case, this function cannot be used (throws an error).