git-svn-id: file:///home/git/hedgehog.fhcrc.org/bioconductor/trunk/madman/Rpacks/Streamer@68642 bc3139a8-67e5-0310-9ffc-ced21a209358
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} |