Factory function to create a SOMA measurement for writing (lifecycle: maturing).
Usage
SOMAMeasurementCreate(
uri,
ingest_mode = c("write", "resume"),
platform_config = NULL,
tiledbsoma_ctx = NULL,
tiledb_timestamp = NULL
)Arguments
- uri
URI for the TileDB object.
- ingest_mode
Ingestion mode when creating the TileDB object; choose from:
“
write”: create a new TileDB object and error if it already exists.“
resume”: attempt to create a new TileDB object; if it already exists, simply open it for writing.
- platform_config
Optional platform configuration.
- tiledbsoma_ctx
Optional SOMATileDBContext.
- tiledb_timestamp
Optional Datetime (POSIXct) for TileDB timestamp.
Value
A new SOMA measurement stored at
uri opened for writing.
Examples
uri <- withr::local_tempfile(pattern = "soma-measurement")
var <- data.frame(
soma_joinid = bit64::seq.integer64(0L, 99L),
var_id = paste0("feature_", seq_len(100L))
)
sch <- arrow::infer_schema(var)
(ms <- SOMAMeasurementCreate(uri))
#> <SOMAMeasurement>
#> uri: /tmp/RtmpzG0UPS/soma-measurement29d255057615
sdf <- ms$add_new_dataframe(
"var",
sch,
"soma_joinid",
list(soma_joinid = c(0, 100))
)
sdf$write(arrow::as_arrow_table(var, schema = sch))
sdf$close()
ms$close()
(ms <- SOMAMeasurementOpen(uri))
#> <SOMAMeasurement>
#> uri: /tmp/RtmpzG0UPS/soma-measurement29d255057615
ms$var
#> <SOMADataFrame>
#> uri: file:///tmp/RtmpzG0UPS/soma-measurement29d255057615/var
#> dimensions: soma_joinid
#> attributes: var_id