summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSuraj Yerramilli2015-06-06 21:23:07 +0530
committerSuraj Yerramilli2015-06-06 21:23:07 +0530
commit9f0119c7470bac5ff4d3dbaf0e0f3f73846f1760 (patch)
tree67bb65351780fdcb04cd5c0a0275a3e03633d7a4
parent89d18e89331dfcb33aa08ef79d04bf07ccc8e971 (diff)
downloadSysID-R-code-9f0119c7470bac5ff4d3dbaf0e0f3f73846f1760.tar.gz
SysID-R-code-9f0119c7470bac5ff4d3dbaf0e0f3f73846f1760.tar.bz2
SysID-R-code-9f0119c7470bac5ff4d3dbaf0e0f3f73846f1760.zip
Updated documentation for the data reading functions
-rw-r--r--R/readData.R18
-rw-r--r--man/read.idframe.Rd4
-rw-r--r--man/read.table.idframe.Rd10
-rw-r--r--man/read.xls.idframe.Rd4
4 files changed, 18 insertions, 18 deletions
diff --git a/R/readData.R b/R/readData.R
index ab8b4a9..1d63c8e 100644
--- a/R/readData.R
+++ b/R/readData.R
@@ -1,12 +1,12 @@
#' Data input into a idframe object
#'
-#' Read the contents of a \code{data.frame} object into a \code{idframe} object.
+#' Read the contents of a data.frame/matrix into a \code{idframe} object.
#'
#' @param data a \code{data.frame} object
#' @param freqData a logical value indicating whether the file contains the list of
#' frequencies. If \code{TRUE}, they need to be present in the first column.
#' (Default: \code{idframe})
-#' @param ninputs the number of input columns. (Default: NULL)
+#' @param ninputs the number of input columns. (Default: \code{NULL})
#' @param type indicates the domain of the data (Default:\code{"time"})
#' @param Ts sampling interval (Default: 1)
#' @param tUnit Time Unit (Default: "seconds")
@@ -48,7 +48,7 @@ read.idframe <- function(data,freqData=FALSE,ninputs=NULL,
return(out)
}
-#' Data input into a idframe object
+#' Read the contents of a table-formatted file
#'
#' Read the contents of an file in table format into a \code{idframe} object.
#'
@@ -58,7 +58,7 @@ read.idframe <- function(data,freqData=FALSE,ninputs=NULL,
#' @param header a logical value indicating whether the first row corresponding to
#' the first element of the rowIndex vector contains the names of the variables.
#' (Default: \code{TRUE})
-#' @param ninputs the number of input columns. (Default: 1)
+#' @param ninputs the number of input columns. (Default: \code{NULL})
#' @param type indicates the domain of the data (Default:\code{"time"})
#' @param Ts sampling interval (Default: 1)
#' @param freqData a logical value indicating whether the file contains the list of
@@ -69,8 +69,8 @@ read.idframe <- function(data,freqData=FALSE,ninputs=NULL,
#'
#' @details
#'
-#' The \code{readxlsx.idframe} function uses the \code{\link[utils]{read.table}} function,
-#' provided by the \pkg{xlsx} package, to read data from an excel file and then calls the
+#' The \code{read.table.idframe} function uses the \code{\link[utils]{read.table}} function,
+#' provided by the \pkg{utils} package, to read data from a table-formatted file and then calls the
#' \code{\link{read.idframe}} function to read the data into a idframe object
#'
#'
@@ -87,7 +87,7 @@ read.idframe <- function(data,freqData=FALSE,ninputs=NULL,
#'
#' @seealso \code{\link[utils]{read.table}}
#' @export
-read.table.idframe <- function(file,header=TRUE,sep=",",ninputs=1,
+read.table.idframe <- function(file,header=TRUE,sep=",",ninputs=NULL,
type=c("time","freq")[1],Ts = 1,freqData=FALSE,
tUnit="sec",...){
@@ -109,7 +109,7 @@ read.table.idframe <- function(file,header=TRUE,sep=",",ninputs=1,
#' @param header a logical value indicating whether the first row corresponding to
#' the first element of the rowIndex vector contains the names of the variables.
#' (Default: \code{TRUE})
-#' @param ninputs the number of input columns. (Default: 1)
+#' @param ninputs the number of input columns. (Default: \code{NULL})
#' @param type indicates the domain of the data (Default:\code{"time"})
#' @param Ts sampling interval (Default: 1)
#' @param freqData a logical value indicating whether the file contains the list of
@@ -143,7 +143,7 @@ read.table.idframe <- function(file,header=TRUE,sep=",",ninputs=1,
#'
#' @seealso \code{\link[xlsx]{read.xlsx2}}
#' @export
-read.xls.idframe <- function(file,sheetName,header=TRUE,ninputs=1,
+read.xls.idframe <- function(file,sheetName,header=TRUE,ninputs=NULL,
type=c("time","freq")[1],Ts = 1,freqData=FALSE,tUnit="time",
...){
diff --git a/man/read.idframe.Rd b/man/read.idframe.Rd
index 4bccd8e..216c074 100644
--- a/man/read.idframe.Rd
+++ b/man/read.idframe.Rd
@@ -14,7 +14,7 @@ read.idframe(data, freqData = FALSE, ninputs = NULL, type = c("time",
frequencies. If \code{TRUE}, they need to be present in the first column.
(Default: \code{idframe})}
-\item{ninputs}{the number of input columns. (Default: NULL)}
+\item{ninputs}{the number of input columns. (Default: \code{NULL})}
\item{type}{indicates the domain of the data (Default:\code{"time"})}
@@ -26,7 +26,7 @@ frequencies. If \code{TRUE}, they need to be present in the first column.
an idframe object
}
\description{
-Read the contents of a \code{data.frame} object into a \code{idframe} object.
+Read the contents of a data.frame/matrix into a \code{idframe} object.
}
\details{
If \code{type="freq"} and \code{freqData = TRUE}, then the first column in the file
diff --git a/man/read.table.idframe.Rd b/man/read.table.idframe.Rd
index d3b5605..73f4082 100644
--- a/man/read.table.idframe.Rd
+++ b/man/read.table.idframe.Rd
@@ -2,9 +2,9 @@
% Please edit documentation in R/readData.R
\name{read.table.idframe}
\alias{read.table.idframe}
-\title{Data input into a idframe object}
+\title{Read the contents of a table-formatted file}
\usage{
-read.table.idframe(file, header = TRUE, sep = ",", ninputs = 1,
+read.table.idframe(file, header = TRUE, sep = ",", ninputs = NULL,
type = c("time", "freq")[1], Ts = 1, freqData = FALSE, tUnit = "sec",
...)
}
@@ -18,7 +18,7 @@ the first element of the rowIndex vector contains the names of the variables.
\item{sep}{the field separator character. Values on each line of the file are
separated by this character. (Default: \code{","})}
-\item{ninputs}{the number of input columns. (Default: 1)}
+\item{ninputs}{the number of input columns. (Default: \code{NULL})}
\item{type}{indicates the domain of the data (Default:\code{"time"})}
@@ -39,8 +39,8 @@ an idframe object
Read the contents of an file in table format into a \code{idframe} object.
}
\details{
-The \code{readxlsx.idframe} function uses the \code{\link[utils]{read.table}} function,
-provided by the \pkg{xlsx} package, to read data from an excel file and then calls the
+The \code{read.table.idframe} function uses the \code{\link[utils]{read.table}} function,
+provided by the \pkg{utils} package, to read data from a table-formatted file and then calls the
\code{\link{read.idframe}} function to read the data into a idframe object
diff --git a/man/read.xls.idframe.Rd b/man/read.xls.idframe.Rd
index f4ba64c..2404b10 100644
--- a/man/read.xls.idframe.Rd
+++ b/man/read.xls.idframe.Rd
@@ -4,7 +4,7 @@
\alias{read.xls.idframe}
\title{Read the contents of a worksheet into a idframe object}
\usage{
-read.xls.idframe(file, sheetName, header = TRUE, ninputs = 1,
+read.xls.idframe(file, sheetName, header = TRUE, ninputs = NULL,
type = c("time", "freq")[1], Ts = 1, freqData = FALSE, tUnit = "time",
...)
}
@@ -17,7 +17,7 @@ read.xls.idframe(file, sheetName, header = TRUE, ninputs = 1,
the first element of the rowIndex vector contains the names of the variables.
(Default: \code{TRUE})}
-\item{ninputs}{the number of input columns. (Default: 1)}
+\item{ninputs}{the number of input columns. (Default: \code{NULL})}
\item{type}{indicates the domain of the data (Default:\code{"time"})}