diff --git a/analysis/inference.rst b/analysis/inference.rst index 8be66388baff2f734782c57ed73ca4472e9653be..109709f494e4e6889c0d931b0f04e9712577b4d0 100644 --- a/analysis/inference.rst +++ b/analysis/inference.rst @@ -43,10 +43,21 @@ secondary mass satisfies :math:`m_2 \leq 3 M_{\odot}`. the final remnant compact object. This is calculated using the disk mass fitting formula from [#DiskMass]_ (Equation 4). -For preliminary estimates based on the matched-filter pipeline results, the -source properties are calculated using a supervised learning technique; -mass-dependent rates are the same as those used for the classification. For -parameter estimation, updated properties are calculated from posterior samples. +The way that these probabilities are calculated for preliminary alerts differs +for different search pipelines: + +- For GstLAL, the probabilities consider the uncertainty in the + matched-filter estimates of the template parameters. The probabilities are + calculated using supervised machine learning on a feature space consisting of + the masses, spins, and :term:`SNR` of the best-matching template, described + in [#MLEMBright]_. + +- For all other pipelines, the source property probabilities are reported as + exactly 0 or exactly 1 depending on whether the corresponding condition is + satisfied by the best-matching template. **In this case, these probabilities + do not capture uncertainty in the matched-filter estimates of the template + parameters, and should be interpreted with caution.** + .. include:: /journals.rst @@ -57,3 +68,7 @@ parameter estimation, updated properties are calculated from posterior samples. .. [#DiskMass] Foucart, F., Hinderer, T. & Nissanke, S. 2018, |PRD|, 98, 081501. :doi:`10.1103/PhysRevD.98.081501` + +.. [#MLEMBright] + Chatterjee, D., Ghosh, S., Brady, P. R., et al. 2020, |ApJ|, + :arXiv:`1911.00116` diff --git a/changes.rst b/changes.rst index 339b23b66f37963425802c6d9fb18bf46161cabf..d9e184c6c090ed8f80b0d282b0eb6b02342781f4 100644 --- a/changes.rst +++ b/changes.rst @@ -12,6 +12,9 @@ Version 17 (unreleased) .. rubric:: Data Analysis +* Add the reference to the source properties methods paper. + Provide details on the cases where the above method is used. + .. rubric:: Alert Contents .. rubric:: Sample Code diff --git a/spelling_wordlist.txt b/spelling_wordlist.txt index dc48ecbfaf43f46691ea9a364628e2a535eb6803..fa9e0cffebd9d3e974a9b386b7641c4e461eb361 100644 --- a/spelling_wordlist.txt +++ b/spelling_wordlist.txt @@ -19,6 +19,7 @@ capabilities carée Cascina Caudill +Chatterjee Chu coalescences comoving @@ -43,6 +44,7 @@ Fortran Foucart geocenter Germain +Ghosh glitching gnomonic Górski