read.geodata: Reads and Converts Data to geoR Format

Description

Reads data from a ASCII file and converts it to an object of the class geodata, the standard data format for the geoR package.

Usage

read.geodata(file, header = FALSE, coords.col = 1:2, data.col = 3,
             data.names = NULL, covar.col = NULL, covar.names = "header",
             units.m.col = NULL, realisations = NULL,
             na.action = c("ifany", "ifdata", "ifcovar", "none"),
             rep.data.action, rep.covar.action, rep.units.action, …)

Arguments

file

a string with the name of the ASCII file.

header

logical. Indicates whether the variables names should be read from the first line of the input file.

coords.col

a vector with the numbers of the columns containing the coordinates.

data.col

a scalar or vector with the number of the column(s) containing the data.

data.names

a string or vector of strings with names for the data columns. Only valid if there is more than one column of data. By default the names in the original object are used.

covar.col

optional. A scalar or vector with the number of the column(s) with the values of the covariate(s).

covar.names

optional. A vector with the names of the the covariates. By default the names in the original object are used.

units.m.col

optional. A scalar with the column number corresponding to the offset variable. Alternativelly can be a character vector with the name of the offset. This option is particularly relevant when using the package geoRglm.

realisations

optional. A vector indicating the replication number. For more details see documentation for as.geodata.

na.action

a string. Defines action to be taken in the presence of NA's. For more details see documentation for as.geodata.

rep.data.action

a string or a function. Defines action to be taken when there is more than one data at the same location. For more details see documentation for as.geodata.

rep.covar.action

a string or a function. Defines action to be taken when there is more than one covariate at the same location. For more details see documentation for as.geodata.

rep.units.action

a string or a function. Defines action to be taken on the element units.m, if present when there is more than one data at the same location. The default option is the same value set for rep.data.action.

…

further arguments to be passed to the function read.table.

Value

An object of the class geodata. See documentation for the function as.geodata for further details.

Details

The function read.table is used to read the data from the ASCII file and then as.geodata is used to convert to an object of the class geodata.

References

Further information on the package geoR can be found at: http://www.leg.ufpr.br/geoR.