LogisticRegression (Java Statistical Analysis Tool 0.0.8 API)

java.lang.Object
- jsat.regression.LogisticRegression

All Implemented Interfaces:

Serializable, Cloneable, Classifier, Regressor, SimpleWeightVectorModel, SingleWeightVectorModel
```
public class LogisticRegression
extends Object
implements Classifier, Regressor, SingleWeightVectorModel
```
Logistic regression is a common method used to fit a probability between binary outputs. It can also be used to perform regression on a real function. For classification tasks, when all variables are independent, the results converge to the same prediction values as NaiveBayes. When variables have a high degree of correlation, Logistic Regression should produce better results.

Author:

Edward Raff

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description

LogisticRegression()

Constructors
Constructor and Description
`LogisticRegression()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`CategoricalResults`	`classify(DataPoint data)` Performs classification on the given data point.
`LogisticRegression`	`clone()`
`double`	`getBias()` Returns the bias term used for the model, or 0 of the model does not support or was not trained with a bias term.
`double`	`getBias(int index)` Returns the bias term used with the weight vector for the given class index.
`Vec`	`getCoefficents()` Returns the backing vector that containing the learned coefficients for the logistic regression.
`Vec`	`getRawWeight()` Returns the only weight vector used for the model
`Vec`	`getRawWeight(int index)` Returns the raw weight vector associated with the given class index.
`int`	`numWeightsVecs()` Returns the number of weight vectors that can be returned.
`double`	`regress(DataPoint data)`
`boolean`	`supportsWeightedData()` Indicates whether the model knows how to train using weighted data points.
`void`	`train(RegressionDataSet dataSet)`
`void`	`train(RegressionDataSet dataSet, ExecutorService threadPool)`
`void`	`trainC(ClassificationDataSet dataSet)` Trains the classifier and constructs a model for classification using the given data set.
`void`	`trainC(ClassificationDataSet dataSet, ExecutorService threadPool)` Trains the classifier and constructs a model for classification using the given data set.

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - LogisticRegression
```
public LogisticRegression()
```
- Method Detail
  - getCoefficents
```
public Vec getCoefficents()
```
    Returns the backing vector that containing the learned coefficients for the logistic regression. Changes to it will alter the results of the model
    
    Returns:
    
    the backing vector that containing the learned coefficients for the logistic regression.
  - regress
```
public double regress(DataPoint data)
```
    Specified by:
    
    regress in interface Regressor
  - train
```
public void train(RegressionDataSet dataSet,
                  ExecutorService threadPool)
```
    Specified by:
    
    train in interface Regressor
  - train
```
public void train(RegressionDataSet dataSet)
```
    Specified by:
    
    train in interface Regressor
  - supportsWeightedData
```
public boolean supportsWeightedData()
```
    Description copied from interface: Classifier
    
    Indicates whether the model knows how to train using weighted data points. If it does, the model will train assuming the weights. The values returned by this method may change depending on the parameters set for the model.
    
    Specified by:
    
    supportsWeightedData in interface Classifier
    
    Specified by:
    
    supportsWeightedData in interface Regressor
    
    Returns:
    
    true if the model supports weighted data, false otherwise
  - getRawWeight
```
public Vec getRawWeight()
```
    Description copied from interface: SingleWeightVectorModel
    
    Returns the only weight vector used for the model
    
    Specified by:
    
    getRawWeight in interface SingleWeightVectorModel
    
    Returns:
    
    the only weight vector used for the model
  - getBias
```
public double getBias()
```
    Description copied from interface: SingleWeightVectorModel
    
    Returns the bias term used for the model, or 0 of the model does not support or was not trained with a bias term.
    
    Specified by:
    
    getBias in interface SingleWeightVectorModel
    
    Returns:
    
    the bias term for the model
  - getRawWeight
```
public Vec getRawWeight(int index)
```
    Description copied from interface: SimpleWeightVectorModel
    
    Returns the raw weight vector associated with the given class index. If the given class is an implicit zero vector, a ConstantVector object may be returned.
    Do not alter the returned weight vector, as it will change the model's values.
    
    If a regression problem, only index = 0 should be used
    
    Specified by:
    
    getRawWeight in interface SimpleWeightVectorModel
    
    Parameters:
    
    index - the class index to get the weight vector for
    
    Returns:
    
    the weight vector used for the specified class
  - getBias
```
public double getBias(int index)
```
    Description copied from interface: SimpleWeightVectorModel
    
    Returns the bias term used with the weight vector for the given class index. If the model does not support or was not trained with bias weights, 0 will be returned.
    
    If a regression problem, only index = 0 should be used
    
    Specified by:
    
    getBias in interface SimpleWeightVectorModel
    
    Parameters:
    
    index - the class index to get the weight vector for
    
    Returns:
    
    the bias term for the specified class
  - numWeightsVecs
```
public int numWeightsVecs()
```
    Description copied from interface: SimpleWeightVectorModel
    
    Returns the number of weight vectors that can be returned. For binary classification problems the value may be 1 if only a single weight vector's sign is used to determine the class. For multi-class problems, the weight vector count includes the implicit zero vector (if one is being used).
    
    Specified by:
    
    numWeightsVecs in interface SimpleWeightVectorModel
    
    Returns:
    
    the number of weight vectors for which SimpleWeightVectorModel.getRawWeight(int) can be called.
  - clone
```
public LogisticRegression clone()
```
    Specified by:
    
    clone in interface Classifier
    
    Specified by:
    
    clone in interface Regressor
    
    Overrides:
    
    clone in class Object
  - classify
```
public CategoricalResults classify(DataPoint data)
```
    Description copied from interface: Classifier
    
    Performs classification on the given data point.
    
    Specified by:
    
    classify in interface Classifier
    
    Parameters:
    
    data - the data point to classify
    
    Returns:
    
    the results of the classification.
  - trainC
```
public void trainC(ClassificationDataSet dataSet,
                   ExecutorService threadPool)
```
    Description copied from interface: Classifier
    
    Trains the classifier and constructs a model for classification using the given data set. If the training method knows how, it will used the threadPool to conduct training in parallel. This method will block until the training has completed.
    
    Specified by:
    
    trainC in interface Classifier
    
    Parameters:
    
    dataSet - the data set to train on
    
    threadPool - the source of threads to use.
  - trainC
```
public void trainC(ClassificationDataSet dataSet)
```
    Description copied from interface: Classifier
    
    Trains the classifier and constructs a model for classification using the given data set.
    
    Specified by:
    
    trainC in interface Classifier
    
    Parameters:
    
    dataSet - the data set to train on

Class LogisticRegression

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

LogisticRegression

Method Detail

getCoefficents

regress

train

train

supportsWeightedData

getRawWeight

getBias

getRawWeight

getBias

numWeightsVecs

clone

classify

trainC

trainC