diff --git a/docs/user_docs/source/conf.py b/docs/user_docs/source/conf.py index bf7db35d4ae7b7c2a7215fe352bd06c35d93ebbc..214151e575758f01f21957be8e9ebe7ab5b3c1da 100644 --- a/docs/user_docs/source/conf.py +++ b/docs/user_docs/source/conf.py @@ -58,9 +58,9 @@ author = u'Brian Moe, Branson Stephens, Patrick Brady' # built documents. # # The short X.Y version. -version = '1.19.dev0' +#version = '1.19.dev0' # The full version, including alpha/beta/rc tags. -release = '1.19.dev0' +#release = '1.19.dev0' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. diff --git a/docs/user_docs/source/queries.rst b/docs/user_docs/source/queries.rst index b596cb1c0ea7a17dccc9f27772e66da67a13244d..3819e1cb486648563df65fc25b65b2f56eb4c14a 100644 --- a/docs/user_docs/source/queries.rst +++ b/docs/user_docs/source/queries.rst @@ -15,17 +15,32 @@ In general, a query looks like ``keyword: value``. Multiple attributes can be included in a query (ex: ``key1: val1 key2: val``). The sections below show different attributes that can be queried on and the corresponding syntax. +Some information on combining queries is provided at the end. + Event queries ============= **NOTE:** clicking the 'Get neighbors' checkbox will result in an additional neighbors query for each item in the search results, and the neighbors are thus shown in the results table. However, this causes the overall query to take longer, which is why it is un-checked by default. +By instruments +-------------- +Order matters, because the instruments are stored in the database as a string. +Examples: + +- ``instruments: "H1,L1,V1"`` +- ``instruments: "V1,L1"`` + +By false alarm rate +------------------- +- ``far < 1e-7`` +- ``far: 3.6823e-4`` +- ``far >= 2e-9`` + By event attributes ------------------- -Relational and range queries can be made on event attributes. +Relational and range queries can be made on selected event attributes. Examples: -- ``instruments = "H1,L1,V1" & far < 1e-7`` - ``singleinspiral.mchirp >= 0.5 & singleinspiral.eff_distance in 0.0,55`` - ``(si.channel = "DMT-STRAIN" | si.channel = "DMT-PAIN") & si.snr < 5`` - ``mb.snr in 1,3 & mb.central_freq > 1000`` @@ -101,8 +116,7 @@ This is probably a defect that ought to be remedied. Examples: - ``"waveburst"`` -- ``"gstlalcbc" "gracedb.processor"`` -- ``submitter: "joss.whedon@ligo.org" submitter: "gracedb.processor"`` +- ``submitter: "joss.whedon@ligo.org"`` By superevent status -------------------- @@ -217,3 +231,10 @@ Examples: - ``far < 1e-5`` - ``FAR >= 0.01`` - ``far in 1e-7, 2.5e-6`` + + +Combining queries +================= +Queries can be combined by separating them with a space. +This effectively "AND"s them. +Do not use binary operators like '&' or '|' except between labels in a label-based query or in a query on selected event attributes (see examples above).