Package: modelskill 0.1.1

modelskill: Assessing and Visualising the Performance of Prediction Models

Provides tools for evaluating continuous predictions and their associated predictive uncertainty from statistical, machine-learning, geostatistical, and process-based models. It implements complementary measures of prediction error, association, agreement, efficiency, uncertainty calibration, and predictive-distribution performance, together with Taylor, solar, target, coverage, probability integral transform, and quantile-coverage diagnostics. Methods include the integrated evaluation approach of Wadoux, Walvoort and Brus (2022) <doi:10.1016/j.geoderma.2021.115332> and the uncertainty-validation framework of Schmidinger and Heuvelink (2023) <doi:10.1016/j.geoderma.2023.116585>.

Authors:Alexandre M.J.-C. Wadoux [aut, cre, cph]

modelskill_0.1.1.tar.gz
modelskill_0.1.1.zip(r-4.7-any)modelskill_0.1.1.zip(r-4.6-any)modelskill_0.1.1.zip(r-4.5-any)
modelskill_0.1.1.tgz(r-4.6-any)modelskill_0.1.1.tgz(r-4.5-any)
modelskill_0.1.1.tar.gz(r-4.7-any)modelskill_0.1.1.tar.gz(r-4.6-any)
modelskill_0.1.1.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
modelskill/json (API)

