What each statistic answers
Bland–Altman analysis answers "how far apart are the device and the reference, and in which direction?". The bias is the mean difference, and the 95% limits of agreement (bias ± 1.96 SD of the differences) are the range expected to hold about 95% of individual differences (Bland & Altman, 1986). The confidence intervals around the limits show how precisely your sample pins them down (Bland & Altman, 1999).
The intraclass correlation coefficient (ICC) describes reliability: how much of the total variation comes from real differences between participants rather than disagreement between methods (Shrout & Fleiss, 1979). MAE, MAPE and RMSE summarise the typical size of the error in plain units, which is how most consumer wearable accuracy studies report results.
For categories (sleep stages, rhythm labels), Cohen's kappa measures agreement beyond what chance alone would produce (Cohen, 1960).
Why correlation is not enough
Two methods can be perfectly correlated and still disagree, for example if the device always reads 10 bpm high. Bland and Altman (1986) made this point in the paper that introduced limits of agreement, and it is why this toolkit reports Pearson's r only as a secondary measure of association.
How this toolkit was validated
Every formula is unit-tested against reference implementations: R packages irr, psych and SimplyAgree, and Python's SciPy, pingouin and scikit-learn. It reproduces the published worked examples in Bland & Altman (1986), Shrout & Fleiss (1979) and Lu et al. (2016). The test suite and the scripts that generate the reference values are in the ChatPPG repository.
Before you report
This version treats each row as an independent pair. If you collected several pairs per participant, the limits need a method that accounts for within-participant correlation (Bland & Altman, 1999). Time-align device and reference samples first, and say in the paper how you did it. Then compare your result with published validations of the same device in the wearable accuracy tables and the research hub.