mlsauce
Miscellaneous Statistical/Machine learning stuff.
Contents
Installation for Python and R |
Package description |
Quick start |
Contributing |
Tests |
Dependencies |
Citing mlsauce |
API Documentation |
References |
License
Installation (for Python and R)
Python
- 1st method
pip install mlsauce --verbose
- 2nd method: from Github, for the development version
pip install git+https://github.com/Techtonique/mlsauce.git --verbose
- 3r method: using
conda
conda install -c conda-forge mlsauce
(Note to self or developers: https://github.com/conda-forge/mlsauce-feedstock and https://conda-forge.org/docs/maintainer/adding_pkgs.html#step-by-step-instructions)
R
From GitHub
remotes::install_github("Techtonique/mlsauce_r") # the repo is in this organization
From R-universe
install.packages('mlsauce', repos = c('https://techtonique.r-universe.dev',
'https://cloud.r-project.org'))
General rule for using the package in R: object accesses with .'s are replaced by $'s. R Examples can be found in the package, once installed, by typing (in R console):
?mlsauce::AdaOpt
For a list of available models, visit https://techtonique.github.io/mlsauce/.
Docker
make docker-build ## Build Docker image for mlsauce
make docker-run-examples # test thoroughly
make docker-pypi-release # Run an interactive shell inside the mlsauce Docker container
Package description
Miscellaneous Statistical/Machine learning stuff. See next section.
Quick start
Examples can be found here on GitHub. You can also read about this package here, and in particular for LSBoost: https://thierrymoudiki.github.io/blog/#LSBoost.
Contributing
Your contributions are welcome, and valuable. Please, make sure to read the Code of Conduct first. If you're not comfortable with Git/Version Control yet, please use this form to provide a feedback.
In Pull Requests, let's strive to use black for formatting files:
pip install black
black --line-length=80 file_submitted_for_pr.py
A few things that we could explore are:
- Enrich the tests
- Continue to make
mlsauceavailable toRusers --> here - Any benchmarking of
mlsaucemodels can be stored in demo (notebooks) or examples (flat files), with the following naming convention:yourgithubname_ddmmyy_shortdescriptionofdemo.[py|ipynb|R|Rmd]
Tests
Ultimately, tests for mlsauce's features will be located here. In order to run them and obtain tests' coverage (using nose2), you'll do:
- Install packages required for testing:
pip install nose2
pip install coverage
- Run tests and print coverage:
git clone https://github.com/thierrymoudiki/mlsauce.git
cd mlsauce
nose2 --with-coverage
- Obtain coverage reports:
At the command line:
coverage report -m
or an html report:
coverage html
Note to self and developpers: https://conda-forge.org/docs/maintainer/adding_pkgs.html#step-by-step-instructions
API Documentation
Dependencies
- Numpy
- Scipy
- scikit-learn
- querier
Citation
@misc{moudiki2019mlsauce,
author={Moudiki, Thierry},
title={\code{mlsauce}, {M}iscellaneous {S}tatistical/{M}achine {L}earning stuff},
howpublished={\url{https://github.com/thierrymoudiki/mlsauce}},
note={BSD 3-Clause Clear License. Version 0.x.x.},
year={2019--2020}
}
References
-
Moudiki, T. (2020). LSBoost, gradient boosted penalized nonlinear least squares. Available at: https://www.researchgate.net/publication/346059361_LSBoost_gradient_boosted_penalized_nonlinear_least_squares
-
Moudiki, T. (2020). AdaOpt: Multivariable optimization for classification. Available at: https://www.researchgate.net/publication/341409169_AdaOpt_Multivariable_optimization_for_classification
License
BSD 3-Clause © Thierry Moudiki, 2019.
Credits
This package was created with Cookiecutter and the project template.
Metadata
Release files for mlsauce 0.41.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mlsauce-0.41.1.tar.gz | 142.1 kB | Details |
Release files / mlsauce-0.41.1.tar.gz
| Download URL | mlsauce-0.41.1.tar.gz |
|---|---|
| Size | 142.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
095cd913cb061b4b785bf9f7617997c4edecbd91031bfdd96b4b86c6a629be5f
|
|
BLAKE2b-256 checksum How to use checksums |
e58e3009bfaa55ead3d61856023dd0a678fee55d07f5a8c1e04c83ecb0253729
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|