blandaltman: A command to create variants of Bland–Altman plots

Bland–Altman plots can be useful in paired data settings such as measurement-method comparison studies. A Bland–Altman plot has differences, percentage differences, or ratios on the y axis and a mean of the data pairs on the x axis, with 95% limits of agreement indicating the central 95% range of differences, percentage differences, or ratios. This range can vary with the mean. We introduce the community-contributed blandaltman command, which uniquely in Stata can 1) create Bland–Altman plots featuring ratios in addition to differences and percentage differences, 2) allow the limits of agreement for ratios and percentage differences to vary as a function of the mean, and 3) add confidence intervals, prediction intervals, and tolerance intervals to the plots.

Bland-Altman图（Bland–Altman plots）在配对数据场景中具有较高实用价值，例如在测量方法对比类研究中。此类图的纵轴可展示差值、百分比差值或比值，横轴为数据对的均值；其中95%一致性界限（95% limits of agreement）用于标注差值、百分比差值或比值的中央95%分布区间，且该区间可随均值发生变化。本文介绍了一款由社区贡献的blandaltman命令，其在Stata软件中具备三项独特功能：1）可绘制同时涵盖差值、百分比差值与比值的Bland-Altman图；2）支持令比值与百分比差值的一致性界限随均值动态变化；3）可为图表添加置信区间、预测区间与容忍区间。