read.zoo {zoo}R Documentation

Read zoo Series via read.table

Description

read.zoo is a convenience function for reading "zoo" series from text files.

Usage

read.zoo(file, format = "", tz = "", FUN = NULL, ...)

Arguments

file character giving the name of the file which the data are to be read from. See read.table for more information.
format date format argument passed to as.Date.character.
tz time zone argument passed to as.POSIXct.
FUN a function for computing the index from the first column of the data. See details.
... further arguments passed to read.table.

Details

read.zoo is a convenience function which should make it easier to read data from a text file and turn it into a "zoo" series immediately. read.zoo reads the data file via read.table(file, ...). The first column of the resulting data is interpreted to be the index, the remaining columns the corresponding data. (If the file only has only column then that is assumed to be the data column and 1, 2, ... are used for the index.) To assign the appropriate class to the index, FUN can be specified and is applied to the first column. By default, read.zoo uses as.Date(as.character(x), format = format) if format is specified and as.POSIXct(as.character(x), tz = tz) if tz is specified; otherwise it tries to guess between "numeric", "Date" and "POSIXct".

If the resulting series has an underlying regularity, it is coerced to a "zooreg" series.

Value

An object of class "zoo" (or "zooreg").

See Also

zoo

Examples

## Not run: 
## turn *numeric* first column into yearmon index
z <- read.zoo("foo.csv", sep = ",", FUN = as.yearmon)

## turn *character* first column into Date index
z <- read.zoo("foo.tab", format = "%m/%d/%Y")
## End(Not run)

[Package zoo version 1.0-5 Index]