# MLJLinearModels.jl

This is a convenience package gathering functionalities to solve a number of generalised linear regression/classification problems which, inherently, correspond to an optimisation problem of the form

where:

- $y$ is the
**target**or**response**, a vector of length $n$ either of real values (*regression*) or integers (*classification*), - $X$ is the
**design**or**feature**matrix, a matrix of real values of size $n \times p$ where $p$ is the number of*features*or*dimensions*, - $\theta$ is a vector of $p$ real valued coefficients to determine,
- $L$ is a
**loss function**, a pre-determined function of $\mathbb R^n \times \mathbb R^n$ to $\mathbb R^+$ penalising the amplitude of the*residuals*in a specific way, - $P$ is a
**penalty function**, a pre-determined function of $\mathbb R^n$ to $\mathbb R^+$ penalising the amplitude of the*coefficients*in a specific way.

A well known example is the Ridge regression where the objective is to minimise:

Head to the Quick Start page to get an idea of how this package works.

## What this package aims to do

- make these regressions models "easy to call" and callable in a unified way,
- seamless interface with MLJ.jl,
- focus on performance including in "big data" settings exploiting packages such as Optim.jl, and IterativeSolvers.jl,

All models allow to fit an intercept and allow the penalty to be optionally applied on the intercept. All models attempt to be efficient in terms of memory allocation to avoid unnecessary copies of the data.

## What this package does not aim to do

This package deliberately does not offer the following features

- facilities for data pre-processing (use MLJ for that),
- facilities for hyperparameter tuning (use MLJ for that)
- "significance" statistics (consider GLM for that)

The last point is important, the package assumes that the user has some principled way of picking an appropriate loss function / penalty. The package makes no assumption of normality etc which befalls the realm of statistics.

You can still build data-driven uncertainty estimates around your parameters if you so desire by using Bootstrap.jl.