Serializes the essential components of an ImmunData object to disk for
efficient storage and later retrieval. It saves the core annotation data
(idata$annotations) as a compressed Parquet file and accompanying metadata
(including receptor/repertoire schemas and package version) as a JSON file
within a specified directory.
write_immundata(idata, output_folder)The ImmunData object to save. Must be an R6 object of class
ImmunData containing at least the $annotations table and schema information
($schema_receptor, optionally $schema_repertoire).
Character(1). Path to the directory where the output files will be written. If the directory does not exist, it will be created recursively.
Invisibly returns the input idata object. Its primary effect is creating
metadata.json and annotations.parquet files in the output_folder.
The function performs the following actions:
Validates the input idata object and output_folder path.
Creates the output_folder if it doesn't exist.
Constructs a list containing metadata: immundata package version,
receptor schema (idata$schema_receptor), and repertoire schema
(idata$schema_repertoire).
Writes the metadata list to metadata.json within output_folder.
Writes the idata$annotations table (a duckplyr_df or similar) to
annotations.parquet within output_folder. Uses Zstandard compression
(compression = "zstd", compression_level = 9) for a good balance
between file size and read/write speed.
Uses internal helper imd_files() to determine the standard filenames
(metadata.json, annotations.parquet).
The receptor data itself (if stored separately in future versions) is not saved by this function; only the annotations linking to receptors are saved, along with the schema needed to reconstruct/interpret them.
read_immundata() for loading the saved data, read_repertoires()
which uses this function internally, ImmunData class definition.
if (FALSE) { # \dontrun{
# Assume 'my_idata' is an ImmunData object created previously
# my_idata <- read_repertoires(...)
# Define an output directory
save_dir <- tempfile("saved_immundata_")
# Save the ImmunData object
write_immundata(my_idata, save_dir)
# Check the created files
list.files(save_dir) # Should show "annotations.parquet" and "metadata.json"
# Clean up
unlink(save_dir, recursive = TRUE)
} # }