logistf.control: Control Parameters for 'logistf'

Description Usage Arguments Details Value Examples

View source: R/logistf.control.R

Description

Sets parameters for iterations in Firth's penalized-likelihood logistic regression.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
logistf.control(
  maxit = 25,
  maxhs = 0,
  maxstep = 5,
  lconv = 1e-05,
  gconv = 1e-05,
  xconv = 1e-05,
  collapse = TRUE,
  fit = "NR"
)

Arguments

maxit

The maximum number of iterations

maxhs

The maximum number of step-halvings in one iteration. The increment of the beta vector within one iteration is divided by 2 if the new beta leads to a decrease in log likelihood.

maxstep

Specifies the maximum step size in the beta vector within one iteration. Set to -1 for infinite stepsize.

lconv

Specifies the convergence criterion for the log likelihood.

gconv

Specifies the convergence criterion for the first derivative of the log likelihood (the score vector).

xconv

Specifies the convergence criterion for the parameter estimates.

collapse

If TRUE, evaluates all unique combinations of x and y and collapses data set.

fit

Fitting method used. One of Newton-Raphson: "NR" or Iteratively reweighted least squares: "IRLS"

Details

logistf.control() is used by logistf and logistftest to set control parameters to default values. Different values can be specified, e. g., by logistf(..., control= logistf.control(maxstep=1)).

Value

maxit

The maximum number of iterations

maxhs

The maximum number of step-halvings in one iteration. The increment of the beta vector within one iteration is divided by 2 if the new beta leads to a decrease in log likelihood.

maxstep

Specifies the maximum step size in the beta vector within one iteration.

lconv

Specifies the convergence criterion for the log likelihood.

gconv

Specifies the convergence criterion for the first derivative of the log likelihood (the score vector).

xconv

Specifies the convergence criterion for the parameter estimates.

collapse

If TRUE, evaluates all unique combinations of x and y and collapses data set.

fit

Fitting method used. One of Newton-Raphson: "NR" or Iteratively reweighted least squares: "IRLS"

call

The function call.

Examples

1
2
3
4
data(sexagg)
fit2<-logistf(case ~ age+oc+vic+vicl+vis+dia, data=sexagg, weights=COUNT, 
control=logistf.control(maxstep=1))
summary(fit2)

logistf documentation built on Jan. 18, 2022, 5:07 p.m.