Packages

c

scalation.analytics.classifier

LogisticRegression

class LogisticRegression extends ClassifierReal

The LogisticRegression class supports (binomial) logistic regression. In this case, 'x' may be multi-dimensional '[1, x_1, ... x_k]'. Fit the parameter vector 'b' in the logistic regression equation

y = b dot x + e = b_0 + b_1 * x_1 + ... b_k * x_k + e

where 'e' represents the residuals (the part not explained by the model) and 'y' is now binary.

See also

see.stanford.edu/materials/lsoeldsee263/05-ls.pdf

Linear Supertypes
ClassifierReal, Error, Classifier, AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. LogisticRegression
  2. ClassifierReal
  3. Error
  4. Classifier
  5. AnyRef
  6. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Instance Constructors

  1. new LogisticRegression(x: MatrixD, y: VectorI, fn: Array[String], cn: Array[String] = Array ("no", "yes"))

    x

    the input/design matrix augmented with a first column of ones

    y

    the binary response vector, y_i in {0, 1}

    fn

    the names for all factors

    cn

    the names for both classes

Value Members

  1. def calcCorrelation: MatriD

    Calculate the correlation matrix for the feature vectors 'fea'.

    Calculate the correlation matrix for the feature vectors 'fea'. If the correlations are too high, the independence assumption may be dubious.

    Definition Classes
    ClassifierReal
  2. def classify(z: VectoD): (Int, String, Double)

    Classify the value of y = f(z) by evaluating the formula y = sigmoid (b dot z).

    Classify the value of y = f(z) by evaluating the formula y = sigmoid (b dot z). Return the best class, its name and FIX.

    z

    the new vector to classify

    Definition Classes
    LogisticRegressionClassifier
  3. def classify(z: VectoI): (Int, String, Double)

    Given a new discrete (integer-valued) data vector 'z', determine which class it belongs to, by first converting it to a vector of doubles.

    Given a new discrete (integer-valued) data vector 'z', determine which class it belongs to, by first converting it to a vector of doubles. Return the best class, its name and its relative probability

    z

    the vector to classify

    Definition Classes
    ClassifierRealClassifier
  4. def crossValidate(nx: Int = 10): Double

    Test the accuracy of the classified results by cross-validation, returning the accuracy.

    Test the accuracy of the classified results by cross-validation, returning the accuracy. The "test data" starts at 'testStart' and ends at 'testEnd', the rest of the data is "training data'.

    nx

    the number of crosses and cross-validations (defaults to 5x).

    Definition Classes
    Classifier
  5. def crossValidateRand(nx: Int = 10): Double

    Test the accuracy of the classified results by cross-validation, returning the accuracy.

    Test the accuracy of the classified results by cross-validation, returning the accuracy. This version of cross-validation relies on "subtracting" frequencies from the previously stored global data to achieve efficiency.

    nx

    number of crosses and cross-validations (defaults to 10x).

    Definition Classes
    Classifier
  6. def fit: (VectorD, Double, Double, Double, Double)

    Return the fit (parameter vector b, quality of fit).

    Return the fit (parameter vector b, quality of fit). Assumes both train_null and train have already been called.

  7. final def flaw(method: String, message: String): Unit
    Definition Classes
    Error
  8. def ll(b: VectorD): Double

    For a given parameter vector 'b', compute '-2 * Log-Likelihood (-2LL)'.

    For a given parameter vector 'b', compute '-2 * Log-Likelihood (-2LL)'. '-2LL' is the standard measure that follows a Chi-Square distribution.

    b

    the parameters to fit

    See also

    www.statisticalhorizons.com/wp-content/uploads/Allison.StatComp.pdf

    www.stat.cmu.edu/~cshalizi/350/lectures/26/lecture-26.pdf

  9. def ll_null(b: VectorD): Double

    For a given parameter vector 'b = [b(0)]', compute '-2 * Log-Likelihood (-2LL)'.

    For a given parameter vector 'b = [b(0)]', compute '-2 * Log-Likelihood (-2LL)'. '-2LL' is the standard measure that follows a Chi-Square distribution.

    b

    the parameters to fit

    See also

    www.statisticalhorizons.com/wp-content/uploads/Allison.StatComp.pdf

    www.stat.cmu.edu/~cshalizi/350/lectures/26/lecture-26.pdf

  10. def reset(): Unit

    Reset or re-initialize the frequency tables and the probability tables.

    Reset or re-initialize the frequency tables and the probability tables.

    Definition Classes
    LogisticRegressionClassifier
  11. def size: Int

    Return the number of data vectors in training/test-set (# rows).

    Return the number of data vectors in training/test-set (# rows).

    Definition Classes
    ClassifierRealClassifier
  12. def test(xx: MatrixD, yy: VectorI): Double

    Test the quality of the training with a test-set and return the fraction of correct classifications.

    Test the quality of the training with a test-set and return the fraction of correct classifications.

    xx

    the real-valued test vectors stored as rows of a matrix

    yy

    the test classification vector, where 'yy_i = class for row i of xx'

    Definition Classes
    ClassifierReal
  13. def test(testStart: Int, testEnd: Int): Double

    Test the quality of the training with a test-set and return the fraction of correct classifications.

    Test the quality of the training with a test-set and return the fraction of correct classifications.

    testStart

    beginning of test region (inclusive)

    testEnd

    end of test region (exclusive)

    Definition Classes
    ClassifierRealClassifier
  14. def test(itest: VectorI): Double

    Test the quality of the training with a test-set and return the fraction of correct classifications.

    Test the quality of the training with a test-set and return the fraction of correct classifications.

    itest

    the indices of the instances considered test data

    Definition Classes
    Classifier
  15. def train(testStart: Int, testEnd: Int): Unit

    For the full model, train the classifier by fitting the parameter vector (b-vector) in the logistic regression equation using maximum likelihood.

    For the full model, train the classifier by fitting the parameter vector (b-vector) in the logistic regression equation using maximum likelihood. Do this by minimizing '-2LL'. FIX: Use improved BFGS implementation or IRWLS

    testStart

    starting index of test region (inclusive) used in cross-validation.

    testEnd

    ending index of test region (exclusive) used in cross-validation.

    Definition Classes
    LogisticRegressionClassifier
    See also

    en.wikipedia.org/wiki/Iteratively_reweighted_least_squares

    stats.stackexchange.com/questions/81000/calculate-coefficients-in-a-logistic-regression-with-r

  16. def train(): Unit

    Given a set of data vectors and their classifications, build a classifier.

    Given a set of data vectors and their classifications, build a classifier.

    Definition Classes
    Classifier
  17. def train(itest: IndexedSeq[Int]): Unit

    Given a set of data vectors and their classifications, build a classifier.

    Given a set of data vectors and their classifications, build a classifier.

    itest

    the indices of the instances considered as testing data

    Definition Classes
    Classifier
  18. def train_null(): Unit

    For the null model, train the classifier by fitting the parameter vector (b-vector) in the logistic regression equation using maximum likelihood.

    For the null model, train the classifier by fitting the parameter vector (b-vector) in the logistic regression equation using maximum likelihood. Do this by minimizing -2LL.