Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Adding Global Actions in A Nutshell For Counterfactual Explainability (GLANCE) framework #196

Open
wants to merge 26 commits into
base: master
Choose a base branch
from

Conversation

ntheol
Copy link

@ntheol ntheol commented Oct 17, 2024

This PR is to add GLANCE, Global Actions in A Nutshell For Counterfactual Explainability framework.

GLANCE is a versatile and adaptive framework for generating global counterfactual explanations. These explanations are expressed as actions that offer recourse to large population subgroups. The framework aims to provide explanations and insights, ensuring that the actions benefit as many individuals as possible.

GLANCE comprises of two algorithms:

  • C-GLANCE: employs a clustering-based approach for generating global counterfactual explanations that allows the user to specify the number of global actions generated and serves as a tool to explain and debug ML models.

  • T-GLANCE: generates global counterfactual explanations using a decision tree-like structure. T-GLANCE's key strength is that allows policy-makers or auditors to select the features that determine the partitioning of the tree. By allowing
    users to guide the feature selection, T-GLANCE can adapt to specific policy needs or audit requirements.

  • algorithm folders are here

  • example notebook can be found here

  • algorithm's dependencies are here

Closes #195 issue.

ntheol added 19 commits October 10, 2024 17:21
Signed-off-by: Nikolas Theologitis <[email protected]>
Signed-off-by: Nikolas Theologitis <[email protected]>
Signed-off-by: Nikolas Theologitis <[email protected]>
-Changed Counterfactual Treeto T_GLANCE

-Fixed class imports

Signed-off-by: Nikolas Theologitis <[email protected]>
Signed-off-by: Nikolas Theologitis <[email protected]>
Signed-off-by: Nikolas Theologitis <[email protected]>
Signed-off-by: Nikolas Theologitis <[email protected]>
Signed-off-by: Nikolas Theologitis <[email protected]>
Signed-off-by: Nikolas Theologitis <[email protected]>
Signed-off-by: Nikolas Theologitis <[email protected]>
Signed-off-by: Nikolas Theologitis <[email protected]>
Signed-off-by: Nikolas Theologitis <[email protected]>
Signed-off-by: Nikolas Theologitis <[email protected]>
@ntheol
Copy link
Author

ntheol commented Dec 3, 2024

Hello @vijay-arya!

I would just like to remind you, when you get a chance, to take a look at the pull request and inform us of any corrections or improvements that may be needed; or merge the pull request if you believe it is adequate.
In any case, we are looking forward to your feedback!

Best regards,
Nikolas

@ntheol
Copy link
Author

ntheol commented Dec 17, 2024

Hi @vijay-arya , just following up on this. Let me know if any changes are needed or if it’s good to merge. Looking forward to your feedback!

@vijay-arya
Copy link
Collaborator

Hi @vijay-arya , just following up on this. Let me know if any changes are needed or if it’s good to merge. Looking forward to your feedback!

@ntheol can you pls use the current build.yml, append your tests to it, and then run it from within your branch here: https://github.com/AutoFairAthenaRC/AIX360/actions

Signed-off-by: Nikolas Theologitis <[email protected]>
Signed-off-by: Nikolas Theologitis <[email protected]>
ntheol added 2 commits January 9, 2025 11:36
Signed-off-by: Nikolas Theologitis <[email protected]>
Signed-off-by: Nikolas Theologitis <[email protected]>
ntheol added 2 commits January 9, 2025 11:42
Signed-off-by: Nikolas Theologitis <[email protected]>
Signed-off-by: Nikolas Theologitis <[email protected]>
@ntheol
Copy link
Author

ntheol commented Jan 9, 2025

Hi @vijay-arya , just following up on this. Let me know if any changes are needed or if it’s good to merge. Looking forward to your feedback!

@ntheol can you pls use the current build.yml, append your tests to it, and then run it from within your branch here: https://github.com/AutoFairAthenaRC/AIX360/actions

Hello @vijay-arya , I followed your instructions and appended my tests to the build.yml file and I run the tests using the GitHub Actions.
Let me know if everything is alright!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Placeholder Issue: Upcoming Pull Request for the GLANCE Framework
2 participants