Release Notes: APLR Version 10.13.0
This release introduces a major new feature for model interpretation through visualization, along with several documentation improvements and a key enhancement for the classification module.
New Features
-
Visualizing Model Components: A new method,
plot_affiliation_shape, has been added to theAPLRRegressorclass. This allows for easy one-line plotting of main effects (as line plots) and two-way interactions (as heatmaps) directly from a fitted model object. This greatly simplifies model interpretation and debugging. -
Optional Plotting Dependencies: To support the new plotting feature,
pandasandmatplotlibcan now be installed as optional dependencies usingpip install aplr[plots]. The core library remains lightweight for users who do not require plotting.
Improvements
-
Classification Model Interpretation: The
get_logit_modelmethod has been improved to return a full-featured PythonAPLRRegressorobject. This enables the use of Python-specific methods, making it straightforward to visualize model components for each category by calling the newplot_affiliation_shapemethod on the returned logit model. -
Example Scripts: All example scripts have been updated to use the new
plot_affiliation_shapemethod, making them cleaner and demonstrating the current best practices for model interpretation.
Documentation
- The API Reference for
APLRRegressorhas been updated with detailed documentation for the newplot_affiliation_shapemethod. - The main README.md now includes instructions for installing the optional plotting dependencies.
- The Model Interpretation guides for both regression and classification have been significantly improved to reflect the new, simplified plotting workflow and to provide clearer instructions.