Document meaning of "coherence"
I was looking at the coherence report in the superevent page; as far as I can tell there is no reference to somewhere this quantity is defined; I've looked in the gracedb page, the gracedb docs, the ligo.skymap docs.
The closest thing I found was in the docs for ligo-skymap-stats
,
where however it's only stated that log_bci
is the "natural log Bayes factor, coherent vs. incoherent".
From the perspective of a new user, there seems to be no way to find out what "coherence" means in this context besides asking someone. Therefore, I think it would be useful to have somewhere a reference to section V.C in Veitch and Vecchio 2010 or a page with a summarized discussion of its contents. I'm opening this issue here since I think that the GraceDB page is the obvious candidate for where to include this information, but feel free to redirect me if this is not the case.