๐ New Features
Interval Scorecards
This release introduces interval scorecard functionality that transforms complex XGBoost tree rules into simplified, industry-standard intervals.
New Methods:
construct_scorecard_by_intervals(add_stats=True)- Converts tree rules into intervals like[70.8, 80.5)create_points_peo_pdo(peo, pdo, precision_points=0)- Adds Points at Even Odds/Points to Double the Odds
Key Benefits:
- 60-80% Rule Reduction: Simplifies complex scorecards while maintaining accuracy
- Industry Standard: Follows credit scoring best practices (Siddiqi, 2017)
- Easy Integration: Works with existing XGBoost workflows (requires
max_depth=1) - Comprehensive Testing: 10 new tests ensure reliability
Usage Example:
from xbooster.xgb_constructor import XGBScorecardConstructor
# Build standard scorecard
constructor = XGBScorecardConstructor(model, X_train, y_train)
standard_scorecard = constructor.construct_scorecard()
scorecard_with_points = constructor.create_points()
# NEW: Build interval scorecard
interval_scorecard = constructor.construct_scorecard_by_intervals(add_stats=True)
# NEW: Add PEO/PDO points
peo_pdo_scorecard = constructor.create_points_peo_pdo(peo=600, pdo=50)๐ What's Included:
- โ New Methods: Interval scorecard construction and PEO/PDO points
- โ
Example Notebook:
examples/xbooster-scorecard-by-interval.ipynb - โ Comprehensive Tests: Full test suite for new functionality
- โ Updated Documentation: README with usage examples and API reference
- โ
PyPI Release: Available via
pip install xbooster==0.2.6
๐งช Testing:
- All 71 tests pass
- Backward compatibility maintained
- No breaking changes
๐ Installation:
pip install --upgrade xboosterCloses #4
Full Changelog: v0.2.5...v0.2.6