Metadata-Version: 2.1
Name: decima2
Version: 0.2.0
Summary: Evaluation Toolkit for Machine Learning Models
Home-page: https://github.com/Decima2/Decima2Toolkit
Author: Torty Sivill
Author-email: torty.sivill@decima2.co.uk
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6, <=3.12.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: dash<=2.18.1,>=2.14.0
Requires-Dist: numpy<=2.1.1
Requires-Dist: pandas<=2.2.3,>=1.3.0
Requires-Dist: plotly<=5.24.1,>=5.10.0
Requires-Dist: Requests<=2.32.3,>=2.20.0
Requires-Dist: scikit_learn<=1.5.2,>=1.0
Requires-Dist: setuptools>=58.0.4
Requires-Dist: shap<=0.46.0,>=0.4.0
Requires-Dist: torch<=2.4.0,>=1.13.0
Requires-Dist: keras<=3.0,>=2.4.0
Requires-Dist: tensorflow<=2.17.0,>2.10.0
Requires-Dist: pytest<=8.3.3,>=7.4.3


# Decima2 AI Evaluation Toolkit

## Introduction
Welcome to the Decima2 AI Evaluation Toolkit — a comprehensive suite of tools designed to empower developers with the insights needed to effectively evaluate and enhance machine learning models. Our toolkit focuses on making complex concepts in machine learning intuitive and accessible, allowing users to derive meaningful insights without the steep learning curve often associated with advanced analytics.



## Table of Contents
1. [Installation](#installation)
2. [Model Tools](#model-tools)
   - [Model Feature Importance](#model-feature-importance)
   - [Grouped Feature Importance](#grouped-feature-importance)
3. [Data Tools](#data-tools)
4. [Outcome Tools](#outcome-tools)
5. [License](#license)
6. [Contributing](#contributing)
7. [Contact](#contact)


## Installation

You can install the package using pip:

<pre>
pip install decima2
</pre>


## Model Tools

Gain insights into how your models make predictions with clear, interpretable visualizations and explanations, making it easier to communicate results. 


### Model Feature Importance
For Tabular Data 

This tool allows users to examine which features were most important for their model's perfomance. Given a numerical dataset and pre-trained model, the model_feature_importance module returns either a textual or graphical representation of which features were most important. 

#### Instructions
For detailed usage instructions and to explore how the module works check out our [Developer Docs](https://docs.decima2.co.uk/docs/explanation/model-feature-importance) 
#### Tutorial 
To explore tutorials on model feature importance including motivations and comparisons with SHAP check out our [Jupyter Notebooks](https://github.com/Decima2/Decima2Toolkit/tree/main/examples/model_insights/model_explanations)  



### Grouped Feature Importance
For Tabular Data 


<pre>
from decima2 import grouped_feature_importance
</pre>

This tool builds on model_feature_importance to give users an insight into which features were most influential for their model over a **select group of data**. For example, a user may want to compare the most important feature across men and women in their data, or people with an income over 65k and under 65k. 

#### Instructions
For detailed usage instructions and to explore how the module works check out our [Developer Docs](https://docs.decima2.co.uk/docs/explanation/grouped-feature-importance) 
#### Tutorial 
To explore tutorials on grouped feature importance including motivation and use-cases check out our [Jupyter Notebooks](https://github.com/Decima2/Decima2Toolkit/tree/main/examples/model_insights/model_explanations)  


## Data Tools
### Coming Soon
These tools help you evaluate your data 

## Outcome Tools
### Coming Soon 
These tools help you to evaluate the outcomes of your model


## License
This project is licensed under the MIT License. See the LICENSE file for details.

## Contributing
Contributions are welcome! Please create a pull request or open an issue for any improvements, bugs, or feature requests.

## Contact
For inquiries, please reach out to torty.sivill@decima2.co.uk
