Merge branch 'master' of https://github.com/0xdata/h2o

.classpath

@@ -34,6 +34,6 @@
 	<classpathentry kind="lib" path="lib/jogamp/gluegen-rt-natives-linux-amd64.jar"/>
 	<classpathentry kind="lib" path="lib/jogamp/gluegen-rt.jar" sourcepath="lib/jogamp/gluegen-rt-sources.jar"/>
 	<classpathentry kind="con" path="org.eclipse.jdt.USER_LIBRARY/python) interpreter library"/>
-  <classpathentry kind="lib" path="lib/joda/joda-time-2.3.jar"/>
+	<classpathentry kind="lib" path="lib/joda/joda-time-2.3.jar"/>
 	<classpathentry kind="output" path="target/classes"/>
 </classpath>

R/h2o-DESCRIPTION.template

@@ -10,5 +10,5 @@ License: Apache License (== 2.0)
 Depends: R (>= 2.13.0), RCurl, rjson, statmod, tools, methods, utils
 Collate: Wrapper.R Internal.R Classes.R ParseImport.R Algorithms.R
 NeedsCompilation: no
-SystemRequirements: java 6 or newer
+SystemRequirements: java 1.6 or higher
 URL: http://www.0xdata.com

R/h2o-package/R/Algorithms.R

@@ -53,7 +53,7 @@ h2o.gbm <- function(x, y, distribution='multinomial', data, n.trees=10, interact
   if(params$distribution == "multinomial") {
     # temp = matrix(unlist(res$cm), nrow = length(res$cm))
     # mySum$prediction_error = 1-sum(diag(temp))/sum(temp)
-    mySum$prediction_error = tail(res$cm, 1)[[1]]$'_predErr'
+    mySum$prediction_error = tail(res$'cms', 1)[[1]]$'_predErr'
   }
   return(mySum)
 }
