From 7bb2b9d883e5eb9a689687ad7abcf26fd6d285d7 Mon Sep 17 00:00:00 2001 From: Nicholas Lee Date: Mon, 28 Aug 2023 17:59:48 -0400 Subject: [PATCH 1/2] feat: added basic search docs --- docs/guide/walkthrough/Studies/Searching.md | 28 +++++++++++++++++++ .../{studies.md => Studies/index.mdx} | 4 +-- docs/guide/walkthrough/search.md | 14 ++++++++++ 3 files changed, 43 insertions(+), 3 deletions(-) create mode 100644 docs/guide/walkthrough/Studies/Searching.md rename docs/guide/walkthrough/{studies.md => Studies/index.mdx} (71%) create mode 100644 docs/guide/walkthrough/search.md diff --git a/docs/guide/walkthrough/Studies/Searching.md b/docs/guide/walkthrough/Studies/Searching.md new file mode 100644 index 0000000..d23497e --- /dev/null +++ b/docs/guide/walkthrough/Studies/Searching.md @@ -0,0 +1,28 @@ +Neurosynth-Compose works with the neurostore database to provide a convenient and functional interface to search for studies. + +### Search Mechanics + +Searching for semantically relevant results utilizes PostgreSQL's support of tokens/vectors when searching documents for relevant text. This approach excludes commonly used words like "a", "it", "on", and "the". It also aims to return similar words and word forms during the search (the term "brain" should return "brains" for example). For a more in depth understanding, you can take a look at the [docs for text search](https://www.postgresql.org/docs/current/textsearch-controls.html). + +Searches are conducted across title and abstract fields. +The input supports `AND`, `OR`, and `NOT` operations. + +For example to use the `AND` operator, you can enter in a value like `nicotine and memory`. Similarly, you can enter an input like `smoking or nicotine` for the `OR` operator, and `smoking -marijuana` for the `NOT` operator (where marijuana is the excluded term). + +In order to ensure that text is grouped together (i.e. one word follows the other) you can include the words in parentheses. For example, the search `"anterior insula"` will only yield results where the word "anterior" is followed by the word "insula". You can then use the above search operators on grouped words: `smokers -"anterior insula"` + +### Study Data Type + +Studies can either report their findings as coordinate data, image data, or in some cases, both. Using the Study Data Type button, you +can filter the results so that only coordinate or image data appears. For example, if you are doing a coordinate based meta-analysis, you +will want to filter the results to show only studies that report coordinates. + +### Sorting Results + +Use the Sort By feature to sort the results based on a given property. You can also set this to be ascending or descending. + +### Filtering + +To filter the results of the search, click on the orange Add Filter button. You have the option of filtering by title, description, author, or publication. Enter the string you want to filter by and click add to apply the filter. + +Only one filter can be applied for each field. In order to remove a filter, simply click on the delete button on the given filter. \ No newline at end of file diff --git a/docs/guide/walkthrough/studies.md b/docs/guide/walkthrough/Studies/index.mdx similarity index 71% rename from docs/guide/walkthrough/studies.md rename to docs/guide/walkthrough/Studies/index.mdx index c4bde4c..c4cc0e4 100644 --- a/docs/guide/walkthrough/studies.md +++ b/docs/guide/walkthrough/Studies/index.mdx @@ -3,6 +3,4 @@ title: Studies Page sidebar_position: 0 --- -# Studies Page - -### \ No newline at end of file +# Studies Page \ No newline at end of file diff --git a/docs/guide/walkthrough/search.md b/docs/guide/walkthrough/search.md new file mode 100644 index 0000000..913bba1 --- /dev/null +++ b/docs/guide/walkthrough/search.md @@ -0,0 +1,14 @@ +--- +title: Searching +sidebar_position: 4 +--- + +# Intro To Searching + +### Searching Studies + +Neurosynth-Compose supports multiple ways to search for studies. + +### Searching Studysets + +### Searching Meta-Analyses \ No newline at end of file From 9840f1f0c1157d28791ea458e932e3a874a75abc Mon Sep 17 00:00:00 2001 From: Nicholas Lee Date: Mon, 11 Sep 2023 10:42:03 -0400 Subject: [PATCH 2/2] feat: finished search docs --- docs/guide/walkthrough/Studies/Searching.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/docs/guide/walkthrough/Studies/Searching.md b/docs/guide/walkthrough/Studies/Searching.md index d23497e..af9e752 100644 --- a/docs/guide/walkthrough/Studies/Searching.md +++ b/docs/guide/walkthrough/Studies/Searching.md @@ -9,7 +9,19 @@ The input supports `AND`, `OR`, and `NOT` operations. For example to use the `AND` operator, you can enter in a value like `nicotine and memory`. Similarly, you can enter an input like `smoking or nicotine` for the `OR` operator, and `smoking -marijuana` for the `NOT` operator (where marijuana is the excluded term). -In order to ensure that text is grouped together (i.e. one word follows the other) you can include the words in parentheses. For example, the search `"anterior insula"` will only yield results where the word "anterior" is followed by the word "insula". You can then use the above search operators on grouped words: `smokers -"anterior insula"` +In order to ensure that text is grouped together (i.e. one word follows the other) you can include the words in quotes. For example, the search `"anterior insula"` will only yield results where the word "anterior" is followed by the word "insula". You can then use the above search operators on grouped words: `smokers -"anterior insula"` + +:::caution +PostgreSQL's search treats the `OR` operator as a union between multiple different search groups. This means that for more complicated queries, you will need to repeat +certain `AND` or `NOT` operators amongst multiple clauses. + +For example, consider the search: `nicotine OR smoking -marijuana`. +In this example, the search results returned to you will be all the results yielded from `nicotine` unioned with all the results of `smoking -marijuana`. Having `-marijuana` here does not relate to the entire search term - just `smoking`. + +To ensure that you do not have any mention of marijuana in your returned papers, you must search: `nicotine -marijuana or smoking -marijuana`. + +The same case applies for `AND` operations. In general, `OR` unions between various search groups consisting of `and`, `not`, and quoted search terms. +::: ### Study Data Type