This function creates a flat tabular file of cell values and corresponding paths via path_enriched_df()
. It then
writes that data frame out as a tsv
file.
Usage
export_as_tsv(
tt,
file = NULL,
path_fun = collapse_path,
value_fun = collapse_values,
sep = "\t",
...
)
import_from_tsv(file)
Arguments
- tt
(
TableTree
or related class)
aTableTree
object representing a populated table.- file
(
string
)
the path of the file to written to or read from.- path_fun
(
function
)
function to transform paths into single-string row/column names.- value_fun
(
function
)
function to transform cell values into cells of adata.frame
. Defaults tocollapse_values
, which creates strings where multi-valued cells are collapsed together, separated by|
.- sep
(
string
)
defaults to\t
. Seeutils::write.table()
for more details.- ...
(
any
)
additional arguments to be passed toutils::write.table()
.
Value
export_as_tsv
returnsNULL
silently.import_from_tsv
returns adata.frame
with re-constituted list values.
Details
By default (i.e. when value_func
is not specified, list columns where at least one value has length > 1 are
collapsed to character vectors by collapsing the list element with "|"
.
Note
There is currently no round-trip capability for this type of export. You can read values exported this way back in
via import_from_tsv
but you will receive only the data.frame
version back, NOT a TableTree
.
See also
path_enriched_df()
for the underlying function that does the work.