pudu


Namepudu JSON
Version 0.3.4 PyPI version JSON
download
home_pagehttps://github.com/pudu-py/pudu
SummaryA Python library for explainability of machine learinng algorithms in an agnostic, deterministic, and simple way.
upload_time2024-04-23 13:03:45
maintainerNone
docs_urlNone
authorpudu
requires_python>=3.7
licenseMIT license
keywords pudu
VCS
bugtrack_url
requirements numpy pandas matplotlib spectrapepper scikit-learn tensorflow
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <img src="https://raw.githubusercontent.com/pudu-py/pudu/main/docs/_static/pudu-baner.png" width="70%">

[![image](https://img.shields.io/pypi/v/pudu.svg)](https://pypi.python.org/pypi/pudu)
[![Anaconda-Server Badge](https://anaconda.org/conda-forge/pudu/badges/version.svg)](https://anaconda.org/conda-forge/pudu)
[![image](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![CodeQL](https://github.com/pudu-py/pudu/actions/workflows/codeql.yml/badge.svg)](https://github.com/pudu-py/pudu/actions/workflows/codeql.yml)
[![image](https://github.com/pudu-py/pudu/workflows/docs/badge.svg)](https://pudu-py.github.io/pudu)
[![codecov](https://codecov.io/gh/pudu-py/pudu/branch/main/graph/badge.svg?token=DC0QIwuYel)](https://codecov.io/gh/pudu-py/pudu)
[![Downloads](https://static.pepy.tech/personalized-badge/pudu?period=total&units=abbreviation&left_color=grey&right_color=blue&left_text=pypi%20downloads)](https://pepy.tech/project/pudu)
[![image](https://img.shields.io/conda/dn/conda-forge/pudu?color=blue&label=conda%20downloads)](https://anaconda.org/conda-forge/pudu)
[![image](https://img.shields.io/badge/stackoverflow-Ask%20a%20question-brown?logo=stackoverflow&logoWidth=18&logoColor=white)](https://stackoverflow.com/questions/tagged/pudu)
[![status](https://joss.theoj.org/papers/cacb5b6520209b0c940bf46638df251d/status.svg)](https://joss.theoj.org/papers/cacb5b6520209b0c940bf46638df251d)

**A Python library for explainability of machine learning algorithms for spectroscopic data in an agnostic, deterministic, and simple way.**

* GitHub repo: https://github.com/pudu-py/pudu
* Documentation: https://pudu-py.github.io/pudu
* PyPI: https://pypi.python.org/pypi/pudu
* Conda-forge: https://anaconda.org/conda-forge/pudu
* Free software: MIT license

# Introduction

**pudu** is a Python package that helps interpret and explore the results of machine learning algorithms with spectroscopic data. It does this by quantifying the change in the prediction according to the change in the features. This library works with classification and regression problems with both 1-d and 2-d problems. 
actiIn order to see the exact procedure and format needed, please refer to the examples in the ``docs``.

# Features

The following is a list of the main features that **pudu** package enables.

- Importance: measures the change in prediction according to perturbations in the features.
- Speed: calculates how fast a prediction changes according to different perturbation levels.
- Synergy: tests the synergy between features and the change in classification probability.
- Re-activations: Evaluates how activations maps from CNN’s change according to perturbations in the data.
- Easy plotting with ample personalization options for all the cases above.


# Quickstart

1. Install this library using ``pip``::

        pip install pudu

2. Install this library using ``conda-forge``::

        conda install -c conda-forge pudu

3. Test it by running one of the examples in the ``docs``.

4. If you find this library useful, please consider a reference or citation as::

        @misc{Grau-Luque2023Pudu,
        author = {E. Grau-Luque, I. Becerril-Romero, A. Perez-Rodriguez, M. Guc, V. Izquierdo-Roca},
        title = {pudu},
        year = {2023},
        publisher = {GitHub},
        journal = {GitHub repository},
        howpublished = {\url{https://github.com/pudu-py/pudu}},
        }

5. Stay up-to-date by updating the library using::

       conda update pudu
       pip install --update pudu

6. If you encounter problems when updating, try uninstalling and then re-installing::

        pip uninstall pudu
        conda remove pudu


# Credits

This package was created with [Cookiecutter](https://github.com/cookiecutter/cookiecutter) and the
[giswqs/pypackage](https://github.com/giswqs/pypackage) project template.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/pudu-py/pudu",
    "name": "pudu",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": null,
    "keywords": "pudu",
    "author": "pudu",
    "author_email": "puduhola@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/ee/0a/3eaf9b31891b7599b90f8b00369746b357373cc68d92af3a221e843c776e/pudu-0.3.4.tar.gz",
    "platform": null,
    "description": "<img src=\"https://raw.githubusercontent.com/pudu-py/pudu/main/docs/_static/pudu-baner.png\" width=\"70%\">\n\n[![image](https://img.shields.io/pypi/v/pudu.svg)](https://pypi.python.org/pypi/pudu)\n[![Anaconda-Server Badge](https://anaconda.org/conda-forge/pudu/badges/version.svg)](https://anaconda.org/conda-forge/pudu)\n[![image](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![CodeQL](https://github.com/pudu-py/pudu/actions/workflows/codeql.yml/badge.svg)](https://github.com/pudu-py/pudu/actions/workflows/codeql.yml)\n[![image](https://github.com/pudu-py/pudu/workflows/docs/badge.svg)](https://pudu-py.github.io/pudu)\n[![codecov](https://codecov.io/gh/pudu-py/pudu/branch/main/graph/badge.svg?token=DC0QIwuYel)](https://codecov.io/gh/pudu-py/pudu)\n[![Downloads](https://static.pepy.tech/personalized-badge/pudu?period=total&units=abbreviation&left_color=grey&right_color=blue&left_text=pypi%20downloads)](https://pepy.tech/project/pudu)\n[![image](https://img.shields.io/conda/dn/conda-forge/pudu?color=blue&label=conda%20downloads)](https://anaconda.org/conda-forge/pudu)\n[![image](https://img.shields.io/badge/stackoverflow-Ask%20a%20question-brown?logo=stackoverflow&logoWidth=18&logoColor=white)](https://stackoverflow.com/questions/tagged/pudu)\n[![status](https://joss.theoj.org/papers/cacb5b6520209b0c940bf46638df251d/status.svg)](https://joss.theoj.org/papers/cacb5b6520209b0c940bf46638df251d)\n\n**A Python library for explainability of machine learning algorithms for spectroscopic data in an agnostic, deterministic, and simple way.**\n\n* GitHub repo: https://github.com/pudu-py/pudu\n* Documentation: https://pudu-py.github.io/pudu\n* PyPI: https://pypi.python.org/pypi/pudu\n* Conda-forge: https://anaconda.org/conda-forge/pudu\n* Free software: MIT license\n\n# Introduction\n\n**pudu** is a Python package that helps interpret and explore the results of machine learning algorithms with spectroscopic data. It does this by quantifying the change in the prediction according to the change in the features. This library works with classification and regression problems with both 1-d and 2-d problems. \nactiIn order to see the exact procedure and format needed, please refer to the examples in the ``docs``.\n\n# Features\n\nThe following is a list of the main features that **pudu** package enables.\n\n- Importance: measures the change in prediction according to perturbations in the features.\n- Speed: calculates how fast a prediction changes according to different perturbation levels.\n- Synergy: tests the synergy between features and the change in classification probability.\n- Re-activations: Evaluates how activations maps from CNN\u2019s change according to perturbations in the data.\n- Easy plotting with ample personalization options for all the cases above.\n\n\n# Quickstart\n\n1. Install this library using ``pip``::\n\n        pip install pudu\n\n2. Install this library using ``conda-forge``::\n\n        conda install -c conda-forge pudu\n\n3. Test it by running one of the examples in the ``docs``.\n\n4. If you find this library useful, please consider a reference or citation as::\n\n        @misc{Grau-Luque2023Pudu,\n        author = {E. Grau-Luque, I. Becerril-Romero, A. Perez-Rodriguez, M. Guc, V. Izquierdo-Roca},\n        title = {pudu},\n        year = {2023},\n        publisher = {GitHub},\n        journal = {GitHub repository},\n        howpublished = {\\url{https://github.com/pudu-py/pudu}},\n        }\n\n5. Stay up-to-date by updating the library using::\n\n       conda update pudu\n       pip install --update pudu\n\n6. If you encounter problems when updating, try uninstalling and then re-installing::\n\n        pip uninstall pudu\n        conda remove pudu\n\n\n# Credits\n\nThis package was created with [Cookiecutter](https://github.com/cookiecutter/cookiecutter) and the\n[giswqs/pypackage](https://github.com/giswqs/pypackage) project template.\n",
    "bugtrack_url": null,
    "license": "MIT license",
    "summary": "A Python library for explainability of machine learinng algorithms in an agnostic, deterministic, and simple way.",
    "version": "0.3.4",
    "project_urls": {
        "Homepage": "https://github.com/pudu-py/pudu"
    },
    "split_keywords": [
        "pudu"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "0db6bbeed8d36a0445e8bdbc648283f87ec13555c5bd4fb6457d51cfe3922c53",
                "md5": "b4bb5ea10827edc6d4b9e9ee4dae36ab",
                "sha256": "858832dd4ffd5e3ced7df87340ea4f28861a8476f68a3954a239a30247bd586b"
            },
            "downloads": -1,
            "filename": "pudu-0.3.4-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "b4bb5ea10827edc6d4b9e9ee4dae36ab",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": ">=3.7",
            "size": 18102,
            "upload_time": "2024-04-23T13:03:43",
            "upload_time_iso_8601": "2024-04-23T13:03:43.921667Z",
            "url": "https://files.pythonhosted.org/packages/0d/b6/bbeed8d36a0445e8bdbc648283f87ec13555c5bd4fb6457d51cfe3922c53/pudu-0.3.4-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "ee0a3eaf9b31891b7599b90f8b00369746b357373cc68d92af3a221e843c776e",
                "md5": "8e61b24038cd60e8dcc5255078ca59b6",
                "sha256": "7eb0c21a966b0e960e6bc277783c03439a5065280095409b2ad52be695c9811b"
            },
            "downloads": -1,
            "filename": "pudu-0.3.4.tar.gz",
            "has_sig": false,
            "md5_digest": "8e61b24038cd60e8dcc5255078ca59b6",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 20687,
            "upload_time": "2024-04-23T13:03:45",
            "upload_time_iso_8601": "2024-04-23T13:03:45.592767Z",
            "url": "https://files.pythonhosted.org/packages/ee/0a/3eaf9b31891b7599b90f8b00369746b357373cc68d92af3a221e843c776e/pudu-0.3.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-04-23 13:03:45",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "pudu-py",
    "github_project": "pudu",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [
        {
            "name": "numpy",
            "specs": []
        },
        {
            "name": "pandas",
            "specs": []
        },
        {
            "name": "matplotlib",
            "specs": []
        },
        {
            "name": "spectrapepper",
            "specs": []
        },
        {
            "name": "scikit-learn",
            "specs": []
        },
        {
            "name": "tensorflow",
            "specs": [
                [
                    "==",
                    "2.11"
                ]
            ]
        }
    ],
    "lcname": "pudu"
}
        
Elapsed time: 0.22323s