{"id":22283588,"url":"https://github.com/statmixedml/lightgbmlss","last_synced_at":"2025-04-04T18:09:41.074Z","repository":{"id":37308685,"uuid":"276845735","full_name":"StatMixedML/LightGBMLSS","owner":"StatMixedML","description":"An extension of LightGBM to probabilistic modelling","archived":false,"fork":false,"pushed_at":"2024-06-11T19:38:31.000Z","size":33536,"stargazers_count":297,"open_issues_count":9,"forks_count":31,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-03-28T17:11:09.871Z","etag":null,"topics":["distributional-regression","gamlss","lightgbm","machine-learning","mixture-density-model","normalizing-flows","prediction-intervals","probabilistic-forecasting","uncertainty-estimation"],"latest_commit_sha":null,"homepage":"https://statmixedml.github.io/LightGBMLSS/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/StatMixedML.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-07-03T08:14:45.000Z","updated_at":"2025-03-27T17:20:34.000Z","dependencies_parsed_at":"2023-01-28T12:02:08.091Z","dependency_job_id":"1b293c23-b369-4b81-ba0e-a5f818c5497c","html_url":"https://github.com/StatMixedML/LightGBMLSS","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StatMixedML%2FLightGBMLSS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StatMixedML%2FLightGBMLSS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StatMixedML%2FLightGBMLSS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StatMixedML%2FLightGBMLSS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/StatMixedML","download_url":"https://codeload.github.com/StatMixedML/LightGBMLSS/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247226215,"owners_count":20904465,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["distributional-regression","gamlss","lightgbm","machine-learning","mixture-density-model","normalizing-flows","prediction-intervals","probabilistic-forecasting","uncertainty-estimation"],"created_at":"2024-12-03T16:41:11.945Z","updated_at":"2025-04-04T18:09:41.057Z","avatar_url":"https://github.com/StatMixedML.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch4 align=\"center\"\u003e\n\n![Python Version](https://img.shields.io/badge/python-3.10%20|%20%203.11-lightblue.svg)\n![GitHub tag (with filter)](https://img.shields.io/github/v/tag/StatMixedML/LightGBMLSS?label=release\u0026color=lightblue)\n\u003cimg src=\"https://github.com/StatMixedML/LightGBMLSS/actions/workflows/mkdocs.yaml/badge.svg\" alt=\"Documentation status badge\"\u003e\n\u003cimg src=\"https://github.com/StatMixedML/LightGBMLSS/workflows/unit-tests/badge.svg\" alt=\"Unit test status badge\"\u003e\n\u003cimg src=\"https://codecov.io/gh/StatMixedML/LightGBMLSS/branch/master/graph/badge.svg\" alt=\"Code coverage status badge\"\u003e\n![Pepy Total Downlods](https://img.shields.io/pepy/dt/lightgbmlss?label=PyPI%20Downloads%2FMonth\u0026color=green)\n\n\u003c/h4\u003e\n\n#\n\u003cimg align=\"right\" width=\"156.5223\" height=\"181.3\" src=\"figures/LightGBMLSS.png\"\u003e\n\n\n# LightGBMLSS - An extension of LightGBM to probabilistic modelling\nWe introduce a comprehensive framework that models and predicts the full conditional distribution of a univariate target as a function of covariates. Choosing from a wide range of continuous, discrete, and mixed discrete-continuous distributions, modelling and predicting the entire conditional distribution greatly enhances the flexibility of LightGBM, as it allows to create probabilistic forecasts from which prediction intervals and quantiles of interest can be derived.\n\n## `Features`\n:white_check_mark: Estimation of all distributional parameters. \u003cbr/\u003e\n:white_check_mark: Normalizing Flows allow modelling of complex and multi-modal distributions. \u003cbr/\u003e\n:white_check_mark: Mixture-Densities can model a diverse range of data characteristics. \u003cbr/\u003e\n:white_check_mark: Zero-Adjusted and Zero-Inflated Distributions for modelling excess of zeros in the data. \u003cbr/\u003e\n:white_check_mark: Automatic derivation of Gradients and Hessian of all distributional parameters using [PyTorch](https://pytorch.org/docs/stable/autograd.html). \u003cbr/\u003e\n:white_check_mark: Automated hyper-parameter search, including pruning, is done via [Optuna](https://optuna.org/). \u003cbr/\u003e\n:white_check_mark: The output of LightGBMLSS is explained using [SHapley Additive exPlanations](https://github.com/dsgibbons/shap). \u003cbr/\u003e\n:white_check_mark: LightGBMLSS provides full compatibility with all the features and functionality of LightGBM. \u003cbr/\u003e\n:white_check_mark: LightGBMLSS is available in Python. \u003cbr/\u003e\n\n## `News`\n:boom: [2024-01-19] Release of LightGBMLSS to [PyPI](https://pypi.org/project/lightgbmlss/). \u003cbr/\u003e\n:boom: [2023-08-28] Release of v0.4.0 introduces Mixture-Densities. See the [release notes](https://github.com/StatMixedML/LightGBMLSS/releases) for an overview. \u003cbr/\u003e\n:boom: [2023-07-20] Release of v0.3.0 introduces Normalizing Flows. See the [release notes](https://github.com/StatMixedML/LightGBMLSS/releases) for an overview. \u003cbr/\u003e\n:boom: [2023-06-22] Release of v0.2.2. See the [release notes](https://github.com/StatMixedML/LightGBMLSS/releases) for an overview. \u003cbr/\u003e\n:boom: [2023-06-15] LightGBMLSS now supports Zero-Inflated and Zero-Adjusted Distributions. \u003cbr/\u003e\n:boom: [2023-05-26] Release of v0.2.1. See the [release notes](https://github.com/StatMixedML/LightGBMLSS/releases) for an overview. \u003cbr/\u003e\n:boom: [2023-05-23] Release of v0.2.0. See the [release notes](https://github.com/StatMixedML/LightGBMLSS/releases) for an overview. \u003cbr/\u003e\n:boom: [2022-01-05] LightGBMLSS now supports estimating the full predictive distribution via [Expectile Regression](https://epub.ub.uni-muenchen.de/31542/1/1471082x14561155.pdf). \u003cbr/\u003e\n:boom: [2022-01-05] LightGBMLSS now supports automatic derivation of Gradients and Hessians. \u003cbr/\u003e\n:boom: [2022-01-04] LightGBMLSS is initialized with suitable starting values to improve convergence of estimation. \u003cbr/\u003e\n:boom: [2022-01-04] LightGBMLSS v0.1.0 is released!\n\n## `Installation`\nTo install the development version, please use\n```python\npip install git+https://github.com/StatMixedML/LightGBMLSS.git\n```\nFor the PyPI version, please use\n```python\npip install lightgbmlss\n```\n\n## `Available Distributions`\nOur framework is built upon PyTorch and Pyro, enabling users to harness a diverse set of distributional families. LightGBMLSS currently supports the [following distributions](https://statmixedml.github.io/LightGBMLSS/distributions/).\n\n## `How to Use`\nPlease visit the [example section](https://statmixedml.github.io/LightGBMLSS/examples/Gaussian_Regression/) for guidance on how to use the framework.\n\n## `Documentation`\nFor more information and context, please visit the [documentation](https://statmixedml.github.io/LightGBMLSS/).\n\n## `Feedback`\nWe encourage you to provide feedback on how to enhance LightGBMLSS or request the implementation of additional distributions by opening a [new discussion](https://github.com/StatMixedML/LightGBMLSS/discussions).\n\n## `How to Cite`\nIf you use LightGBMLSS in your research, please cite it as:\n\n```bibtex\n@misc{Maerz2023,\n  author = {Alexander M\\\"arz},\n  title = {{LightGBMLSS: An Extension of LightGBM to Probabilistic Modelling}},\n  year = {2023},\n  note = {GitHub repository, Version 0.4.0},\n  howpublished = {\\url{https://github.com/StatMixedML/LightGBMLSS}}\n}\n```\n\n## `Reference Paper`\n[![Arxiv link](https://img.shields.io/badge/arXiv-Distributional%20Gradient%20Boosting%20Machines-color=brightgreen)](https://arxiv.org/abs/2204.00778) \u003cbr/\u003e\n[![Arxiv link](https://img.shields.io/badge/arXiv-XGBoostLSS%3A%20An%20extension%20of%20XGBoost%20to%20probabilistic%20forecasting-color=brightgreen)](https://arxiv.org/abs/1907.03178) \u003cbr/\u003e\n\n## `Star History`\n\u003ca href=\"https://star-history.com/#StatMixedML/LightGBMLSS\u0026Date\"\u003e\n    \u003cimg src=\"https://api.star-history.com/svg?repos=StatMixedML/LightGBMLSS\u0026type=Date\" width=\"450\"\u003e\n\u003c/a\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstatmixedml%2Flightgbmlss","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstatmixedml%2Flightgbmlss","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstatmixedml%2Flightgbmlss/lists"}