This function takes care of extracting basic information about iso_files, dealing with problems and making sure only valid fire formats are processed. This function is not typically called directly but indirectly by calling iso_read_dual_inlet, iso_read_continuous_flow and iso_read_scan. It is made available outside the package because it can be very useful for testing new file readers.
iso_read_files( paths, root, supported_extensions, data_structure, read_options = c(), reader_options = list(), discard_duplicates = TRUE, cache_files_with_errors = TRUE, parallel = FALSE, parallel_plan = future::multisession, parallel_cores = future::availableCores(), cache = default(cache), read_cache = default(cache), reread_outdated_cache = FALSE, quiet = default(quiet) )
one or multiple file/folder paths. All files must have a supported file extension. All folders are expanded and searched for files with supported file extensions (which are then included in the read). Paths can be absolute paths or relative to the provided file
root directory for the isofiles. Can be relative to the current working directory (e.g.
data frame with supported extensions and corresponding reader functions (columns 'extension', 'func', 'cacheable')
the basic data structure for the type of iso_file
vector of read options to be stored in the data structure (e.g.
list of parameters to be passed on to the reader
whether to automatically discard files with duplicate file IDs (i.e. duplicate file names). If
deprecated. Please use iso_reread_problem_files instead to selectively re-read all files in a collection of iso files that had been previously read with errors or warnings.
whether to process in parallel based on the number of available CPU cores. This may yield performance increases for files that are slow to parse such as continuous flow isodat files but usually provides little benefit for efficient data formats such as reading from R Data Archives.
which parallel processing strategy to use, see plan, typically
how many processor cores to use for parallel processing. By default the maximum available number of cores (availableCores), which will allow maximal processing speed but may slow other programs running on your machine. Choose a smaller number if you want some processing resources to remain available for other processes. Will issue a warning if too many cores are requested and reset to the maximum available.
whether to cache iso_files. Note that R Data Storage files (.rds, see iso_save) are never cached since they are already essentially in cached form.
whether to reload from cache if a cached version exists. Note that it will only read from cache if the raw data file has not been modified since. Files that have been modified on disc (e.g. edited in the vendor software) will always be read anew. To automatically reread cached files that were cached by an outdated version of the isoreader package, set the
whether to re-read outdated cache files whenever they are encountered.
whether to display (quiet=FALSE) or silence (quiet = TRUE) information messages. Set parameter to overwrite global defaults for this function or set global defaults with calls to iso_turn_info_messages_on and iso_turn_info_messages_off
single iso_file object (if single file) or list of iso_files (iso_file_list)