Verify a branch

Replay a branch on this dataset into a scratch tracker and compare every part of the state at the end with its last step: reproduced exactly, or the first step whose values differ.

Usage

cellucid_history_verify(viewer, branch, keep = FALSE, 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.

keep

Keep the scratch tracker afterwards. TRUE or FALSE. Default FALSE, the viewer's own.

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 domains (Each part of the state that differs), reproduced, scratch, steps (Steps replayed).

Details

The viewer's action history.verify (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_verify(viewer, branch = "Main")
  print(request)
  # cellucid_action_result(request) waits for its outcome.
  cellucid_stop(viewer)
}