Package org.tribuo.multilabel.sgd.linear

Class LinearSGDModel

java.lang.Object

org.tribuo.Model<T>

org.tribuo.common.sgd.AbstractSGDModel<T>

org.tribuo.common.sgd.AbstractLinearSGDModel<MultiLabel>

org.tribuo.multilabel.sgd.linear.LinearSGDModel

All Implemented Interfaces:

com.oracle.labs.mlrg.olcut.provenance.Provenancable<ModelProvenance>, Serializable, ONNXExportable

public class LinearSGDModel
extends AbstractLinearSGDModel<MultiLabel>
implements ONNXExportable

The inference time version of a multi-label linear model trained using SGD.

See:

 Bottou L.
 "Large-Scale Machine Learning with Stochastic Gradient Descent"
 Proceedings of COMPSTAT, 2010.
 

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.tribuo.common.sgd.AbstractSGDModel

AbstractSGDModel.PredAndActive

Field Summary

Fields inherited from class org.tribuo.common.sgd.AbstractSGDModel

addBias, modelParameters

Fields inherited from class org.tribuo.Model

ALL_OUTPUTS, BIAS_FEATURE, featureIDMap, generatesProbabilities, name, outputIDInfo, provenance, provenanceOutput

Fields inherited from interface org.tribuo.ONNXExportable

PROVENANCE_METADATA_FIELD, SERIALIZER

Method Summary

Modifier and Type	Method	Description
protected LinearSGDModel	copy(String newName, ModelProvenance newProvenance)	Copies a model, replacing its provenance and name with the supplied values.
protected String	getDimensionName(int index)	Gets the name of the indexed output dimension.
protected String	onnxModelName()
protected ONNXNode	onnxOutput(ONNXNode input)	Takes the unnormalized ONNX output of this model and applies an appropriate normalizer from the concrete class.
Prediction<MultiLabel>	predict(Example<MultiLabel> example)	Uses the model to predict the output for a single example.

Methods inherited from class org.tribuo.common.sgd.AbstractLinearSGDModel

exportONNXModel, getExcuse, getTopFeatures, getWeightsCopy, writeONNXGraph

Methods inherited from class org.tribuo.common.sgd.AbstractSGDModel

getModelParameters, predictSingle

Methods inherited from class org.tribuo.Model

castModel, copy, generatesProbabilities, getExcuses, getFeatureIDMap, getName, getOutputIDInfo, getProvenance, innerPredict, predict, predict, setName, toString, validate

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.tribuo.ONNXExportable

exportONNXModel, saveONNXModel, serializeProvenance, writeONNXGraph

Method Details

predict

public Prediction<MultiLabel> predict(Example<MultiLabel> example)

Description copied from class: Model

Uses the model to predict the output for a single example.

predict does not mutate the example.

Throws IllegalArgumentException if the example has no features or no feature overlap with the model.

Specified by:

predict in class Model<MultiLabel>

Parameters:

example - the example to predict.

Returns:

the result of the prediction.

getDimensionName

protected String getDimensionName(int index)

Description copied from class: AbstractLinearSGDModel

Gets the name of the indexed output dimension.

Specified by:

getDimensionName in class AbstractLinearSGDModel<MultiLabel>

Parameters:

index - The output dimension index.

Returns:

The name of the requested output dimension.

copy

protected LinearSGDModel copy(String newName,
 ModelProvenance newProvenance)

Description copied from class: Model

Copies a model, replacing its provenance and name with the supplied values.

Used to provide the provenance removal functionality.

Specified by:

copy in class Model<MultiLabel>

Parameters:

newName - The new name.

newProvenance - The new provenance.

Returns:

A copy of the model.

onnxOutput

protected ONNXNode onnxOutput(ONNXNode input)

Description copied from class: AbstractLinearSGDModel

Takes the unnormalized ONNX output of this model and applies an appropriate normalizer from the concrete class.

Specified by:

onnxOutput in class AbstractLinearSGDModel<MultiLabel>

Parameters:

input - Unnormalized ONNX leaf node.

Returns:

Normalized ONNX leaf node.

onnxModelName

protected String onnxModelName()

Specified by:

onnxModelName in class AbstractLinearSGDModel<MultiLabel>

Returns:

Name to write into the ONNX Model.