GBDTAnalyzer

class pyruleanalyzer.GBDTAnalyzer(classifier: RuleClassifier)

Gradient-Boosting-specific rule analysis and comparison.

This class extracts the GBDT analysis pipeline out of RuleClassifier and adds redundancy breakdown tracking so the output shows:

  • intra_tree – boundary-redundant sibling pairs merged (within each tree)

  • low_impact – rules with negligible contribution removed

  • low_usage – rules removed because of low classification count

classifier

The underlying RuleClassifier instance.

redundancy_counts

Dict mapping redundancy type to count.

compare_initial_final_results(file_path: str = None, X=None, y=None) → None

Compares performance of initial vs final rules for GBDT.

Evaluates both rule sets on the test data, displays metrics, logs divergent cases, and writes a detailed report.

Parameters:

  • file_path – Path to the CSV test file.

  • X – Dataframe or array for test data.

  • y – True labels.

execute_rule_refinement(file_path: str = None, X=None, y=None, remove_below_n_classifications: int = -1, refine_between_trees: bool = False, save_final_model: bool = True, save_report: bool = True) → None

Evaluates GBDT rules on a dataset, detects redundancies, and refines.

This method: 1. Classifies every sample to gather per-rule usage stats. 2. Optionally removes low-usage rules (with sibling promotion). 3. Tracks redundancy counts by type. 4. Writes a report and saves the final model.

Parameters:

  • file_path – Path to the CSV test file.

  • X – Dataframe or array for test data.

  • y – True labels.

  • remove_below_n_classifications – Threshold for low-usage refinement (-1 disables).

  • save_final_model – Whether to save the final model to ‘final_model.pkl’. Default is True.

  • save_report – Whether to save the analysis report to ‘output_classifier_gbdt.txt’. Default is True.

print_redundancy_summary() → None

Prints the redundancy breakdown and rule reduction summary.

track_from_adjust_and_remove(method: str, intra_tree_pairs: list) → None

Updates redundancy counters after an adjust_and_remove cycle.

Called by RuleClassifier.execute_rule_refinement() after the duplicate-removal loop finishes for GBDT.

Parameters:

  • method – The removal method used (‘soft’, ‘hard’).

  • intra_tree_pairs – Pairs found by find_duplicated_rules.