h2o (version 2.4.3.11)

h2o.importFile: Import Local Data File

Description

Imports a file from the local path and parses it, returning an object containing the identifying hex key.

Usage

## Default method:
h2o.importFile(object, path, key = "", parse = TRUE, header, sep = "", col.names, 
  version = 2)

## Import to a ValueArray object:
h2o.importFile.VA(object, path, key = "", parse = TRUE, header, sep = "", col.names)

## Import to a FluidVecs object:
h2o.importFile.FV(object, path, key = "", parse = TRUE, header, sep = "", col.names)

Arguments

object

An H2OClient object containing the IP address and port of the server running H2O.

path

The path of the file to be imported. Each row of data appears as one line of the file. If it does not contain an absolute path, the file name is relative to the current working directory.

key

(Optional) The unique hex key assigned to the imported file. If none is given, a key will automatically be generated based on the file path.

parse

(Optional) A logical value indicating whether the file should be parsed after import.

header

(Optional) A logical value indicating whether the first row is the column header. If missing, H2O will automatically try to detect the presence of a header.

sep

(Optional) The field separator character. Values on each line of the file are separated by this character. If sep = "", the parser will automatically detect the separator.

col.names

(Optional) A H2OParsedDataVA (version = 1) or H2OParsedData (version = 2) object containing a single delimited line with the column names for the fil

version

(Optional) If version = 1, the file will be imported to a ValueArray object. Otherwise, if version = 2, the file will be imported as a FluidVecs object.

Value

• If parse = TRUE, the function returns an object of class H2OParsedDataVA when version = 1 and an object of class H2OParsedData when version = 2. Otherwise, when parse = FALSE, it returns an object of class H2ORawDataVA when version = 1 and an object of class H2ORawData when version = 2.

Details

Calling the method with version = 1 is equivalent to h2o.importFile.VA, and version = 2 is equivalent to h2o.importFile.FV. WARNING: In H2O, import is lazy! Do not modify the data on hard disk until after parsing is complete.

See Also

h2o.importFolder, h2o.importHDFS, h2o.importURL, h2o.uploadFile

Examples

library(h2o)
localH2O = h2o.init(ip = "localhost", port = 54321, startH2O = TRUE)
irisPath = system.file("extdata", "iris.csv", package = "h2o")
iris.hex = h2o.importFile(localH2O, path = irisPath, key = "iris.hex")
class(iris.hex)
summary(iris.hex)
iris.fv = h2o.importFile(localH2O, path = irisPath, key = "iris.fv", version = 2)
class(iris.fv)