R: Import Data

import {strvalidator}

R Documentation

Import Data

Description

Import text files and apply post processing.

Usage

import(
  folder = TRUE,
  extension = "txt",
  suffix = NA,
  prefix = NA,
  import.file = NA,
  folder.name = NA,
  file.name = TRUE,
  time.stamp = TRUE,
  separator = "\t",
  ignore.case = TRUE,
  auto.trim = FALSE,
  trim.samples = NULL,
  trim.invert = FALSE,
  auto.slim = FALSE,
  slim.na = TRUE,
  na.strings = c("NA", ""),
  debug = FALSE
)

Arguments

`folder`	logical, TRUE all files in folder will be imported, FALSE only selected file will be imported.
`extension`	string providing the file extension.
`suffix`	string, only files with specified suffix will be imported.
`prefix`	string, only files with specified prefix will be imported.
`import.file`	string if file name is provided file will be imported without showing the file open dialogue.
`folder.name`	string if folder name is provided files in folder will be imported without showing the select folder dialogue.
`file.name`	logical if TRUE the file name is written in a column 'File.Name'. NB! Any existing 'File.Name' column is overwritten.
`time.stamp`	logical if TRUE the file modified time stamp is written in a column 'Time'. NB! Any existing 'Time' column is overwritten.
`separator`	character for the delimiter used to separate columns (see 'sep' in `read.table` for details).
`ignore.case`	logical indicating if case should be ignored. Only applies to multiple file import option.
`auto.trim`	logical indicating if dataset should be trimmed.
`trim.samples`	character vector with sample names to trim.
`trim.invert`	logical to keep (TRUE) or remove (FALSE) samples.
`auto.slim`	logical indicating if dataset should be slimmed.
`slim.na`	logical indicating if rows without data should remain.
`na.strings`	character vector with strings to be replaced by NA.
`debug`	logical indicating printing debug information.

Details

Imports text files (e.g. GeneMapper results exported as text files) as data frames. Options to import one or multiple files. For multiple files it is possible to specify prefix, suffix, and file extension to create a file name filter. The file name and/or file time stamp can be imported. NB! Empty strings ("") and NA strings ("NA") are converted to NA. See list.files and read.table for additional details.

Value