Why Fine-Mapping Diagnostics Matter
A fine-mapping result can look precise in one output and still depend strongly on choices or computational details. The leading variant may change when a reasonable prior or linkage disequilibrium (LD) input changes; a variant may enter one credible set but not another; or separate computational runs may give noticeably different posterior inclusion probabilities (PIPs). These are different kinds of instability, and they call for different checks.
The goal is not to find one summary that declares a result “stable” or “unstable.” Instead, examine which conclusions survive relevant comparisons. A broad conclusion that a locus contains a signal may be well supported even if the exact variant ranking is not. Conversely, agreement in one summary does not establish that every variant assignment is reliable. The earlier material on prior sensitivity and LD sensitivity motivates perturbing assumptions; here the emphasis is on diagnosing and interpreting the resulting changes.
Separate the Sources of Instability
A useful first step is to distinguish three sources. Computational variability occurs when repeated runs of the same method, data, and model produce different estimates because of finite simulation, random initialization, or incomplete numerical search. Model sensitivity occurs when estimates change after a deliberate change to an assumption, such as a prior or LD input. Data or model limitations arise when the available information cannot distinguish variants well, or when the fitted model does not adequately represent the data. The first calls for convergence checks, the second for sensitivity comparisons, and the third for restrained interpretation and possibly further analysis.
For a variant \(j\), the PIP is the posterior probability that it is causal under the specified model and data. It is not a probability that the variant is causal in an assumption-free sense. A ranking sorts variants by their PIPs, while a credible set collects variants according to a stated posterior-mass rule for a signal. Each summary answers a different question. Ranking diagnostics focus on order and separation; membership diagnostics focus on set overlap; convergence diagnostics ask whether computation reliably estimates the specified posterior.
Before comparing outputs, hold fixed what should be fixed. To assess computational convergence, use the same data, model, priors, and LD input. To assess sensitivity, change the intended input while keeping other choices as comparable as possible. Record the changes made, and compare like with like: PIPs for the same variants and assignments for corresponding signals. If the model permits multiple signals, signal labels such as “signal 1” may be arbitrary output labels rather than biological identities.
Compare Rankings Without Hiding Important Swaps
Rank agreement can be summarized with a rank correlation, but it should not replace inspection of the PIPs and the leading variants. For two rankings of \(n\) variants with no tied ranks, Spearman’s rank correlation is
where \(d_j\) is the difference between the two ranks assigned to variant \(j\). The statistic ranges from \(-1\) (opposite rankings) to \(1\) (identical rankings). With tied ranks, calculate the ordinary correlation of the two rank vectors instead. A high correlation can coexist with a change in the top-ranked variant, especially when most lower-ranked variants retain their order. Therefore report top-variant identity, relevant PIP changes, and rank agreement together.
Worked Example: A High Rank Correlation With a Changed Top Variant
Suppose a hypothetical locus has four variants. Under a baseline analysis, their PIPs are \(0.42, 0.31, 0.17,\) and \(0.10\) for variants A, B, C, and D, respectively. Under a plausible alternative LD input, the PIPs are \(0.29, 0.38, 0.23,\) and \(0.10\).
The baseline ranking is A, B, C, D, while the alternative ranking is B, A, C, D. The rank differences for A through D are \(1,-1,0,0\), so \(\sum d_j^2=1+1=2\). Thus
The overall ordering is fairly similar, but the top-ranked variant changes from A to B. The combined PIP of A and B is \(0.42+0.31=0.73\) in the baseline fit and \(0.29+0.38=0.67\) in the alternative fit. A defensible summary is that A and B remain the leading pair, while their ordering and individual PIPs are sensitive to the LD input. Reporting only \(\rho_s=0.800\) would conceal the top-variant swap; reporting only the swap would conceal the continued support for the pair.
Credible-Set Membership and Signal Assignments
For a given signal, compare the membership of its credible sets across analyses. If the sets are \(C_1\) and \(C_2\), their Jaccard index is the size of their intersection divided by the size of their union:
The index ranges from 0 for disjoint sets to 1 for identical sets. It is a descriptive overlap measure, not a test of whether the sets are equivalent. State the set construction and the comparison being made; a Jaccard value alone does not tell whether the shared variants are the most strongly supported ones.
When there are multiple signals, first match corresponding signals across fits. Output labels can switch even when the underlying signals are similar. Matching can use the overlap of credible sets, the overlap of high-PIP variants, or the similarity of the full variant-level assignments. If two signals are too similar to match clearly, that ambiguity is itself a diagnostic: report it rather than forcing a one-to-one correspondence. Compare memberships only after considering this matching step.
Worked Example: Set Overlap and Relabeled Signals
In a hypothetical two-signal analysis, one fit gives signal 1 the credible set \(C_1=\{A,B,C,D\}\) and signal 2 the set \(\{U,V,W\}\). A second fit gives output label 1 to the signal with set \(\{U,V,W\}\), and output label 2 to the signal with set \(C_2=\{B,C,D,E\}\). The signal labels have switched, so comparing “signal 1” by label would incorrectly suggest that the first signal changed completely.
Match signals by their variant membership. The set \(\{U,V,W\}\) matches itself. For the other matched signal, the intersection is \(\{B,C,D\}\), of size 3, and the union is \(\{A,B,C,D,E\}\), of size 5. Therefore
The overlap is partial: B, C, and D form a shared core, while A and E differ between the sets. This supports describing the signal as localized to that shared group at the level of this comparison, but it does not support claiming that A or E is consistently included. It also illustrates why signal matching must precede comparisons of signal-specific membership.
Check Computational Convergence
Repeated runs under the same model should agree within their computational uncertainty. For simulation-based methods, inspect trace plots and between-chain agreement, and calculate convergence and effective-sample-size diagnostics appropriate to the algorithm. A trace that remains in a limited region, drifts over time, or differs systematically across chains can indicate inadequate exploration. A convergence statistic near its ideal value is useful evidence, but no single diagnostic proves convergence; examine important quantities such as variant PIPs and signal summaries, not only a global statistic.
For a PIP estimated as the mean of inclusion indicators, let \(I_m\) equal 1 if variant \(j\) is included in sampled configuration \(m\), and 0 otherwise. The estimate is \(\hat p_j=M^{-1}\sum_{m=1}^M I_m\). If the draws are correlated, the variance of this average depends on their autocorrelation. An approximate effective sample size is
where \(\rho_k\) is the lag-\(k\) autocorrelation of the indicator sequence. In practice, autocorrelation sums are estimated with suitable truncation or other standard estimators. Positive autocorrelation generally reduces effective sample size; more generally, effective sample size accounts for autocorrelation and can be either smaller or larger than the raw draw count. This Monte Carlo standard error describes numerical uncertainty in estimating the PIP, not uncertainty about whether the variant is causal.
Worked Example: Monte Carlo Error for an Estimated PIP
Suppose a hypothetical simulation-based fine-mapping run produces an estimated PIP of \(0.715\) for variant X. The raw draw count is 10,000, but autocorrelation diagnostics give an effective sample size of 2,500 for X’s inclusion indicator. Assume the chains have mixed adequately and the effective-sample-size estimate is appropriate for this indicator.
The approximate Monte Carlo standard error is
A rough 95% Monte Carlo-error range is \(0.715\pm1.96(0.00903)\), or approximately \(0.697\) to \(0.733\). This range is an approximation for computational error around the estimated PIP, not a 95% interval for the variant’s causal status. If a decision about inclusion in a reported list depends on a threshold near \(0.715\), this amount of Monte Carlo error may matter; more effective draws or further computational checks could be needed. If the PIP is far from any decision threshold, the same numerical error may have little practical consequence.
Decide Which Conclusions Remain Supportable
A useful report separates stable findings from fragile details. For example, analyses may consistently identify the same locus and the same small group of leading variants, while the first- and second-ranked variants exchange places and credible-set membership changes at the boundary. In that situation, report the stable group and make the unresolved variant-level distinction explicit. Do not turn stability into a stronger claim than the analysis supports: stable rankings are not proof of causality, and a stable credible set is conditional on the fitted model and its assumptions.
When presenting diagnostics, specify the comparisons, quantities, and computational evidence. A compact report might state which prior or LD inputs were varied; whether the top variant changed; how much the leading PIPs changed; credible-set overlap; how signals were matched; and whether repeated runs agreed within Monte Carlo error. If model misspecification or limited LD resolution is plausible, these diagnostics cannot repair it. They can show where conclusions are robust and where they are conditional or unresolved.
Practical Diagnostic Sequence
Separate repeated runs under the same model from analyses that deliberately vary a prior, LD input, or other assumption.
Check that variants are consistently identified, and match signals across fits before comparing signal-specific results.
Compare leading variant identities and PIPs, rank agreement, credible-set overlap, signal assignments, and computational diagnostics.
Distinguish robust conclusions from changes that affect the exact variant, set boundary, or signal assignment.
These checks complement rather than replace one another. Rank correlation is a compact comparison of order; set overlap summarizes membership; signal matching prevents arbitrary labels from masquerading as changes; and computational diagnostics assess whether a run estimates its intended result reliably. No one metric subsumes the others.
Check Your Understanding
Answer each question, then compare your reasoning with the solutions.
- Two analyses have Spearman rank correlation \(0.95\), but their top-ranked variants differ. What can and cannot be concluded from the correlation?
- Credible sets are \(\{A,B,C\}\) and \(\{B,C,D\}\). Calculate their Jaccard index and identify the shared variants.
- Two output files reverse the labels “signal 1” and “signal 2,” while each signal’s variants otherwise match. What should be done before describing instability?
- Why is a Monte Carlo-error range for an estimated PIP not a posterior interval for causal status?
- What is the appropriate next step if the same variant has visibly different estimates across repeated runs of the same model and the diagnostic effective sample size is low?
Solutions. (1) The overall rankings are highly similar, but the leading variant is not stable. Inspect and report the leading PIPs and whether the same small group remains at the top; the correlation alone does not establish lead-variant stability. (2) The intersection is \(\{B,C\}\), of size 2, and the union is \(\{A,B,C,D\}\), of size 4, so \(J=2/4=0.500\). B and C are shared. (3) Match corresponding signals by their variant-level evidence or set overlap, not by the arbitrary output labels, and report any ambiguity in matching. (4) Monte Carlo error measures numerical error in estimating a posterior probability from finite, correlated computation. It does not represent the posterior distribution of whether the variant is causal. (5) Investigate mixing and convergence, and increase or improve computation as appropriate; do not interpret the run-to-run differences as model sensitivity until computational variability is adequately controlled.