Metadata-Version: 2.1
Name: ShapEV
Version: 0.0.1
Summary: A package for identifying Equivalent Value based on joint SHAP values
Home-page: https://github.com/Bin-Cao/ShapEV
Author: Cao Bin
Author-email: bcao@shu.edu.com
Maintainer: Cao Bin
Maintainer-email: binjacobcao@gmail.com
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.5
Description-Content-Type: text/markdown
Requires-Dist: scikit-learn


 
## ShapEV
A package for identifying **Equivalent Value** based on joint SHAP values.

ShapEV is an python package that identifies **Equivalent Value** among features based on cooperative game theory. By leveraging SHAP values, ShapEV decomposes feature contributions and their interactions, defining joint SHAP values to capture combined feature effects. For more details, refer to the original publication: [Joint Model Interpretation (JMI)](https://www.oaepublish.com/articles/jmi.2022.04).

An **Equivalent Value** is proposed based on the joint SHAP value, reflecting each feature's overall contribution to the regression target. ShapEV applies this equivalent value to represent the collective behavior of interacting features, allowing users to substitute original individual features with a unified **Equivalent Value**.

On the modified dataset, ShapEV calculates the contribution of the proposed **Equivalent Value** by comparing it to SHAP contributions. This validation confirms that, within the SHAP framework, the equivalent value linearly correlates with the target when showing high correlation.


## About
Maintained by Bin Cao. Please feel free to open issues in the Github or contact Bin Cao
(bcao686@connect.hkust-gz.edu.c) in case of any problems/comments/suggestions in using the code. 

