Forget a dataset of My datasets

Remove one dataset from My datasets, as its Forget in My datasets › All... does: the entry and, for a file or folder of this computer, the browser's handle of it; its saved states only when asked. The dataset itself is not touched, and nothing brings the entry back but opening it again.

Usage

cellucid_my_datasets_forget(viewer, name, saved_states = FALSE)

Arguments

viewer

A viewer cellucid_view() or cellucid_serve() returned.

name

Its name in My datasets (datasets_list). Text (at least 1 character). Required.

saved_states

Also delete its saved states (histories kept in this browser). 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 handles (Handles of files of this computer forgotten with it), name (The dataset forgotten), saved_states (Its saved states deleted).

Details

The viewer's action my-datasets.forget (Datasets). 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_my_datasets_forget(viewer, name = "Pancreatic endocrinogenesis (scVelo)")
  print(request)
  # cellucid_action_result(request) waits for its outcome.
  cellucid_stop(viewer)
}