importFromFiles: Create a SingleCellExperiment object from files

View source: R/importFromFiles.R

importFromFilesR Documentation

Create a SingleCellExperiment object from files

Description

Create a SingleCellExperiment object from files

Usage

importFromFiles(
  assayFile,
  annotFile = NULL,
  featureFile = NULL,
  assayName = "counts",
  inputDataFrames = FALSE,
  class = c("Matrix", "matrix"),
  delayedArray = FALSE,
  annotFileHeader = FALSE,
  annotFileRowName = 1,
  annotFileSep = "\t",
  featureHeader = FALSE,
  featureRowName = 1,
  featureSep = "\t",
  gzipped = "auto",
  rowNamesDedup = TRUE
)

Arguments

assayFile

The path to a file in .mtx, .txt, .csv, .tab, or .tsv format.

annotFile

The path to a text file that contains columns of annotation information for each cell in the assayFile. This file should have the same number of rows as there are columns in the assayFile. If multiple samples are represented in the dataset, this should be denoted by a column called 'sample' within the annotFile.

featureFile

The path to a text file that contains columns of annotation information for each gene in the count matrix. This file should have the same genes in the same order as assayFile. This is optional.

assayName

The name of the assay that you are uploading. The default is "counts".

inputDataFrames

If TRUE, assayFile, annotFile and featureFile should be data.frames object (or its inheritance) instead of file paths. The default is FALSE.

class

Character. The class of the expression matrix stored in the SCE object. Can be one of "Matrix" (as returned by readMM function), or "matrix" (as returned by matrix function). Default "Matrix".

delayedArray

Boolean. Whether to read the expression matrix as DelayedArray object or not. Default FALSE.

annotFileHeader

Whether there's a header (colnames) in the cell annotation file. Default is FALSE.

annotFileRowName

Which column is used as the rownames for the cell annotation file. This should match to the colnames of the assayFile. Default is 1 (first column).

annotFileSep

Separater used for the cell annotation file. Default is "\t".

featureHeader

Whether there's a header (colnames) in the feature annotation file. Default is FALSE.

featureRowName

Which column is used as the rownames for the feature annotation file. This should match to the rownames of the assayFile. Default is 1. (first column).

featureSep

Separater used for the feature annotation file. Default is "\t".

gzipped

Whether the input file is gzipped. Default is "auto" and it will automatically detect whether the file is gzipped. Other options are TRUE or FALSE.

rowNamesDedup

Boolean. Whether to deduplicate rownames. Default TRUE.

Details

Creates a SingleCellExperiment object from a counts file in various formats, and files of cell and feature annotation.

Value

a SingleCellExperiment object


compbiomed/singleCellTK documentation built on Oct. 27, 2024, 3:26 a.m.