This is an R package which provides an I/O interface between R data.frames and Raven DataFrames. The functions provided by this package allow you to both read and write DataFrame files (.df), as well as serialize/deserialize DataFrames to/from raw vectors.
You can install the released version of rdf from CRAN with:
install.packages("raven.rdf")After installation you can easily read DataFrame files (.df) into R data.frames and persist R data.frame instances to DataFrame files.
Make sure that the library package is loaded:
library("raven.rdf")Then read a DataFrame file into memory with:
df <- readDataFrame("path/to/my/file.df")The df variable is a regular R data.frame so you can use it like any other such instance. You could then do some computations, change values inside the data.frame and then write it back to the file as a Raven DataFrame with:
writeDataFrame("path/to/my/file.df", df)For more options, please see the documentation section below.
The rdf package requires R 3.5.0 or higher.
This library does not have any external dependencies.
See the developer documentation for API usage instructions and examples.
See the R reference manual for the API documentation.
For more information on DataFrames as used by Raven Computing, please see the corresponding developer documentation.
If you want to change code of this library or install it manually without downloading from CRAN, you can do so by cloning this repository.
The R devtools are required in a development environment. The below instructions assume that devtools are loaded within the underlying development environment. We are using RStudio as our standard IDE for R projects. The following instructions show how to achieve things on a command line.
When in the project root directory, you may load the library code with:
load_all()This will temporarily install the rdf library in a non-global workspace. You can then call all functions provided by the rdf library directly.
Execute all unit tests with:
test()Build the documentation with:
document()The above command will build the documentation in the man directory with roxygen2.
If you want to install rdf from source, it is highly recommended to run the automated checks before installing:
check()If all checks have passed, you can install rdf from source with:
install()You can then attach the rdf package in your projects like any other package.
You can build a distribution file with:
build()The built file can then be distributed manually.
This library is licensed under the Apache License Version 2 - see the LICENSE for details.