% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/projection.R
\name{plot.projsel}
\alias{plot.projsel}
\title{Plot of relative explanatory power of predictors}
\usage{
\method{plot}{projsel}(
  x,
  title = NULL,
  max.points = NULL,
  max.labels = NULL,
  from.covariates = TRUE,
  font.size = 12,
  hadj = 0.05,
  vadj = 0,
  ...
)
}
\arguments{
\item{x}{A data frame created by \code{\link[=projsel]{projsel()}}.}

\item{title}{Title of the plot. If \code{NULL}, no title is displayed.}

\item{max.points}{Maximum number of predictors to be plotted. If \code{NULL}
(default) or 0, all points are plotted.}

\item{max.labels}{Maximum number of predictors to be labelled. If \code{NULL}
(default), all predictor labels present in \code{x} are displayed, which
may result in overprinting.}

\item{from.covariates}{Whether the plotting should start from the unpenalized
covariates (\code{TRUE} by default). If set to \code{FALSE}, the plot includes a
point for the null (intercept-only) model.}

\item{font.size}{Size of the textual elements (labels and axes).}

\item{hadj, vadj}{Horizontal and vertical adjustment for the labels.}

\item{...}{Currently ignored.}
}
\value{
A \strong{ggplot2} object showing the relative incremental contribution of each
predictor starting from the initial set of unpenalized covariates.
}
\description{
The function plots the relative explanatory power of each predictor in order
of selection. The relative explanatory power of predictors is computed
according to the KL divergence from the full model to each submodel, scaled
in such a way that the baseline model (either the null model or the model
containing only unpenalized covariates) is at 0, while the full model is at 1.
}