hex.tree.gbm

Class GBMGrid<G extends GBMGrid<G>>

java.lang.Object

water.Iced<T>

water.Keyed<T>

water.Lockable<G>

hex.Grid<G>

hex.tree.SharedTreeGrid<G>

hex.tree.gbm.GBMGrid<G>

All Implemented Interfaces:

java.io.Externalizable, java.io.Serializable, java.lang.Cloneable, water.Freezable<G>

public class GBMGrid<G extends GBMGrid<G>>
extends SharedTreeGrid<G>

A Grid of Models Used to explore Model hyper-parameter space. Lazily filled in, this object represents the potentially infinite variety of hyperparameters of a given model & dataset. One subclass per kind of Model, e.g. GBM or GLM or GBM or DL. The Grid tracks Models and their hyperparameters, and will allow discovery of existing Models by hyperparameter, or building Models on demand by hyperparameter. The Grid can manage a (simplistic) hyperparameter search space. Hyperparameter values are limited to doubles in the API, but can be anything the subclass Grid desires internally. E.g. the Grid for GBM will convert the initial center selection Enum to and from a simple integer value internally.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class hex.Grid

hex.Grid.GridSearch

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	MODEL_NAME

Fields inherited from class hex.Grid

_fr

Fields inherited from class water.Lockable

_lockers

Fields inherited from class water.Keyed

_key

Method Summary

Methods

Modifier and Type	Method and Description
protected long	checksum_impl()
static GBMGrid	get(water.fvec.Frame fr)
protected GBM	getBuilder(double[] hypers)
double[]	getHypers(hex.Model.Parameters parms)
protected double[]	hyperDefaults()
protected java.lang.String[]	hyperNames()
protected java.lang.String	modelName()
protected double	suggestedNextHyperValue(int h, hex.Model m, double[] hyperLimits) Ask the Grid for a suggested next hyperparameter value, given an existing Model as a starting point and the complete set of hyperparameter limits.

Methods inherited from class hex.tree.SharedTreeGrid

getBuilder, getHypers

Methods inherited from class hex.Grid

keyName, model, model, remove_impl, startGridSearch, trainingFrame

Methods inherited from class water.Lockable

delete_and_lock, delete, delete, delete, read_lock, read_lock, unlock_all, unlock, update, write_lock

Methods inherited from class water.Keyed

checksum, remove, remove, remove, remove

Methods inherited from class water.Iced

clone, frozenType, read_impl, read, readExternal, readJSON_impl, readJSON, toJsonString, write_impl, write, writeExternal, writeHTML_impl, writeHTML, writeJSON_impl, writeJSON

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

MODEL_NAME

public static final java.lang.String MODEL_NAME

See Also:

Constant Field Values

Method Detail

modelName

protected java.lang.String modelName()

Overrides:

modelName in class SharedTreeGrid<G extends GBMGrid<G>>

Returns:

Model name

hyperNames

protected java.lang.String[] hyperNames()

Specified by:

hyperNames in class hex.Grid<G extends GBMGrid<G>>

Returns:

hyperparameter names corresponding to a Model.Parameter field names

hyperDefaults

protected double[] hyperDefaults()

Specified by:

hyperDefaults in class hex.Grid<G extends GBMGrid<G>>

Returns:

hyperparameter defaults, aligned with the field names

suggestedNextHyperValue

protected double suggestedNextHyperValue(int h,
                             hex.Model m,
                             double[] hyperLimits)

Ask the Grid for a suggested next hyperparameter value, given an existing Model as a starting point and the complete set of hyperparameter limits. Returning a NaN signals there is no next suggestion, which is reasonable if the obvious "next" value does not exist (e.g. exhausted all possibilities of an enum). It is OK if a Model for the suggested value already exists; this will be checked before building any model.

Specified by:

suggestedNextHyperValue in class hex.Grid<G extends GBMGrid<G>>

Parameters:

h - The h-th hyperparameter

m - A model to act as a starting point

hyperLimits - Upper bounds for this search

Returns:

Suggested next value for hyperparameter h or NaN if no next value

getBuilder

protected GBM getBuilder(double[] hypers)

Specified by:

getBuilder in class hex.Grid<G extends GBMGrid<G>>

Parameters:

hypers - A set of hyper parameter values

Returns:

A ModelBuilder, blindly filled with parameters. Assumed to be cheap; used to check hyperparameter sanity or make models

getHypers

public double[] getHypers(hex.Model.Parameters parms)

Specified by:

getHypers in class hex.Grid<G extends GBMGrid<G>>

Parameters:

parms - Model parameters

Returns:

Gridable parameters pulled out of the parms

get

public static GBMGrid get(water.fvec.Frame fr)

checksum_impl

protected long checksum_impl()

Overrides:

checksum_impl in class SharedTreeGrid<G extends GBMGrid<G>>