https://github.com/antononcube/python-regressionizer
Python package with a class that allows pipeline-like specification and execution of regression workflows.
https://github.com/antononcube/python-regressionizer
conditional-cumulative-distribution-function cumulative-distribution-function least-squares monad outlier-detection outliers outliers-detection python quantile-regression regression residual-plot visualization workflow
Last synced: 6 days ago
JSON representation
Python package with a class that allows pipeline-like specification and execution of regression workflows.
- Host: GitHub
- URL: https://github.com/antononcube/python-regressionizer
- Owner: antononcube
- License: gpl-3.0
- Created: 2024-08-19T18:31:36.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-07T16:10:53.000Z (10 months ago)
- Last Synced: 2025-09-15T06:26:46.942Z (28 days ago)
- Topics: conditional-cumulative-distribution-function, cumulative-distribution-function, least-squares, monad, outlier-detection, outliers, outliers-detection, python, quantile-regression, regression, residual-plot, visualization, workflow
- Language: Python
- Homepage: https://pypi.org/project/Regressionizer
- Size: 4.89 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Regressionizer
Python package with a class that allows pipeline-like specification and execution of regression workflows.
Extensive guide is given in the Jupyter notebook
["Rapid-specification-of-regression-workflows.ipynb"](https://github.com/antononcube/Python-Regressionizer/blob/main/docs/Rapid-specification-of-regression-workflows.ipynb)
and the corresponding Markdown document
["Rapid-specification-of-regression-workflows.md"](https://github.com/antononcube/Python-Regressionizer/blob/main/docs/Rapid-specification-of-regression-workflows.md).
------
## Features summary
- The class `Regressionizer` facilitates rapid specifications of regressions workflows.
- To quickly specify:
- data rescaling and summary
- regression computations
- outliers finding
- conditional Cumulative Distribution Functions (CDFs) reconstruction
- plotting of data, fits, residual errors, outliers, CDFs
- `Regressionizer` works with data frames, numpy arrays, lists of numbers, and lists of numeric pairs.
### Details and arguments
- The curves computed with Quantile Regression are called **regression quantiles**.
- `Regressionizer` has three regression methods:
- `quantile_regression`
- `quantile_regression_fit`
- `least_squares_fit`
- The regression quantiles computed with the methods `quantile_regression` and `quantile_regression_fit`
correspond to probabilities specified with the argument `probs`.
- The method`quantile_regression` computes fits using a B-spline functions basis.
- The basis is specified with the arguments `knots` and `order`.
- `order` is 3 by default.
- The methods `quantile_regession_fit` and `least_squares_fit` use lists of basis functions to fit with
specified with the argument `funcs`.
### Workflows flowchart
The following flowchart summarizes the workflows that are supported by `Regressionizer`:
------
## Usage examples
Import libraries:
```python
from Regressionizer import *
import numpy as np
```
Generate random data:
```python
np.random.seed(0)
x = np.linspace(0, 2, 300)
y = np.sin(2 * np.pi * x) + np.random.normal(0, 0.4, x.shape)
data = np.column_stack((x, y)
```
Compute quantile regression for probabilities `[0.2, 0.5, 0.8]` and make the corresponding plot:
```python
obj = (Regressionizer(data)
.quantile_regression(knots=8, probs=[0.2, 0.5, 0.8])
.plot(title="B-splines fit", template="plotly")
)
```
Show the plot obtained above:
```python
obj.take_value().show()
```
------
## References
### Articles, books
[RK1] Roger Koenker,
[Quantile Regression](https://books.google.com/books/about/Quantile_Regression.html?id=hdkt7V4NXsgC),
Cambridge University Press, 2005.
[RK2] Roger Koenker,
["Quantile Regression in R: a vignette"](https://cran.r-project.org/web/packages/quantreg/vignettes/rq.pdf),
(2006),
[CRAN](https://cran.r-project.org/).
[AA1] Anton Antonov,
["A monad for Quantile Regression workflows"](https://github.com/antononcube/MathematicaForPrediction/blob/master/MarkdownDocuments/A-monad-for-Quantile-Regression-workflows.md),
(2018),
[MathematicaForPrediction at GitHub](https://github.com/antononcube/MathematicaForPrediction).
### Packages, paclets
[RKp1] Roger Koenker,
[`quantreg`](https://cran.r-project.org/web/packages/quantreg/index.html),
[CRAN](https://cran.r-project.org/).
[AAp1] Anton Antonov,
[Quantile Regression WL paclet](https://github.com/antononcube/WL-QuantileRegression-paclet),
(2014-2023),
[GitHub/antononcube](https://github.com/antononcube).
[AAp2] Anton Antonov,
[Monadic Quantile Regression WL paclet](https://github.com/antononcube/WL-MonadicQuantileRegression-paclet),
(2018-2024),
[GitHub/antononcube](https://github.com/antononcube).
[AAp3] Anton Antonov,
[`QuantileRegression`](https://resources.wolframcloud.com/FunctionRepository/resources/QuantileRegression),
(2019),
[Wolfram Function Repository](https://resources.wolframcloud.com/FunctionRepository/resources/QuantileRegression).
### Repositories
[AAr1] Anton Antonov,
[DSL::English::QuantileRegressionWorkflows in Raku](https://github.com/antononcube/Raku-DSL-English-QuantileRegressionWorkflows),
(2020),
[GitHub/antononcube](https://github.com/antononcube/Raku-DSL-English-QuantileRegressionWorkflows).
### Videos
[AAv1] Anton Antonov,
["Boston useR! QuantileRegression Workflows 2019-04-18"](https://www.youtube.com/watch?v=a_Dk25xarvE),
(2019),
[Anton Antonov at YouTube](https://www.youtube.com/@AAA4Prediction).
[AAv2] Anton Antonov,
["useR! 2020: How to simplify Machine Learning workflows specifications"](https://www.youtube.com/watch?v=b9Uu7gRF5KY),
(2020),
[R Consortium at YouTube](https://www.youtube.com/channel/UC_R5smHVXRYGhZYDJsnXTwg).