man/importFromFiles.Rd
8ff6b7d2
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/importFromFiles.R
 \name{importFromFiles}
 \alias{importFromFiles}
 \title{Create a SingleCellExperiment object from files}
 \usage{
 importFromFiles(
   assayFile,
   annotFile = NULL,
   featureFile = NULL,
   assayName = "counts",
   inputDataFrames = FALSE,
   class = c("Matrix", "matrix"),
89401f07
   delayedArray = FALSE,
   annotFileHeader = FALSE,
   annotFileRowName = 1,
   annotFileSep = "\\t",
   featureHeader = FALSE,
   featureRowName = 1,
   featureSep = "\\t",
dfe50c33
   gzipped = "auto",
   rowNamesDedup = TRUE
8ff6b7d2
 )
 }
 \arguments{
dfe50c33
 \item{assayFile}{The path to a file in .mtx, .txt, .csv, .tab, or .tsv 
 format.}
8ff6b7d2
 
 \item{annotFile}{The path to a text file that contains columns of annotation
dfe50c33
 information for each cell in the \code{assayFile}. This file should have the 
 same number of rows as there are columns in the \code{assayFile}. If multiple
 samples are represented in the dataset, this should be denoted by a column 
 called \code{'sample'} within the \code{annotFile}.}
8ff6b7d2
 
 \item{featureFile}{The path to a text file that contains columns of
 annotation information for each gene in the count matrix. This file should
dfe50c33
 have the same genes in the same order as \code{assayFile}. This is optional.}
8ff6b7d2
 
 \item{assayName}{The name of the assay that you are uploading. The default
dfe50c33
 is \code{"counts"}.}
8ff6b7d2
 
dfe50c33
 \item{inputDataFrames}{If \code{TRUE}, \code{assayFile}, \code{annotFile} and
 \code{featureFile} should be \code{data.frames} object (or its inheritance) 
 instead of file paths. The default is \code{FALSE}.}
8ff6b7d2
 
 \item{class}{Character. The class of the expression matrix stored in the SCE
dfe50c33
 object. Can be one of \code{"Matrix"} (as returned by
 \link{readMM} function), or \code{"matrix"} (as returned by
 \link[base]{matrix} function). Default \code{"Matrix"}.}
8ff6b7d2
 
 \item{delayedArray}{Boolean. Whether to read the expression matrix as
969718f9
 \link{DelayedArray} object or not. Default \code{FALSE}.}
89401f07
 
dfe50c33
 \item{annotFileHeader}{Whether there's a header (colnames) in the cell 
 annotation file. Default is \code{FALSE}.}
89401f07
 
dfe50c33
 \item{annotFileRowName}{Which column is used as the rownames for the cell 
 annotation file. This should match to the colnames of the \code{assayFile}. 
 Default is \code{1} (first column).}
89401f07
 
dfe50c33
 \item{annotFileSep}{Separater used for the cell annotation file. Default is 
 \code{"\\t"}.}
89401f07
 
dfe50c33
 \item{featureHeader}{Whether there's a header (colnames) in the feature 
 annotation file. Default is \code{FALSE}.}
89401f07
 
dfe50c33
 \item{featureRowName}{Which column is used as the rownames for the feature 
 annotation file. This should match to the rownames of the \code{assayFile}. 
 Default is \code{1}. (first column).}
89401f07
 
dfe50c33
 \item{featureSep}{Separater used for the feature annotation file. Default is 
 \code{"\\t"}.}
89401f07
 
dfe50c33
 \item{gzipped}{Whether the input file is gzipped. Default is \code{"auto"} 
 and it will automatically detect whether the file is gzipped. Other options 
 are \code{TRUE} or \code{FALSE}.}
 
 \item{rowNamesDedup}{Boolean. Whether to deduplicate rownames. Default 
 \code{TRUE}.}
8ff6b7d2
 }
 \value{
dfe50c33
 a \linkS4class{SingleCellExperiment} object
8ff6b7d2
 }
 \description{
dfe50c33
 Create a SingleCellExperiment object from files
 }
 \details{
 Creates a \linkS4class{SingleCellExperiment} object from a counts 
 file in various formats, and files of cell and feature annotation.
8ff6b7d2
 }