zoo (version 1.0-1)

read.zoo: 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.

Value

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

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. 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.

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 = "