Read raw data files (.raw
) from Orbitrap IRMS runs directly. This function extracts all available information and thus can be relatively slow (~1s / Mb on a typical personal computer) but with the caching this is only true the first time. The results can be used directly or, more typically, are aggregated with orbi_aggregate_raw()
to safely extract the relevant information for downstream processing. This function is designed to be fail save by safely catching errors and reporting back on them (see orbi_get_problems()
).
Usage
orbi_read_raw(
file_paths,
show_progress = rlang::is_interactive(),
show_problems = TRUE,
include_spectra = orbi_get_option("include_spectra"),
cache = TRUE,
read_cache = TRUE
)
Arguments
- file_paths
paths to the
.raw
file(s), single value or vector of paths. Useorbi_find_raw()
to get all raw files in a folder.- show_progress
whether to show a progress bar, by default always enabled when running interactively e.g. inside RStudio (and disabled in a notebook), turn off with
show_progress = FALSE
- show_problems
whether to show problems encountered along the way (rather than just keeping track of them with
orbi_get_problems()
). Set toshow_problems = FALSE
to turn off the live printout. Either way, all encountered problems can be retrieved with runningorbi_get_problems()
for the returned list- include_spectra
whether to include the whole spectral data in the returned tibble (makes it much larger and takes longer to read in)
- cache
whether to automatically cache the read raw files (writes highly efficient .parquet files in a folder with the same name as the file .cache appended)
- read_cache
whether to read the file from cached .parquet files (if they exist) or anew
Value
a tibble data frame where each row holds the file path and nested tibbles of datasets extracted from the raw file (typically file_info
, scans
, peaks
, and spectra
). This is the safest way to extract the data without needing to make assumptions about compatibility across files. Extract your data of interest from the tibble columns or use orbi_aggregate_raw()
to extract safely across files.