sm (version 2.0-2)

provide.data: Making data available as data.frame

Description

This is a utility function, widely used in the scripts acconpanying the book described below. The function provides access to the dataset identified by name. For flexibility, the datasets are provided in ASCII form, with the name of each variable listed in the first row of the file. This function reads the files and makes the data available as a data frame.

Usage

provide.data(data, path, options = list())

Arguments

data

name of the data to be loaded and attached as data.frame

path

the path where the data and its documentation should be searched for, The default value is an appropriate sub-directory of the sm package.

options

A list of options. The one used is describe, a logical flag. If describe=TRUE (default), a documentation file of the data is searched and printed, if available.

Value

• none

Side Effects

messages are printed on the command window, describing progress of the operation. If describe=TRUE and a documentation file exists, this is printed on the command windows or another windows, depending on the type of platform where the program is executed.

Details

the data file is assumed to be called data.dat and the documentation file describing the data (if present) is assumed to be called data.doc. If the data.frame is already attached, it is re-attached in the second position of the search list.

To set describe=F for the rest of the current session, use sm.options(describe=F)

The function can very easily be adapted to play a similar role for other packages.

References

Bowman, A.W. and Azzalini, A. (1997). Applied Smoothing Techniques for Data Analysis: the Kernel Approach with S-Plus Illustrations. Oxford University Press, Oxford.

See Also

data.frame, attach, sm, sm.options

Examples

provide.data(birth)