aurelius (version 0.8.4)

pfa.glm: PFA Formatting of Fitted GLMs

Description

This function takes a generalized linear model fit using glm and returns a list-of-lists representing in valid PFA document that could be used for scoring

Usage

# S3 method for glm
pfa(object, name = NULL, version = NULL, doc = NULL,
  metadata = NULL, randseed = NULL, options = NULL,
  pred_type = c("response", "prob"), cutoffs = NULL, ...)

Arguments

object

an object of class "glm"

name

a character which is an optional name for the scoring engine

version

an integer which is sequential version number for the model

doc

a character which is documentation string for archival purposes

metadata

a list of strings that is computer-readable documentation for archival purposes

randseed

a integer which is a global seed used to generate all random numbers. Multiple scoring engines derived from the same PFA file have different seeds generated from the global one

options

a list with value types depending on option name Initialization or runtime options to customize implementation (e.g. optimization switches). May be overridden or ignored by PFA consumer

pred_type

a string with value "response" for returning a prediction on the same scale as what was provided during modeling, or value "prob", which for classification problems returns the probability of each class.

cutoffs

(Classification only) A named numeric vector of length equal to number of classes. The "winning" class for an observation is the one with the maximum ratio of predicted probability to its cutoff. The default cutoffs assume the same cutoff for each class that is 1/k where k is the number of classes

...

additional arguments affecting the PFA produced

Value

a list of lists that compose valid PFA document

See Also

glm extract_params.glm

Examples

X1 <- rnorm(100)
X2 <- runif(100)
Y <- 3 - 5 * X1 + 3 * X2 + rnorm(100, 0, 3)
Y <- Y > 0

glm_model <- glm(Y ~ X1 + X2, family = binomial(logit))
model_as_pfa <- pfa(glm_model)