Browse code

remove documentation for non-existent classes; tidy description

git-svn-id: file:///home/git/hedgehog.fhcrc.org/bioconductor/trunk/madman/Rpacks/Streamer@68642 bc3139a8-67e5-0310-9ffc-ced21a209358

Martin Morgan authored on 20/08/2012 21:23:46
Showing 3 changed files

... ...
@@ -17,7 +17,6 @@ License: Artistic-2.0
17 17
 LazyLoad: yes
18 18
 Imports: methods, graph, parallel
19 19
 Suggests: RUnit, Rsamtools (>= 1.5.53)
20
-Enhances: multicore
21 20
 biocViews: Infrastructure, DataImport
22 21
 Collate: 
23 22
   generics.R OldClass.R Streamer.R
24 23
deleted file mode 100644
... ...
@@ -1,106 +0,0 @@
1
-\name{NetCDFFile-class}
2
-
3
-\Rdversion{1.1}
4
-\docType{class}
5
-
6
-\alias{NetCDFFile-class}
7
-\alias{NetCDFFile}
8
-\alias{precision}
9
-\alias{dimensions}
10
-\alias{precision,NetCDFFile-method}
11
-\alias{dimensions,NetCDFFile-method}
12
-
13
-\title{Class "NetCDFFile"}
14
-
15
-\description{
16
-
17
-  A \code{\linkS4class{NetCDFFile}}-class to interpret data stored in
18
-  NetCDF files. Users interact with this class through the constructor
19
-  \code{\link{NetCDFFile}} and methods \code{\link{precision}}, and
20
-  \code{\link{dimensions}}.
21
-
22
-}
23
-
24
-\usage{
25
-NetCDFFile(file = character(), ...)
26
-\S4method{dimensions}{NetCDFFile}(x, ...)
27
-\S4method{precision}{NetCDFFile}(x, ...)
28
-}
29
-
30
-\arguments{
31
-
32
-  \item{file}{A character string for the path to the NetCDF file.}
33
-
34
-  \item{x}{An insance of the \code{NetCDFFile} class.}
35
-
36
-  \item{...}{Additional arguments, passed to the \code{$new} method of
37
-    this class. Currently ignored.}
38
-
39
-}
40
-
41
-\section{Class Methods}{
42
-  \describe{
43
-
44
-    \item{\code{precision()}:}{Returns a named character vector
45
-      corresponding to the storage precision of the variables in the
46
-      NetCDF file.}
47
-
48
-    \item{\code{dimensions()}:}{Returns a named \code{list} containing
49
-      the names and lengths of the dimensions for each variable in the
50
-      NetCDF file.}
51
-
52
-  }
53
-}
54
-
55
-\section{Class Internal Fields: (For developers)}{
56
-  \describe{
57
-
58
-    \item{\code{con}:}{Object of class \code{ncdf4}. An R ncdf4
59
-      connection obtained by opening a NetCDF file from which data is to
60
-      be read using the \code{nc_open} function.}
61
-
62
-    \item{\code{dimensions}:}{A named \code{list} corresponding to the
63
-      names of the variables in the NetCDF file. Each element of the
64
-      \code{list} is a named integer vector, with names of the
65
-      dimensions for each variable and values the length of the
66
-      dimension in the NetCDF file.}
67
-
68
-    \item{\code{precision}:}{A named character vector of the number of
69
-      precision for each variable stored in the NetCDF file.}
70
-
71
-  }
72
-}
73
-
74
-\section{Class Internal Methods: (For developers)}{
75
-  \describe{
76
-
77
-    \item{\code{initialize(file=character(), ...)}:}{Called during
78
-      object creation with \code{file} being the path to a valid NetCDF
79
-      file.}
80
-
81
-    \item{\code{getPath()}:}{Retrive the path to the NetCDF file.}
82
-
83
-    \item{\code{getDimensions()}:}{Retrieves a list of variables, with
84
-      each element in the list containing a named integer vector of
85
-      dimensions and their lengths.}
86
-
87
-    \item{\code{getPrecision()}:}{Retrieves the precision of each
88
-      variable in the NetCDF file.}
89
-
90
-  }
91
-}
92
-
93
-\author{Nishant Gopalakrishnan \url{ngopalak@fhcrc.org}}
94
-
95
-\seealso{\code{\link{stream}}}
96
-
97
-\examples{
98
-\dontrun{
99
-pth <- system.file("extdata", "NetCDFData.nc", package = "Streamer")
100
-ncFile <- NetCDFFile(pth)
101
-dimensions(ncFile)
102
-precision(ncFile)
103
-ncFile
104
-}
105
-}
106
-\keyword{classes}
107 0
deleted file mode 100644
... ...
@@ -1,142 +0,0 @@
1
-\name{NetCDFInput-class}
2
-
3
-\Rdversion{1.1}
4
-\docType{class}
5
-
6
-\alias{NetCDFInput-class}
7
-\alias{NetCDFInput}
8
-\alias{dimensions,NetCDFInput-method}
9
-
10
-\title{Class "NetCDFInput"}
11
-
12
-\description{
13
-
14
-  A \code{\linkS4class{NetCDFInput}}-class to retrieve data store in
15
-  NetCDF files. Users interact with this class through the constructor
16
-  \code{\link{NetCDFInput}} and methods \code{\link{yield}},
17
-  \code{\link{status}}, and \code{\link{reset}}.
18
-
19
-}
20
-
21
-\usage{
22
-NetCDFInput(ncdf, var, slice, ..., verbose = FALSE)
23
-\S4method{dimensions}{NetCDFInput}(x, ...)
24
-}
25
-
26
-\arguments{
27
-
28
-  \item{ncdf}{An object of class \code{NetCDFFile} rrepresenting the
29
-    file from which data is to be read.}
30
-
31
-  \item{var}{A \code{character(1)} string naming the variable to be read
32
-    from the NetCDF file.}
33
-
34
-  \item{slice}{A named integer vector specifying the slice to be
35
-    iterated over. The names correspond to dimensions of \code{var}, the
36
-    values to the number of elements to be retrieved with each
37
-    \code{yield}.}
38
-
39
-  \item{...}{Additional arguments, passed to the \code{$new} method of
40
-    this class. Currently ignored.}
41
-
42
-  \item{verbose}{\code{logical(1)} indicating whether class methods
43
-    should report to the user.}
44
-
45
-  \item{x}{An instance of the \code{NetCDFInput} class.}
46
-
47
-}
48
-
49
-\section{Class Methods}{
50
-
51
-  \describe{
52
-
53
-    \item{\code{dimensions()}:}{Return the dimensions associated with
54
-      the variable this object is iterating over.}
55
-
56
-    \item{\code{yield()}:}{Processes the NetCDF file and retrieves a
57
-      matrix of data from the NetCDF file corresponding to the slice
58
-      size that has been set.  Repeated calls to the \code{yield}
59
-      function retrieves the next block of data until the end of file
60
-      has been reached.}
61
-
62
-    \item{\code{reset()}:}{Resets the cursor that tracks the next block
63
-      of data to be read to the start of the file.}
64
-
65
-     \item{\code{status()}:}{Returns a named numeric vector for the
66
-       position of the start of the block from which data will be read
67
-       for the next call to the \code{yield} function.}
68
-
69
-  }
70
-}
71
-
72
-\section{Class Internal Fields: (For developers)}{
73
-  \describe{
74
-
75
-    \item{\code{ncdf}:}{An object of class \code{NetCDFFile} from which
76
-      data is being read.}
77
-
78
-    \item{\code{name}:}{A \code{character(1)} specifying the name of
79
-      the variable that is being read.}
80
-
81
-    \item{\code{slice}:}{A named numeric vector specifying the size of
82
-      the chunk of data that will be retrived along each dimension using
83
-      the \code{yield} method.}
84
-
85
-    \item{\code{start}:}{A named numeric vector specifying the position
86
-      along each dimension from which data will start to be read for the
87
-      next call to the \code{yield} function.}
88
-
89
-    \item{\code{verbose}:}{Report messages from evalaution?}
90
-
91
-  }
92
-}
93
-
94
-\section{Class Internal Methods: (For developers)}{
95
-  \describe{
96
-
97
-    \item{\code{initialize(ncdf, var, slice, ..., verbose)}:}{Called
98
-      during object creation with values to initialize fields.}
99
-
100
-    \item{\code{yield()}:}{Processes the NetCDF file and retrieves a
101
-      block of data from the NetCDF file corresponding to the slice size
102
-      that has been set.  Repeated calls to the \code{yield} function
103
-      retrieves the next block of data until the end of file has been
104
-      reached.}
105
-
106
-    \item{\code{reset()}:}{Resets the cursor that tracks the next block
107
-      of data to be read to the start of the file.}
108
-
109
-    \item{\code{status()}:}{Retrieves the position of the start of the
110
-      block from which data will be read for the next call to the
111
-      \code{yield} function.}
112
-
113
-    \item{\code{.getCounts()}:}{Retrieve the dimensions of the next
114
-      slice.}
115
-
116
-    \item{\code{.getNextStart()}:}{Retrieve coordinates at which next
117
-      yield starts.}
118
-
119
-  }
120
-}
121
-
122
-\author{Nishant Gopalakrishnan \url{ngopalak@fhcrc.org}}
123
-
124
-\seealso{\code{\link{NetCDFFile}}}
125
-
126
-\examples{
127
-\dontrun{
128
-    showClass("NetCDFInput")
129
-
130
-pth <- system.file("extdata", "NetCDFData.nc", package = "Streamer")
131
-ncFile <- NetCDFFile(pth)
132
-dimensions(ncFile)		# variable names and dimensions
133
-
134
-ncProd <- NetCDFInput(ncFile, "2dIntData", c(sampleDim=5, snpDim=2))
135
-yield(ncProd)
136
-status(ncProd)
137
-reset(ncProd)
138
-yield(ncProd)
139
-}
140
-
141
-}
142
-\keyword{classes}