eazyml-counterfactual 0.0.56

eazyml-counterfactual from EazyML family for counterfactual explanations, prescriptive analytics, and actionable insights to optimize predictive outcomes.

EazyML Responsible-AI: Counterfactual

eazyml-counterfactual is a python package that helps users optimize predictive outcomes by generating counterfactual explanations. EazyML revolutionizes machine learning by introducing counterfactual inference, automating the process of identifying optimal changes to variables that shift outcomes from unfavorable to favorable. This approach overcomes the limitations of manual "what-if" analysis, enabling models to provide actionable, prescriptive insights alongside their predictions.

Designed for post-prediction analysis, this package answers questions like:

• "What minimal changes to input features can reverse an unfavorable prediction?"
• "How can I achieve a desired outcome by tweaking feature values?"

Features

• Prescriptive Insights: Automatically recommend actionable steps to achieve desired outcomes by identifying optimal feature modifications.
• Outcome Optimization: Calculates the likelihood of favorable outcomes and determines optimal adjustments to improve predictions while respecting user-defined constraints.
• Flexible Feature Selection: Allows users to manually specify relevant features from the training dataset for counterfactual inference.
• Custom Model Integration: Accepts pre-trained machine learning models and user-defined preprocessing steps for seamless inference.
• Classification and Regression Support: Handles both classification and regression problems.

eazyml-counterfactual is ideal for scenarios like loan approvals, customer churn prevention, and healthcare treatment planning.`

Installation

User installation

The easiest way to install counterfactual package is using pip:

pip install -U eazyml-counterfactual

Dependencies

EazyML Counterfactual requires :

• pandas
• eazyml-automl
• openpyxl
• scikit-learn
• scipy

Usage

Counterfactual inference can be applied by initializing the EazyML framework and obtaining actionable insights for new test data.

from eazyml_counterfactual import ez_init, ez_cf_inference

# Initialization: Sets up book-keeping and API access if required
_ = ez_init()

selected_features = ['feature1', 'feature2', 'feature3']
model_info = b"acacxaca"

variants = ['feature1', 'feature2']

# Configurable parameters for counterfactual inference
options = {
    "variants": variants,
    "outcome_ordinality": "1", 
    "train_data": train_file,   
}

# Selecting test record for inference
test_index_no = 0
# `pred_df` contains the test dataset with predicted probabilities
test_data = pred_df.loc[[test_index_no]]

result, optimal_transition_df = ez_cf_inference(
    test_data=test_data,
    outcome='outcome_column_name',
    selected_features=selected_features,
    model_info=model_info,  
    options=options
)

You can find more information in the documentation.

Useful links, other packages from EazyML family

• Documentation

• Homepage

• If you have questions or would like to discuss a use case, please contact us here

• Here are the other packages from EazyML suite:

  • eazyml-automl: eazyml-automl provides a suite of APIs for training, optimizing and validating machine learning models with built-in AutoML capabilities, hyperparameter tuning, and cross-validation.
  • eazyml-data-quality: eazyml-data-quality provides APIs for comprehensive data quality assessment, including bias detection, outlier identification, and drift analysis for both data and models.
  • eazyml-counterfactual: eazyml-counterfactual provides APIs for optimal prescriptive analytics, counterfactual explanations, and actionable insights to optimize predictive outcomes to align with your objectives.
  • eazyml-insight: eazyml-insight provides APIs to discover patterns, generate insights, and mine rules from your datasets.
  • eazyml-xai: eazyml-xai provides APIs for explainable AI (XAI), offering human-readable explanations, feature importance, and predictive reasoning.
  • eazyml-xai-image: eazyml-xai-image provides APIs for image explainable AI (XAI).

License

This project is licensed under the Proprietary License.

---

Maintained by EazyML
© 2025 EazyML. All rights reserved.