Version 1.0.0

(Released: 2025-04-10)

Initial Release New

This is the first public release of the k-diagram package.

Key Features Included

• Feature Uncertainty Visualization Suite (kdiagram.plot.uncertainty):

  • plot_actual_vs_predicted(): Compare actual vs. point predictions.

  • plot_anomaly_magnitude(): Visualize magnitude and type of prediction interval failures.

  • plot_coverage(): Calculate and plot overall coverage scores (bar, line, pie, radar).

  • plot_coverage_diagnostic(): Diagnose point-wise interval coverage on a polar plot.

  • plot_interval_consistency(): Assess stability of interval width over time (Std Dev / CV).

  • plot_interval_width(): Visualize prediction interval width magnitude across samples.

  • plot_model_drift(): Track average interval width drift across forecast horizons (polar bars).

  • plot_temporal_uncertainty(): General polar scatter for comparing multiple series (e.g., quantiles).

  • plot_uncertainty_drift(): Visualize drift of uncertainty patterns using concentric rings.

  • plot_velocity(): Visualize rate of change (velocity) of median predictions.

• Feature Model Evaluation (kdiagram.plot.evaluation):

  • Taylor Diagram utilities (taylor_diagram(), plot_taylor_diagram_in(), plot_taylor_diagram()) for summarizing model skill (correlation, standard deviation, RMSD).

• Feature Feature Importance (kdiagram.plot.feature_based):

  • plot_feature_fingerprint(): Radar charts for comparing feature importance profiles.

• Feature Relationship Visualization (kdiagram.plot.relationship):

  • plot_relationship(): Polar scatter mapping true values to angle and predictions to radius.

• Feature Utility Functions (kdiagram.utils):

  • Helpers for detecting, building names for, and reshaping quantile data in DataFrames (detect_quantiles_in(), build_q_column_names(), reshape_quantile_data(), melt_q_data(), pivot_q_data()).

• Build Command-Line Interface (CLI):

  • k-diagram command for generating core plots directly from CSV files via the terminal.

• Docs Documentation:

  • Initial version including Installation Guide, Quick Start, User Guide (concepts & interpretation), Plot Gallery, Utility Examples, API Reference, Contribution Guidelines, and License.