@@ -68,8 +68,8 @@ h2o.gbm <- function(x, y, distribution='multinomial', data, n.trees=10, interact
   result$params = params
 
   if(result$params$distribution == "multinomial") {
-    class_names = tail(res$'_domains', 1)[[1]]
-    result$confusion = .build_cm(tail(res$cm, 1)[[1]]$'_arr', class_names)  # res$'_domains'[[length(res$'_domains')]])
+    class_names = res$'cmDomain' #tail(res$'_domains', 1)[[1]]
+    result$confusion = .build_cm(tail(res$'cms', 1)[[1]]$'_arr', class_names)  # res$'_domains'[[length(res$'_domains')]])
     result$classification <- T
   } else
     result$classification <- F
@@ -781,7 +781,7 @@ h2o.randomForest.VA <- function(x, y, data, ntree=50, depth=50, sample.rate=2/3,
 }
 
 # -------------------------- FluidVecs -------------------------- #
-h2o.randomForest.FV <- function(x, y, data, ntree=50, depth=50, sample.rate=2/3, nbins=100, seed=-1, validation, nodesize=1) {
+h2o.randomForest.FV <- function(x, y, data, ntree=50, depth=50, nodesize=1, sample.rate=2/3, nbins=100, seed=-1, importance = FALSE, validation) {
   args <- .verify_dataxy(data, x, y)
   if(!is.numeric(ntree)) stop('ntree must be a number')
   if( any(ntree < 1) ) stop('ntree must be >= 1')
@@ -792,7 +792,8 @@ h2o.randomForest.FV <- function(x, y, data, ntree=50, depth=50, sample.rate=2/3,
   if(!is.numeric(nbins)) stop('nbins must be a number')
   if( any(nbins < 1)) stop('nbins must be an integer >= 1')
   if(!is.numeric(seed)) stop("seed must be an integer >= 0")
-
+  if(!is.logical(importance)) stop("importance be logical (TRUE or FALSE)')")
+
   if(missing(validation)) validation = data
   # else if(class(validation) != "H2OParsedData") stop("validation must be an H2O dataset")
   else if(!class(validation) %in% c("H2OParsedData", "H2OParsedDataVA")) stop("validation must be an H2O parsed dataset")
@@ -801,7 +802,7 @@ h2o.randomForest.FV <- function(x, y, data, ntree=50, depth=50, sample.rate=2/3,
 
   # NB: externally, 1 based indexing; internally, 0 based
   cols <- paste(args$x_i - 1, collapse=',')
-  res = .h2o.__remoteSend(data@h2o, .h2o.__PAGE_DRF, source=data@key, response=args$y, cols=cols, ntrees=ntree, max_depth=depth, min_rows=nodesize, sample_rate=sample.rate, nbins=nbins, seed=seed)
+  res = .h2o.__remoteSend(data@h2o, .h2o.__PAGE_DRF, source=data@key, response=args$y, cols=cols, ntrees=ntree, max_depth=depth, min_rows=nodesize, sample_rate=sample.rate, nbins=nbins, seed=seed, importance=as.numeric(importance))
   params = list(x=args$x, y=args$y, ntree=ntree, depth=depth, sample.rate=sample.rate, nbins=nbins)
 
   if(length(ntree) == 1 && length(depth) == 1 && length(nodesize) == 1 && length(sample.rate) == 1 && length(nbins) == 1) {
@@ -827,7 +828,7 @@ h2o.randomForest.FV <- function(x, y, data, ntree=50, depth=50, sample.rate=2/3,
 
   # temp = matrix(unlist(res$cm), nrow = length(res$cm))
   # mySum$prediction_error = 1-sum(diag(temp))/sum(temp)
-  mySum$prediction_error = tail(res$cm, 1)[[1]]$'_predErr'
+  mySum$prediction_error = tail(res$'cms', 1)[[1]]$'_predErr'
   return(mySum)
 }
 
@@ -845,8 +846,8 @@ h2o.randomForest.FV <- function(x, y, data, ntree=50, depth=50, sample.rate=2/3,
   rownames(rf_matrix) = c("Depth", "Leaves")
   result$forest = rf_matrix
 
-  class_names = tail(res$'_domains', 1)[[1]]
-  result$confusion = .build_cm(tail(res$cm, 1)[[1]]$'_arr', class_names)  # res$'_domains'[[length(res$'_domains')]])
+  class_names = res$'cmDomain' #tail(res$'_domains', 1)[[1]]
+  result$confusion = .build_cm(tail(res$'cms', 1)[[1]]$'_arr', class_names)  #res$'_domains'[[length(res$'_domains')]])
   result$mse = as.numeric(res$errs)
   # result$ntree = res$N
   return(result)

h2o-docs/source/Ruser/R_studio.rst

@@ -1,34 +1,38 @@
 
 
-H\ :sub:`2`\ O in R Studio
----------------------------
+H\ :sub:`2`\ O installation in R Studio
+------------------------------------------
 
 
-These instructions assume you are using R Studio 2.14.0 or later.  
+These instructions assume you are using R  2.14.0 or later.  
 
 **STEP 1**
 
-To use H\ :sub: `2`\ O in R, users need a copy of  H\ :sub: `2`\ O. 
-The download package can be obtained by clicking on the button Download H\ :sub:`2`\ O at `http://0xdata.com/downloadtable <http://0xdata.com/downloadtable/>`_.
+The download package containing the  H\ :sub:`2`\ O jar file can be
+obtained by visiting H\ :sub:`2`\ O available downloads at 
+`http://0xdata.com/downloadtable <http://0xdata.com/downloadtable/>`_.
 
-Unzip the downloaded H\ :sub:`2`\ O zip file.
+Choose the version of  H\ :sub:`2`\ O best for you, and unzip the
+downloaded H\ :sub:`2`\ O zip file. The most recent promoted build is
+reccomended. 
 
 **STEP 2**
 
-Start an instance of H\ :sub:`2`\ O. For help with this see :ref:`GettingStartedFromaZipFile`
+Start an instance of H\ :sub:`2`\ O. For help with this see 
+:ref:`GettingStartedFromaZipFile`
 
+If users do not start an instance of H\ :sub:`2`\ O, one will be
+started automatically for them at localhost: 54321 (see **STEP 4** for
+more detail). 
 
-Users should be aware that in order for H\ :sub:`2`\ O to successfully run through R, an instance of H\ :sub:`2`\ O must also simultaneously be running. If the instance of H\ :sub:`2`\ O is stopped, the R program will no longer run, and work done will be lost. 
+If the instance of H\ :sub:`2`\ O is stopped, the R
+program will no longer run, and work done will be lost. 
 
+**STEP 3:**
 
-**STEP 3** 
-
-For users who may have already installed a prior version of the H2O
-package. New users may skip this step. 
-
-For packages to be successfully removed and updated in R studio - they
-must first be detatched from the R environment and then uninstalled. 
-Simply enter the following: 
+New users may skip this step, while users who have previously
+installed the  H\ :sub:`2`\ O R packages should uninstall them by entering the
+following commands to the R console:  
 
 ::
 
@@ -38,58 +42,70 @@ Simply enter the following:
 
 Note: users may get warnings of the type "Error in
 detatch("package:h2o", unload = TRUE): invalid 'name' argument. 
-This tells users that there is no h2o package to uninstall. These
+This tells users that there is no  H\ :sub:`2`\ O package to uninstall. These
 warnings can safely be ignored. 
 
-.. image:: Rstudioinstall1.jpg
-   :width: 90%
-
-
-**STEP 4**
-
-Install the H\ :sub:`2`\ O package from the H2ORepo, the H2O cran that
-functions exactly like the usual R cran, but is managed and maintained
-by H2O. 
-Simply enter the call: 
+**STEP 4:**
 
-::
+Install the H\ :sub:`2`\ O package via the H\ :sub:`2`\ O
+repository. This repository functions exactly like the R repository,
+but is maintained by  H\ :sub:`2`\ O. 
 
-  install.packages("h2o", repos=(c("http://h2o-release.s3.amazonaws.com/h2o/rel-jacobi/2/R", getOption("repos"))))
- 
-as shown here:
+**DO NOT CUT AND PASTE THIS CALL INTO R**
+The call shown below is specifically for the jacobi/2 build, which may
+be older than the build you would like to use. Your call should look
+similar to this, and you can find an exact command to copy and paste
+by going to H\ :sub:`2`\ O available downloads at 
+`http://0xdata.com/downloadtable
+<http://0xdata.com/downloadtable/>`_ and selecting the correct version
+there. 
 
-.. image:: Rstudioinstall2.jpg
-   :width: 90%
-
+  `install.packages("h2o", repos=(c("http://h2o-release.s3.amazonaws.com/h2o/rel-jacobi/2/R", getOption("repos"))))` 
+
 
+**STEP 4:**
 
+Once the  H\ :sub:`2`\ O R package has been installed, call the
+package, and establish a connection to a running instance of  H\
+:sub:`2`\ O. 
 
-**STEP 4**
+If there is no running instance of  H\ :sub:`2`\ O prior to using
+the command "h2o.init()",  H\ :sub:`2`\ O in R will start an instance
+automatically for the user at localhost:54321, and the user will be
+notified. If you would like to connect to an instance at an IP and
+port other than localhost:54321, these details must be specified as
+arguments in the R call. 
 
-If you have not started an instance of H2O from your command line
-terminal, R will start an instance for you automatically. If you have
-already started an instance, H2O R will connect to this instance, and
-no other instance will be started. 
-
-Get R Studio talking to your instance of H\ :sub:`2`\ O by typing in the call: 
 
 ::
 
-  >localH2O = h2o.init(ip = "localhost", port = 54321, startH2O = TRUE)
+  library(h2o)
+  localH2O <- h2o.init()
 
-Your IP and port may be different, depending on whether you are running H\ :sub:`2`\ O from your computer or a server. If you are running on a server, where it says IP enter the IP address of the server, and the appropriate port number. In the picture below the IP number is everything before the colon, and the port number is the 5 digit string after the colon.
 
+Users who wish to specify a connection
+with a server (other than localhost at port 54321) must explicity
+state the IP address and port number in the h2o.init call. 
+An example is given below, but **do not cut and paste**; users should
+specify the IP and port number appropriate to their specific
+environment. 
 
+::
 
-Upgrading the H\ :sub:`2`\ O R Packages
-"""""""""""""""""""""""""""""""""""""""
+  library(h2o)
+  localH2O = h2o.init(ip = "192.555.1.123", port = 12345, startH2O = FALSE) 
 
 
-Users may wish to manually upgrade their R packages. They can do this
-by returning to STEP 3, and following the instructions through
-STEP 4. 
+**STEP 5: Upgrading Packages**
 
+Users may wish to manually upgrade their R packages. For instance, if
+you are running the bleeding edge developer build, it’s possible that
+the code has changed, but that the revision number has not, in which
+case manually upgrading ensures the most current version of not only
+the H\ :sub:`2`\ O code, but the corresponding R code as well.
 
+This can be done by returning to STEP 3, and following the commands
+through STEP 4.
 
 
 

h2o-docs/source/Ruser/Rinstall.rst

@@ -21,9 +21,11 @@ reccomended.
 Start an instance of H\ :sub:`2`\ O. For help with this see 
 :ref:`GettingStartedFromaZipFile`
 
-Users should be aware that in order for H\ :sub:`2`\ O to successfully
-run through R, an instance of H\ :sub:`2`\ O must also simultaneously
-be running. If the instance of H\ :sub:`2`\ O is stopped, the R
+If users do not start an instance of H\ :sub:`2`\ O, one will be
+started automatically for them at localhost: 54321 (see **STEP 4** for
+more detail). 
+
+If the instance of H\ :sub:`2`\ O is stopped, the R
 program will no longer run, and work done will be lost. 
 
 **STEP 3:**
@@ -45,14 +47,20 @@ warnings can safely be ignored.
 
 **STEP 4:**
 
-Install the H\ :sub:`2`\ O package, and the H\ :sub:`2`\ O client
-package via the  H\ :sub:`2`\ O cran. This repository functions
-exactly like the R repository, but is maintained by  H\ :sub:`2`\ O. 
+Install the H\ :sub:`2`\ O package via the H\ :sub:`2`\ O
+repository. This repository functions exactly like the R repository,
+but is maintained by  H\ :sub:`2`\ O. 
 
-::
+**DO NOT CUT AND PASTE THIS CALL INTO R**
+The call shown below is specifically for the jacobi/2 build, which may
+be older than the build you would like to use. Your call should look
+similar to this, and you can find an exact command to copy and paste
+by going to H\ :sub:`2`\ O available downloads at 
+`http://0xdata.com/downloadtable
+<http://0xdata.com/downloadtable/>`_ and selecting the correct version
+there. 
 
-  install.packages("h2o", repos=(c("http://h2o-release.s3.amazonaws.com/h2o/rel-jacobi/2/R", getOption("repos"))))
- 
+  `install.packages("h2o", repos=(c("http://h2o-release.s3.amazonaws.com/h2o/rel-jacobi/2/R", getOption("repos"))))` 
 
 
 **STEP 4:**
@@ -63,12 +71,11 @@ package, and establish a connection to a running instance of  H\
 
 If there is no running instance of  H\ :sub:`2`\ O prior to using
 the command "h2o.init()",  H\ :sub:`2`\ O in R will start an instance
-automatically for the user. 
+automatically for the user at localhost:54321, and the user will be
+notified. If you would like to connect to an instance at an IP and
+port other than localhost:54321, these details must be specified as
+arguments in the R call. 
 
-Note that in the call "localH2O <- h2o.init()" the h2o.init object is
-being named localH2O in the R environment for use later in model
-specification. Entering the call exactly as it is written below assumes the
-user wishes to connect to IP localhost and port: 54321.
 
 ::
 
@@ -77,7 +84,7 @@ user wishes to connect to IP localhost and port: 54321.
 
 
 Users who wish to specify a connection
-with a server (rather than localhost at port 54321) must explicity
+with a server (other than localhost at port 54321) must explicity
 state the IP address and port number in the h2o.init call. 
 An example is given below, but **do not cut and paste**; users should
 specify the IP and port number appropriate to their specific

h2o-docs/source/userguide/general.rst

@@ -72,6 +72,6 @@ Step by step instructions on how to use each of the algorithms and
 tools can be found in tutorials . Users have a variety of options for
 accessing and running H\ :sub:`2`\ O. For instructions on how to get
 started using H\ :sub:`2`\ O (for example through R, using Java, or
-via git-hub), please see the Quick Start Guides. New users may also
-find the :ref:`glossary` useful for familiarizing themselves with H\
-:sub:`2`\ O's computing and statistics terms. 
+via git-hub), please see the Quick Start Guides, and Walk Through
+Tutorials. New users may also find the :ref:`glossary` useful for 
+familiarizing themselves with H\ :sub:`2`\ O's computing and statistics terms.