Distributed R is a scalable high-performance platform for the R language. It enables and accelerates large scale machine learning, statistical analysis, and graph processing.
The Distributed R platform exposes data structures, such as distributed arrays, to store data across a cluster. Arrays act as a single abstraction to efficiently express both machine learning algorithms, which primarily use matrix operations, and graph algorithms, which manipulate the graphās adjacency matrix. In addition to distributed arrays, the platform also provides distributed data frames, lists and loops.
Using Distributed R constructs, data can be loaded in parallel from any data source. Distributed R also provides a parallel data loader from the Vertica database. Please see vRODBC repository.
Distributed R is delivered in a single, easy-to-install tar file. The installation tool "distributedR_install" installs the platform and all parallel algorithm R packages. You can register and get the tar file here.
You can also get a Virtual Machine with everything installed here.
- Install dependencies:
-
On Ubuntu:
$ sudo apt-get install -y make gcc g++ libxml2-dev rsync bison byacc flex
-
On CentOS:
$ sudo yum install -y make gcc gcc-c++ libxml2-devel rsync bison byacc flex
- Install R:
-
On Ubuntu:
$ echo "deb http://cran.r-project.org//bin/linux/ubuntu trusty/" | sudo tee /etc/apt/sources.list.d/r.list $ sudo apt-get update $ sudo apt-get install -y --force-yes r-base-core
-
On CentOS:
$ curl -O http://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm $ sudo rpm -i epel-release-latest-7.noarch.rpm $ sudo yum update $ sudo yum install R R-devel
-
Install R dependencies:
$ sudo R # to install globally R> install.packages(c('Rcpp','RInside','XML','randomForest','data.table'))
-
Compile and install Distributed R:
$ R CMD INSTALL platform/executor $ R CMD INSTALL platform/master
-
Or directly from the R console:
R> devtools::install_github('vertica/DistributedR',subdir='platform/executor') R> devtools::install_github('vertica/DistributedR',subdir='platform/master')
-
Open R and run an example:
library(distributedR) distributedR_start() # start DR distributedR_status() B <- darray(dim=c(9,9), blocks=c(3,3), sparse=FALSE) # create a darray foreach(i, 1:npartitions(B), init<-function(b = splits(B,i), index=i) { b <- matrix(index, nrow=nrow(b), ncol=ncol(b)) update(b) }) # initialize it getpartition(B) # collect darray data distributedR_shutdown() # stop DR
You can help us in different ways:
- Reporting issues.
- Contributing code and sending a Pull Request.
In order to contribute the code base of this project, you must agree to the Developer Certificate of Origin (DCO) 1.1 for this project under GPLv2+:
By making a contribution to this project, I certify that:
(a) The contribution was created in whole or in part by me and I have the
right to submit it under the open source license indicated in the file; or
(b) The contribution is based upon previous work that, to the best of my
knowledge, is covered under an appropriate open source license and I
have the right under that license to submit that work with modifications,
whether created in whole or in part by me, under the same open source
license (unless I am permitted to submit under a different license),
as indicated in the file; or
(c) The contribution was provided directly to me by some other person who
certified (a), (b) or (c) and I have not modified it.
(d) I understand and agree that this project and the contribution are public and
that a record of the contribution (including all personal information I submit
with it, including my sign-off) is maintained indefinitely and may be
redistributed consistent with this project or the open source license(s) involved.
To indicate acceptance of the DCO you need to add a Signed-off-by
line to every commit. E.g.:
Signed-off-by: John Doe <[email protected]>
To automatically add that line use the -s
switch when running git commit
:
$ git commit -s