From ab54d9e9a4219e6bc84f913b859560e3f8ed0722 Mon Sep 17 00:00:00 2001 From: rzfzr Date: Fri, 15 May 2026 10:04:11 +0000 Subject: [PATCH 1/3] Add PyPI badge to README --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 273fc79..30a2149 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,7 @@ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![Python Versions](https://img.shields.io/badge/python-3.10%20|%203.11%20|%203.12-blue.svg)](pyproject.toml) +[![PyPI](https://img.shields.io/pypi/v/dpg.svg)](https://pypi.org/project/dpg/) [![Build Status](https://github.com/Meta-Group/DPG/actions/workflows/ci.yml/badge.svg)](https://github.com/Meta-Group/DPG/actions/workflows/ci.yml) [![Documentation Status](https://readthedocs.org/projects/dpg/badge/?version=latest)](https://dpg.readthedocs.io/en/latest/) From 3de56c2d350e8da4f4ae9e514e29beade25cc3a2 Mon Sep 17 00:00:00 2001 From: rzfzr Date: Fri, 15 May 2026 10:12:58 +0000 Subject: [PATCH 2/3] Replace HTML with Markdown images --- README.md | 24 ++++++------------------ 1 file changed, 6 insertions(+), 18 deletions(-) diff --git a/README.md b/README.md index 30a2149..706046a 100644 --- a/README.md +++ b/README.md @@ -6,9 +6,7 @@ [![Build Status](https://github.com/Meta-Group/DPG/actions/workflows/ci.yml/badge.svg)](https://github.com/Meta-Group/DPG/actions/workflows/ci.yml) [![Documentation Status](https://readthedocs.org/projects/dpg/badge/?version=latest)](https://dpg.readthedocs.io/en/latest/) -

- -

+![DPG logo](https://github.com/Meta-Group/DPG/blob/main/DPG.png) DPG is a model-agnostic framework for global and local explanation of tree-based ensemble models. @@ -21,9 +19,7 @@ insightful points. DPG enables graph-based evaluations and the identification of towards facilitating comparisons between features and their associated values while offering insights into the entire model. DPG provides descriptive metrics that enhance the understanding of the decisions inherent in the model, offering valuable insights. -

- -

+![DPG overview](https://github.com/Meta-Group/DPG/blob/main/image.png) --- @@ -49,9 +45,7 @@ The concept behind DPG is to convert a generic tree-based ensemble model for cla - Nodes represent predicates, i.e., the feature-value associations present in each node of every tree; - Edges denote the frequency with which these predicates are satisfied during the model training phase by the samples of the dataset. -

- -

+![DPG example](https://github.com/Meta-Group/DPG/blob/main/dpg_image_examples/example.png?raw=true) ## Metrics The graph-based nature of DPG provides significant enhancements in the direction of a complete mapping of the ensemble structure. @@ -319,20 +313,14 @@ Some examples can be appreciated in the `examples` folder: https://github.com/Me In particular, the following DPG is obtained by transforming a Random Forest with 5 base learners, trained on Iris dataset. The used command is `python run_dpg_standard.py --dataset iris --n_learners 5 --pv 0.001 --t 2 --dir examples --plot --save_plot_dir examples`. -

- -

+![Iris DPG](https://github.com/Meta-Group/DPG/blob/main/dpg_image_examples/iris_bl5_perc0.001_dec2.png) The following visualizations are obtained using the same parameters as the previous example, but they show two different metrics: _Community_ and _Betweenness centrality_. The used command for showing communities is `python run_dpg_standard.py --dataset iris --n_learners 5 --pv 0.001 --t 2 --dir examples --plot --save_plot_dir examples --communities`. -

- -

+![Iris communities](https://github.com/Meta-Group/DPG/blob/main/dpg_image_examples/iris_bl5_perc0.001_dec2_communities.png) The used command for showing a specific property is `python run_dpg_standard.py --dataset iris --n_learners 5 --pv 0.001 --t 2 --dir examples --plot --save_plot_dir examples --attribute "Betweenness centrality" --class_flag`. -

- -

+![Iris betweenness centrality](https://github.com/Meta-Group/DPG/blob/main/dpg_image_examples/iris_bl5_perc0.001_dec2_Betweennesscentrality.png) *** ## Citation From 6686b1b3211819c375afe63b19b8e1d07d667578 Mon Sep 17 00:00:00 2001 From: rzfzr Date: Fri, 15 May 2026 10:15:34 +0000 Subject: [PATCH 3/3] Fix logo alignment in README --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 706046a..8239898 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,8 @@ [![Build Status](https://github.com/Meta-Group/DPG/actions/workflows/ci.yml/badge.svg)](https://github.com/Meta-Group/DPG/actions/workflows/ci.yml) [![Documentation Status](https://readthedocs.org/projects/dpg/badge/?version=latest)](https://dpg.readthedocs.io/en/latest/) -![DPG logo](https://github.com/Meta-Group/DPG/blob/main/DPG.png) +| ![DPG logo](https://github.com/Meta-Group/DPG/blob/main/DPG.png) | +|:--:| DPG is a model-agnostic framework for global and local explanation of tree-based ensemble models.