Load Canvas State from File — sv_load

Deserializes a previously saved Sideview canvas workspace from a .json or .rds file and returns a sideview_state object. Optionally launches an interactive session.

Usage

sv_load_state(file, tables = NULL, launch = FALSE, format = NULL, ...)

Arguments

file: Path to the saved state file (.json or .rds).
tables: Optional named list of data frames or tables to associate with loaded cards. If NULL, the tables named by the saved cards are looked up in the calling environment (then every table there, as sv_find_tables() finds them).
launch: Logical; if TRUE and the session is interactive, launches sideview(tables, state = <loaded state>, ...) so cards, zoom, joins and the pipeline come back. If non-interactive, returns the loaded state object.
format: Optional format specification ("json" or "rds"). If NULL (default), the format is inferred from the file extension (.json or .rds).
...: Further arguments for sideview() when launch = TRUE (e.g. viewer).

Value

A sideview_state object of class c("sideview_state", "list"), or the gadget result if launch = TRUE in an interactive session.

Examples

st <- new_sideview_state()
tf <- tempfile(fileext = ".json")
sv_save_state(st, tf)
loaded <- sv_load_state(tf)
print(loaded)
#> <sideview_state v0.3.0>
#>   Cards:       0
#>   Connections: 0
#>   Canvas:      zoom = 1, pan = (0, 0)
#>   Active Tab:  pipeline
unlink(tf)