plot_growth_attr: Plot raw growth curves of an attribute

Description Usage Arguments Details

Description

Plots the raw single-cell growth curves (unfitted time-series data) of a numeric attribute for a set of given cells in a division tree.

Usage

1
2
3
plot_growth_attr(DT, LT, attr, unit = "", cells = "all", Nframes,
  save = FALSE, savePars = list(w = 2500, h = 2000, res = 300, path =
  getwd(), name = "my_growth_attr"))

Arguments

DT

The division tree where the cells specified in cells belong, an object of class "igraph".

LT

The corresponding lineage tree of the DT, an object of class "igraph".

attr

The name of the attribute in the LT, a character string. It can be any numeric attribute, as returned from get_attr_names, except for "colony", "generation", "frame" and "age".

unit

The unit of attr, a character string. It should be in the format "<string>,<number>", where ",<number>" represents the power and is optional (e.g. "m" for meters and "cm,3" for cubic centimeters). The default value is the empty character "", which implies that attr is in arbitrary units.

cells

The labels of the cells in the DT whose growth curve will be plotted, a vector of character strings. They can be any cells that are included in the analysis, as returned from get_cells. The default value "all" stands for all cells in the DT.

Nframes

Number of frames in the movie, a non-zero positive integer value.

save

A logical value (TRUE or FALSE) indicating whether the generated plot will be saved in a .png file or displayed in the Plots Pane of RStudio, respectively. The default value is FALSE.

savePars

A named list specifying the parameters of the generated image file. This argument is ignored in case save = FALSE. Elements of the list are the following:

w

The width of the image file in pixels, a non-zero positive integer value. The default value is 2500.

h

The height of the image file in pixels, a non-zero positive integer value. The default value is 2000.

res

The resolution of the image file in pixels per inch (ppi), a non-zero positive integer value. The smaller this value, the larger the plot area in inches, and the smaller the text relative to the graph itself. The default value is 300.

path

A character string naming the directory where the image file will be saved (excluding the last "/"). If it does not contain an absolute path, the image file will be saved relative to the current working directory getwd(). The default value is the current working directory getwd().

NOTE: The components should be separated by "/" on Windows.

name

The image file name, a character string. The suffix ".png" is added automatically. The default value is "my_growth_attr".

Details

A common plot for all cells specified in cells is generated.

x-axis represents the time in frames, from the start (value 1) to end of the movie (value Nframes).

Each single-cell growth curve is randomly colored.


vicstefanou/ViSCA documentation built on May 31, 2019, 10:50 p.m.