# Install 'modelskill' in R:
install.packages('modelskill', repos = c('https://alexandrewadoux.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/alexandrewadoux/modelskill/issues

Pkgdown/docs site:https://alexandrewadoux.github.io

On CRAN:

Conda:

biometricseconometricshydrological-modellingmodel-evaluationmodel-validationmodellingpedometricsvalidationvalidation-metricsvalidation-statistics

5.86 score 12 stars 36 downloads 49 exports 21 dependencies

Last updated from:6bcd03833b. Checks:9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-develOK223
source / vignettesOK299
linux-releaseOK156
macos-releaseOK112
macos-oldrelOK129
windows-develOK112
windows-releaseOK97
windows-oldrelOK115
wasm-releaseOK140

Exports:accuracy_plot_metricsbiasccccorrelationcoveragecoverage_errorcrmsecrpscrps_decompositiondiagram_statsgg_coveragegg_pitgg_qcpgg_solargg_targetgg_taylorinterval_scoreinterval_widthkgelog_scoremaemapemdaemecmedian_crpsmodel_metricsmpemsemslenrmsensepicppinball_losspitqcpr2R2raererrmsermslerpdrpiqrrmsesd_ratiosepsmapeuncertainty_metricswillmott_d

Dependencies:clicpp11farverggplot2ggrepelgluegridExtragtableisobandlabelinglifecycleR6RColorBrewerRcpprlangS7scalesvctrsviridisviridisLitewithr

Prediction performance metrics
1. Why use several prediction metrics? | 2. Example data | 3. Start by looking at the predictions | 4. Calculate individual metrics | 4.1 RMSE: overall error magnitude | [\mathrm | 4.2 Bias: systematic overprediction or underprediction | [\mathrm | 5. A particularly important distinction: r2() versus R2() | 5.1 Lowercase r2() | [r^2 | 5.2 Uppercase R2() | [R^2 | 5.3 Correlation is not agreement | 6. Compare several models at once | 7. Categories of prediction performance metrics | 8. Core metrics | 9. Extended metrics | 9.1 Extended metric reference | 10. Quantile predictions | 11. How should metrics be combined? | 12. Related and redundant metrics | [\mathrm | 13. Missing values and special cases | 14. Practical recommendations | 15. References | 16. Next steps

Last update: 2026-09-09
Started: 2026-09-08

Predictive-uncertainty evaluation
1. Why validate predictive uncertainty? | 2. Which form of predictive uncertainty do you have? | 3. Functions used in this tutorial | 4. Example data | 5. Case A: predictive mean and standard deviation | 5.1 Prediction intervals | 5.1.1 Prediction interval coverage probability | 5.1.2 Coverage error | 5.1.3 Prediction interval width | 5.1.4 Interval score | 5.1.5 Calculate all interval diagnostics together | 5.2 Why calibration and sharpness must be considered together | 5.3 Reliability across multiple interval levels | 5.3.1 Numerical summaries of the reliability plot | 5.4 Why PICP alone is not enough | 5.5 Quantile coverage probability | 5.6 Probability integral transform | 5.7 Proper scoring rules | 5.7.1 Continuous ranked probability score | 5.7.2 Median CRPS | 5.7.3 Logarithmic score | 6. Case B: predictive distributions represented by samples | 6.1 Prediction intervals from predictive samples | 6.2 Reliability across interval levels from predictive samples | 6.3 Quantile calibration from predictive samples | 6.4 PIT from predictive samples | 6.5 CRPS from predictive samples | 6.6 CRPS reliability decomposition | 6.7 What about the logarithmic score with predictive samples? | 7. Comparing the two input formats | 8. A practical workflow | 8.1 If you only have prediction intervals | 8.2 If you have predicted quantiles | 8.3 If you have a predictive mean and standard deviation | 8.4 If you have predictive samples | 9. Recommended interpretation

Last update: 2026-09-08
Started: 2026-09-07

Summary diagrams and diagnostic plots
1. Why use summary diagrams? | 2. Example data | 3. Solar diagram | [\mathrm | [\mathrm | [\mathrm | [\mathrm | [\mathrm | [\mathrm | 3.1 Reading a solar diagram | [\mathrm | 3.2 Basic solar diagram | 3.3 Colour models instead of writing labels | 3.4 Control the reference geometry | 4. Target diagram | 4.1 Reading a target diagram | 4.1.1 Note on the modelskill coordinate convention | 4.2 Basic target diagram | 4.3 Colour models with a legend | 4.4 Change the displayed range | 5. Taylor diagram | [\sigma^ | 5.1 The reference point | 5.2 Full Taylor diagram | 5.3 Half Taylor diagram | 5.4 Labels or legend | 5.5 Centred RMSD contours | 5.6 A limitation of the Taylor diagram | 6. Which diagram should I use? | 7. Customising the diagrams with ggplot2 | 7.1 Add titles and change the theme | 7.2 Move the legend | 7.3 Change the model colour palette | 7.4 Change the target axis titles | 7.5 Zoom without changing the statistics | 7.6 Change point and label sizes | 8. Practical recommendations

Last update: 2026-09-08
Started: 2026-09-07

Readme and manuals

Help Manual

Help pageTopics
Summarize calibration from an accuracy plotaccuracy_plot_metrics
Mean error (ME) of quantitative predictionsbias
Lin's concordance correlation coefficientccc
Pearson correlationcorrelation
Empirical prediction-interval coveragecoverage
Prediction-interval coverage errorcoverage_error
Centered root mean squared errorcrmse
Continuous ranked probability scorecrps
CRPS reliability decompositioncrps_decomposition
Statistics underlying summary diagramsdiagram_stats
Plot prediction-interval calibrationgg_coverage
Plot a probability integral transform histogramgg_pit
Quantile calibration plotgg_qcp
Create a solar diagramgg_solar
Create a target diagramgg_target
Create a Taylor diagramgg_taylor
Central prediction-interval scoreinterval_score
Average prediction-interval widthinterval_width
Kling-Gupta efficiency: KGE (2009)kge
Logarithmic (ignorance) scorelog_score
Mean absolute errormae
Mean absolute percentage errormape
Median absolute errormdae
Model efficiency coefficientmec
Median continuous ranked probability scoremedian_crps
Calculate prediction-validation metrics for one or more modelsmodel_metrics
Mean percentage errormpe
Mean squared errormse
Mean squared logarithmic errormsle
Normalized root mean squared errornrmse
Nash-Sutcliffe efficiencynse
Prediction interval coverage probability (PICP)picp
Quantile (pinball) losspinball_loss
Probability integral transformpit
Quantile coverage probabilityqcp
Squared Pearson correlationr2
Model-efficiency R-squaredR2
Relative absolute errorrae
Range-to-RMSE ratiorer
Root mean squared errorrmse
Root mean squared logarithmic errorrmsle
Ratio of performance to deviationrpd
Ratio of performance to interquartile distancerpiq
Relative root mean squared errorrrmse
Prediction-to-observation standard deviation ratiosd_ratio
Standard error of predictionsep
Symmetric mean absolute percentage errorsmape
Summarize prediction-interval validationuncertainty_metrics
Willmott's index of agreementwillmott_d