Apply a branch's steps here

Apply a branch's own steps again, by name, on top of the step shown, as a new branch (no values are merged; a step that does not apply here is flagged).

Usage

cellucid_history_branch_apply(viewer, branch, name, tracker)

Arguments

viewer

A viewer cellucid_view() or cellucid_serve() returned.

branch

A branch by its name or its id (history_summary lists them). Text (at least 1 character). Required.

name

A name, unique among its kind (compared without case and extra spaces); no length limit. Text (at least 1 character). Left out unless given (the viewer then chooses as its own control does).

tracker

A tracker by its name or its id (history_summary lists them); the tracker in use when left out. Text (at least 1 character). Left out unless given (the viewer then chooses as its own control does).

Value

A cellucid_action_request, at once and invisibly: the action is sent now, or when the viewer's channel opens. cellucid_action_result(request) returns its outcome: a list of branch, head (The step shown now), report (Every step replayed and what became of it).

Details

The viewer's action history.branch.apply (History). It moves the viewer's history, as the person's Undo, Redo or a click on a step does: it makes no step of the history.

See also

cellucid_act() sends any action by its type, and cellucid_action_result() collects its answer.

Examples

if (interactive() && requireNamespace("SeuratObject", quietly = TRUE)) {
  data("pbmc_small", package = "SeuratObject")
  viewer <- cellucid_view(SeuratObject::UpdateSeuratObject(pbmc_small))
  request <- cellucid_history_branch_apply(viewer, branch = "Main")
  print(request)
  # cellucid_action_result(request) waits for its outcome.
  cellucid_stop(viewer)
}