setDataFile.ggobi {Rggobi}R Documentation

Load data from a file into a ggobi instance

Description

This replaces the existing data in the specified ggobi instance with the dataset(s) in the file given by name.

Usage

setDataFile.ggobi(file, mode="unknown", add = TRUE, .gobi=getDefaultGGobi())

Arguments

file the name of the file from which to read the data. Note that if XML support has been compiled for ggobi, this can be a compressed file or even a URL.
mode this indicates which format to expect the data to be in. This is optional and if not supplied, the ggobi system attempts to find the file by looking through different extensions and checking the contents for a valid data stream. This helps to avoid loading data unitentionally due to name conflicts.
add a logical value indicating whether to add the newly loaded dataset to the existing collection of data sets, or simply to replace them.
.gobi the ggobi instance into which the new data should be loaded. This is needed only if there are multiple ggobi instances and the target is not the currently active/default instance.

Details

This re-initializes the ggobi instance, discarding the existing data and plots, and creating the default starting view.

Value

a logical value indicating whether the load was successful. \ In the future, this might be a dataset description.

Author(s)

Duncan Temple Lang

References

http://www.ggobi.org

See Also

ggobi setDataFrame.ggobi getFileNames.ggobi

Examples

## Not run: 
#XXX
 setDataFile.ggobi(system.file("datasets", "flea.xml", package="RSggobi"))
 setData.ggobi(system.file("datasets", "flea.xml", package="RSggobi"))
## End(Not run)

## Not run: 
 setData.ggobi("http://www.ggobi.org/data/flea.xml")
## End(Not run)

[Package Rggobi version 1.1-3 Index]