read.ds.gz {UCS}R Documentation

Load UCS data set file (base)

Description

Load a UCS data set file, which is uncompressed on the fly if necessary.

Usage

read.ds.gz(filename)

Arguments

filename name, partial or full path of the data set file to be loaded.

Details

When the specified file is not found in the current directory, it is automatically searched in the standard UCS data library (the ‘DataSet/’ directory and its subdirectories). Should there be multiple matches, a warning is issued and the first match is used. You may specify partial paths to identify the desired file unambiguously (e.g. "Distrib/dickens.ds.gz"). The automatic search facility is suppressed when filename is an explicit absolute or relative path (starting with / or ./).

gzip-compressed data set files, whose name must end in .gz, are automagically decompressed.

Value

A data frame with column names (i.e. variables) corresponding to those in the data set file. l1 and l2 are read as character vectors, all other string variables (f.*) are converted into factors, and Boolean variables (b.*) are converted into logicals.

Any comments and global variables in the file header are discarded.

Examples

## load GLAW data set from UCS distribution
GLAW <- read.ds.gz("glaw.ds.gz")

[Package UCS version 0.5 Index]