Skip to contents

Remove what this browser keeps

cellucid_stored_remove.Rd

Remove what the Stored dialog removes: kept items by id, all a dataset's kept items, every saved state, My datasets (the list and the files' handles), the connection speeds, the decoder choices, or everything (Remove all). An item an open tab uses stays until that tab closes. Nothing brings it back; the dataset opens again more slowly the first time.

Usage

cellucid_stored_remove(
  viewer,
  connection_speeds = FALSE,
  dataset,
  decoder_choices = FALSE,
  everything = FALSE,
  items,
  my_datasets = FALSE,
  saved_states = FALSE
)

Arguments

viewer

A viewer cellucid_view() or cellucid_serve() returned.

connection_speeds

The connection speeds remembered per host. TRUE or FALSE. Default FALSE, the viewer's own.

dataset

Every kept item of the dataset with this file name (stored_list). Text (at least 1 character). Left out unless given (the viewer then chooses as its own control does).

decoder_choices

The decoder choices measured in this browser. TRUE or FALSE. Default FALSE, the viewer's own.

everything

Everything no open tab uses, as Remove all. TRUE or FALSE. Default FALSE, the viewer's own.

items

Kept items by id (stored_list). A vector or list of text (at least 1 character) (at least 1 item, each once). Left out unless given (the viewer then chooses as its own control does).

my_datasets

My datasets: the list and the handles of its files (my_datasets_forget forgets one). TRUE or FALSE. Default FALSE, the viewer's own.

saved_states

Every saved state of this browser (history_saved_delete deletes one). TRUE or FALSE. Default FALSE, the viewer's own.

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 connection_speeds (Hosts whose connection speed was forgotten), decoder_choices (Decoder choices forgotten), held (Kept items that stay, in use by an open tab), my_datasets (Datasets forgotten from My datasets), removed (Kept items removed), said (What the dialog says of it), saved_states (Saved states deleted).

Details

The viewer's action stored.remove (Stored). It acts outside the viewer's state and history (a file the person receives in the browser, a publication, or what the browser keeps for later visits), which Undo does not take back: it makes no step of the history.

When an agent (Claude, ChatGPT) runs it, the viewer asks the person first (deletes-saved); from R it is not asked.

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_stored_remove(viewer)
  print(request)
  # cellucid_action_result(request) waits for its outcome.
  cellucid_stop(viewer)
}