gingado


Namegingado JSON
Version 0.2.5 PyPI version JSON
download
home_pagehttps://github.com/bis-med-it/gingado
SummaryA machine learning library for economics and finance
upload_time2024-10-28 14:24:22
maintainerNone
docs_urlNone
authorDouglas K. G. de Araujo
requires_python>=3.7
licenseApache Software License 2.0
keywords
VCS
bugtrack_url
requirements numpy pandas sdmx1 scikit-learn requests_cache matplotlib requests keras
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Welcome to gingado!

`gingado` seeks to facilitate the use of machine learning in economic
and finance use cases, while promoting good practices. This package aims
to be suitable for beginners and advanced users alike. Use cases may
range from simple data retrievals to experimentation with machine
learning algorithms to more complex model pipelines used in production.

## Overview

`gingado` is a free, open source library built different
functionalities:

- [**data
  augmentation**](https://bis-med-it.github.io/gingado/augmentation.html),
  to add data from official sources, improving the machine models being
  trained by the user;

- **relevant**
  [**datasets**](https://bis-med-it.github.io/gingado/datasets.html),
  both real and simulated, to allow for easier model development and
  comparison;

- **automatic** [**benchmark
  model**](https://bis-med-it.github.io/gingado/benchmark.html), to
  assess candidate models against a reasonably well-performant model;

- **machine learning-based**
  [**estimators**](https://bis-med-it.github.io/gingado/estimators.html),
  to help answer questions of academic or practical importance;

- **support for** [**model
  documentation**](https://bis-med-it.github.io/gingado/documentation.html),
  to embed documentation and ethical considerations in the model
  development phase; and

- [**utilities**](https://bis-med-it.github.io/gingado/utils.html),
  including tools to allow for lagging variables in a straightforward
  way.

Each of these functionalities builds on top of the previous one. They
can be used on a stand-alone basis, together, or even as part of a
larger pipeline from data input to model training to documentation!

<div>

> **Tip**
>
> New functionalities are planned over time, so consider checking
> frequently on `gingado` for the latest toolsets.

</div>

## Install

<div>

> **Note**
>
> Please make sure you have read and understood the license disclaimer
> in the NOTES.md file in our [GitHub
> repository](https://github.com/bis-med-it/gingado) before using
> gingado.

</div>

To install `gingado`, simply run the following code on the terminal:

`$ pip install gingado`

## Attribution

If you use this package in your work, please consider citing Araujo
(2023).

In BibTeX format:

    @techreport{gingado,
        author = {Araujo, Douglas KG},
        title = {gingado: a machine learning library focused on economics and finance},
        series = {BIS Working Paper},
        type = {Working Paper},
        institution = {Bank for International Settlements},
        year = {2023},
        number = {1122}
    }

Over time, new tools that are described in specific papers might be
added (eg, a machine learning-based econometric estimator). Please
consider citing them as well if used in your work. Specific information,
if any, can be found in the documentation.

## Design principles

The choices made during development of `gingado` derive from the
following principles, in no particular order:

- **flexibility**: users can use `gingado` out of the box or build
  custom processes on top of it;

- **compatibility**: `gingado` works well with other widely used
  libraries in machine learning, such as `scikit-learn` and `pandas`;
  and

- **responsibility**: `gingado` facilitates and promotes model
  documentation, including ethical considerations, as part of the
  machine learning development workflow.

For more information about `gingado`, please read the
[paper](https://www.bis.org/publ/work1122.pdf).

## Acknowledgements

`gingado`’s API is inspired on the following libraries:

- `scikit-learn` (Buitinck et al. 2013)

- `keras` (website [here](https://keras.io/about/) and also, [this
  essay](https://medium.com/s/story/notes-to-myself-on-software-engineering-c890f16f4e4d))

- `fastai` (Howard and Gugger 2020)

In addition, `gingado` is developed and maintained using
[`quarto`](https://quarto.org/).

## References

<div id="refs" class="references csl-bib-body hanging-indent">

<div id="ref-gingado" class="csl-entry">

Araujo, Douglas KG. 2023. “Gingado: A Machine Learning Library Focused
on Economics and Finance.” Working Paper 1122. BIS Working Paper. Bank
for International Settlements.

</div>

<div id="ref-sklearnAPI" class="csl-entry">

Buitinck, Lars, Gilles Louppe, Mathieu Blondel, Fabian Pedregosa,
Andreas Mueller, Olivier Grisel, Vlad Niculae, et al. 2013. “API Design
for Machine Learning Software: Experiences from the Scikit-Learn
Project.” *CoRR* abs/1309.0238. <http://arxiv.org/abs/1309.0238>.

</div>

<div id="ref-fastaiAPI" class="csl-entry">

Howard, Jeremy, and Sylvain Gugger. 2020. “Fastai: A Layered API for
Deep Learning.” *Information* 11 (2).
<https://doi.org/10.3390/info11020108>.

</div>

</div>



            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/bis-med-it/gingado",
    "name": "gingado",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": null,
    "keywords": null,
    "author": "Douglas K. G. de Araujo",
    "author_email": "Douglas.Araujo@bis.org",
    "download_url": "https://files.pythonhosted.org/packages/75/47/ac5110b7ca6e2db931249961747caae0121559e5bbe6b69616880295112c/gingado-0.2.5.zip",
    "platform": null,
    "description": "# Welcome to gingado!\n\n`gingado` seeks to facilitate the use of machine learning in economic\nand finance use cases, while promoting good practices. This package aims\nto be suitable for beginners and advanced users alike. Use cases may\nrange from simple data retrievals to experimentation with machine\nlearning algorithms to more complex model pipelines used in production.\n\n## Overview\n\n`gingado` is a free, open source library built different\nfunctionalities:\n\n- [**data\n  augmentation**](https://bis-med-it.github.io/gingado/augmentation.html),\n  to add data from official sources, improving the machine models being\n  trained by the user;\n\n- **relevant**\n  [**datasets**](https://bis-med-it.github.io/gingado/datasets.html),\n  both real and simulated, to allow for easier model development and\n  comparison;\n\n- **automatic** [**benchmark\n  model**](https://bis-med-it.github.io/gingado/benchmark.html), to\n  assess candidate models against a reasonably well-performant model;\n\n- **machine learning-based**\n  [**estimators**](https://bis-med-it.github.io/gingado/estimators.html),\n  to help answer questions of academic or practical importance;\n\n- **support for** [**model\n  documentation**](https://bis-med-it.github.io/gingado/documentation.html),\n  to embed documentation and ethical considerations in the model\n  development phase; and\n\n- [**utilities**](https://bis-med-it.github.io/gingado/utils.html),\n  including tools to allow for lagging variables in a straightforward\n  way.\n\nEach of these functionalities builds on top of the previous one. They\ncan be used on a stand-alone basis, together, or even as part of a\nlarger pipeline from data input to model training to documentation!\n\n<div>\n\n> **Tip**\n>\n> New functionalities are planned over time, so consider checking\n> frequently on `gingado` for the latest toolsets.\n\n</div>\n\n## Install\n\n<div>\n\n> **Note**\n>\n> Please make sure you have read and understood the license disclaimer\n> in the NOTES.md file in our [GitHub\n> repository](https://github.com/bis-med-it/gingado) before using\n> gingado.\n\n</div>\n\nTo install `gingado`, simply run the following code on the terminal:\n\n`$ pip install gingado`\n\n## Attribution\n\nIf you use this package in your work, please consider citing Araujo\n(2023).\n\nIn BibTeX format:\n\n    @techreport{gingado,\n        author = {Araujo, Douglas KG},\n        title = {gingado: a machine learning library focused on economics and finance},\n        series = {BIS Working Paper},\n        type = {Working Paper},\n        institution = {Bank for International Settlements},\n        year = {2023},\n        number = {1122}\n    }\n\nOver time, new tools that are described in specific papers might be\nadded (eg, a machine learning-based econometric estimator). Please\nconsider citing them as well if used in your work. Specific information,\nif any, can be found in the documentation.\n\n## Design principles\n\nThe choices made during development of `gingado` derive from the\nfollowing principles, in no particular order:\n\n- **flexibility**: users can use `gingado` out of the box or build\n  custom processes on top of it;\n\n- **compatibility**: `gingado` works well with other widely used\n  libraries in machine learning, such as `scikit-learn` and `pandas`;\n  and\n\n- **responsibility**: `gingado` facilitates and promotes model\n  documentation, including ethical considerations, as part of the\n  machine learning development workflow.\n\nFor more information about `gingado`, please read the\n[paper](https://www.bis.org/publ/work1122.pdf).\n\n## Acknowledgements\n\n`gingado`\u2019s API is inspired on the following libraries:\n\n- `scikit-learn` (Buitinck et al. 2013)\n\n- `keras` (website [here](https://keras.io/about/) and also, [this\n  essay](https://medium.com/s/story/notes-to-myself-on-software-engineering-c890f16f4e4d))\n\n- `fastai` (Howard and Gugger 2020)\n\nIn addition, `gingado` is developed and maintained using\n[`quarto`](https://quarto.org/).\n\n## References\n\n<div id=\"refs\" class=\"references csl-bib-body hanging-indent\">\n\n<div id=\"ref-gingado\" class=\"csl-entry\">\n\nAraujo, Douglas KG. 2023. \u201cGingado: A Machine Learning Library Focused\non Economics and Finance.\u201d Working Paper 1122. BIS Working Paper. Bank\nfor International Settlements.\n\n</div>\n\n<div id=\"ref-sklearnAPI\" class=\"csl-entry\">\n\nBuitinck, Lars, Gilles Louppe, Mathieu Blondel, Fabian Pedregosa,\nAndreas Mueller, Olivier Grisel, Vlad Niculae, et al. 2013. \u201cAPI Design\nfor Machine Learning Software: Experiences from the Scikit-Learn\nProject.\u201d *CoRR* abs/1309.0238. <http://arxiv.org/abs/1309.0238>.\n\n</div>\n\n<div id=\"ref-fastaiAPI\" class=\"csl-entry\">\n\nHoward, Jeremy, and Sylvain Gugger. 2020. \u201cFastai: A Layered API for\nDeep Learning.\u201d *Information* 11 (2).\n<https://doi.org/10.3390/info11020108>.\n\n</div>\n\n</div>\n\n\n",
    "bugtrack_url": null,
    "license": "Apache Software License 2.0",
    "summary": "A machine learning library for economics and finance",
    "version": "0.2.5",
    "project_urls": {
        "Homepage": "https://github.com/bis-med-it/gingado"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "890b9fb0ad5b69eb4696e2779f00a027da56c1426a8362e63069f19d7fdb0191",
                "md5": "0318d8b67b1071b4ad559d23923d8288",
                "sha256": "c73ea4b28828077545fa29f9e4dfc8485b30459a1469812f4ca71ee6cbcb9f86"
            },
            "downloads": -1,
            "filename": "gingado-0.2.5-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "0318d8b67b1071b4ad559d23923d8288",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 5153402,
            "upload_time": "2024-10-28T14:24:19",
            "upload_time_iso_8601": "2024-10-28T14:24:19.732115Z",
            "url": "https://files.pythonhosted.org/packages/89/0b/9fb0ad5b69eb4696e2779f00a027da56c1426a8362e63069f19d7fdb0191/gingado-0.2.5-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "7547ac5110b7ca6e2db931249961747caae0121559e5bbe6b69616880295112c",
                "md5": "4e3afbe4cb39b3ed8075517a24f7731e",
                "sha256": "992e07f1c140b28a16ce83181fcb4af916fc43d93d3c36cf6298ac7d60cd4b31"
            },
            "downloads": -1,
            "filename": "gingado-0.2.5.zip",
            "has_sig": false,
            "md5_digest": "4e3afbe4cb39b3ed8075517a24f7731e",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 5162363,
            "upload_time": "2024-10-28T14:24:22",
            "upload_time_iso_8601": "2024-10-28T14:24:22.371748Z",
            "url": "https://files.pythonhosted.org/packages/75/47/ac5110b7ca6e2db931249961747caae0121559e5bbe6b69616880295112c/gingado-0.2.5.zip",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-10-28 14:24:22",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "bis-med-it",
    "github_project": "gingado",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "requirements": [
        {
            "name": "numpy",
            "specs": [
                [
                    ">=",
                    "1.21"
                ]
            ]
        },
        {
            "name": "pandas",
            "specs": [
                [
                    ">=",
                    "1.3.5"
                ]
            ]
        },
        {
            "name": "sdmx1",
            "specs": [
                [
                    ">=",
                    "2.15.0"
                ]
            ]
        },
        {
            "name": "scikit-learn",
            "specs": [
                [
                    ">=",
                    "1.0.2"
                ]
            ]
        },
        {
            "name": "requests_cache",
            "specs": [
                [
                    ">=",
                    "0.9.1"
                ]
            ]
        },
        {
            "name": "matplotlib",
            "specs": [
                [
                    ">=",
                    "3.5"
                ]
            ]
        },
        {
            "name": "requests",
            "specs": [
                [
                    ">=",
                    "2.31.0"
                ]
            ]
        },
        {
            "name": "keras",
            "specs": [
                [
                    ">=",
                    "3.5.0"
                ]
            ]
        }
    ],
    "lcname": "gingado"
}
        
Elapsed time: 0.32231s