From 7983e46eadcfae0707dae19f9a5c663b19cdb574 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Fri, 25 Oct 2024 21:28:30 +0000 Subject: [PATCH] deploy: b4a622eb3db130e7508e08931f54ab617421fac8 --- 404.html | 4 +-- assets/js/0e33d78a.590735b7.js | 1 + assets/js/0e33d78a.d8af7f03.js | 1 - ...66607.e0018d80.js => 1f366607.ca48932c.js} | 2 +- assets/js/2367c334.9757426a.js | 1 - assets/js/2367c334.cf6418de.js | 1 + assets/js/4c0219fe.0186eafc.js | 1 + assets/js/4c0219fe.6628a1fc.js | 1 - assets/js/4d19d8bc.7ba67632.js | 1 - assets/js/4d19d8bc.d631161d.js | 1 + ...fd5dd.3810dfdd.js => 5d9fd5dd.469881d2.js} | 2 +- assets/js/708a3a2f.b9393d91.js | 1 + assets/js/708a3a2f.f677cb89.js | 1 - assets/js/8cd595a7.ab2ea4e7.js | 1 - assets/js/8cd595a7.b868e5b5.js | 1 + ...f2afb.4a27909c.js => 935f2afb.bbbf707d.js} | 2 +- assets/js/a1b719ab.3cfefc71.js | 1 + assets/js/a1b719ab.3f1f88dd.js | 1 - assets/js/a3562974.4d0710a1.js | 1 - assets/js/a3562974.a83c1d42.js | 1 + assets/js/b0bf1abf.912af714.js | 1 + assets/js/b0bf1abf.aa8f9ddc.js | 1 - assets/js/b270851a.6ccdb5a8.js | 1 + assets/js/b270851a.7f76da10.js | 1 - assets/js/c2abd45e.a756d662.js | 1 - assets/js/c2abd45e.ba71a24b.js | 1 + ...0799b.5abcfa32.js => c4a0799b.51083267.js} | 2 +- ...6ab22.2459ab27.js => c4e6ab22.d25c897e.js} | 2 +- ...e48a3.7f2b8760.js => f72e48a3.9c7c8817.js} | 2 +- assets/js/f8f8f85a.46bd4f0c.js | 1 + assets/js/f8f8f85a.bb0ee6a6.js | 1 - assets/js/fb8c922a.4a7cb5fa.js | 1 + assets/js/fb8c922a.ea7c56c6.js | 1 - assets/js/runtime~main.7bc5701a.js | 1 + assets/js/runtime~main.b34c99c1.js | 1 - blog.html | 4 +-- blog/2024/1/31/new-year.html | 4 +-- blog/announcing-ns-compose.html | 4 +-- blog/archive.html | 4 +-- blog/tags.html | 4 +-- blog/tags/hello.html | 4 +-- blog/tags/neurosynth.html | 4 +-- blog/tutorials-updates.html | 4 +-- guide.html | 6 ++-- guide/Explore.html | 6 ++-- guide/Explore/Searching.html | 6 ++-- guide/Project.html | 6 ++-- guide/Project/Curation.html | 6 ++-- guide/Project/Extraction.html | 29 +++++-------------- guide/Project/Running.html | 6 ++-- guide/Project/Specification.html | 6 ++-- guide/glossary.html | 6 ++-- index.html | 6 ++-- introduction/ecosystem.html | 6 ++-- introduction/faq.html | 6 ++-- introduction/team.html | 6 ++-- markdown-page.html | 4 +-- tutorial.html | 6 ++-- tutorial/advanced.html | 6 ++-- tutorial/advanced/mkda_association.html | 6 ++-- tutorial/automated.html | 6 ++-- tutorial/manual.html | 6 ++-- 62 files changed, 99 insertions(+), 112 deletions(-) create mode 100644 assets/js/0e33d78a.590735b7.js delete mode 100644 assets/js/0e33d78a.d8af7f03.js rename assets/js/{1f366607.e0018d80.js => 1f366607.ca48932c.js} (79%) delete mode 100644 assets/js/2367c334.9757426a.js create mode 100644 assets/js/2367c334.cf6418de.js create mode 100644 assets/js/4c0219fe.0186eafc.js delete mode 100644 assets/js/4c0219fe.6628a1fc.js delete mode 100644 assets/js/4d19d8bc.7ba67632.js create mode 100644 assets/js/4d19d8bc.d631161d.js rename assets/js/{5d9fd5dd.3810dfdd.js => 5d9fd5dd.469881d2.js} (73%) create mode 100644 assets/js/708a3a2f.b9393d91.js delete mode 100644 assets/js/708a3a2f.f677cb89.js delete mode 100644 assets/js/8cd595a7.ab2ea4e7.js create mode 100644 assets/js/8cd595a7.b868e5b5.js rename assets/js/{935f2afb.4a27909c.js => 935f2afb.bbbf707d.js} (59%) create mode 100644 assets/js/a1b719ab.3cfefc71.js delete mode 100644 assets/js/a1b719ab.3f1f88dd.js delete mode 100644 assets/js/a3562974.4d0710a1.js create mode 100644 assets/js/a3562974.a83c1d42.js create mode 100644 assets/js/b0bf1abf.912af714.js delete mode 100644 assets/js/b0bf1abf.aa8f9ddc.js create mode 100644 assets/js/b270851a.6ccdb5a8.js delete mode 100644 assets/js/b270851a.7f76da10.js delete mode 100644 assets/js/c2abd45e.a756d662.js create mode 100644 assets/js/c2abd45e.ba71a24b.js rename assets/js/{c4a0799b.5abcfa32.js => c4a0799b.51083267.js} (85%) rename assets/js/{c4e6ab22.2459ab27.js => c4e6ab22.d25c897e.js} (57%) rename assets/js/{f72e48a3.7f2b8760.js => f72e48a3.9c7c8817.js} (84%) create mode 100644 assets/js/f8f8f85a.46bd4f0c.js delete mode 100644 assets/js/f8f8f85a.bb0ee6a6.js create mode 100644 assets/js/fb8c922a.4a7cb5fa.js delete mode 100644 assets/js/fb8c922a.ea7c56c6.js create mode 100644 assets/js/runtime~main.7bc5701a.js delete mode 100644 assets/js/runtime~main.b34c99c1.js diff --git a/404.html b/404.html index d3f1b61..069fe73 100644 --- a/404.html +++ b/404.html @@ -5,13 +5,13 @@ Page Not Found | Neurosynth Compose Docs - +
Skip to main content

Page Not Found

We could not find what you were looking for.

Please contact the owner of the site that linked you to the original URL and let them know their link is broken.

- + \ No newline at end of file diff --git a/assets/js/0e33d78a.590735b7.js b/assets/js/0e33d78a.590735b7.js new file mode 100644 index 0000000..da881e1 --- /dev/null +++ b/assets/js/0e33d78a.590735b7.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[4755],{3905:(e,n,t)=>{t.d(n,{Zo:()=>c,kt:()=>m});var o=t(7294);function r(e,n,t){return n in e?Object.defineProperty(e,n,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[n]=t,e}function a(e,n){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);n&&(o=o.filter((function(n){return Object.getOwnPropertyDescriptor(e,n).enumerable}))),t.push.apply(t,o)}return t}function i(e){for(var n=1;n=0||(r[t]=e[t]);return r}(e,n);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(r[t]=e[t])}return r}var s=o.createContext({}),u=function(e){var n=o.useContext(s),t=n;return e&&(t="function"==typeof e?e(n):i(i({},n),e)),t},c=function(e){var n=u(e.components);return o.createElement(s.Provider,{value:n},e.children)},p="mdxType",d={inlineCode:"code",wrapper:function(e){var n=e.children;return o.createElement(o.Fragment,{},n)}},h=o.forwardRef((function(e,n){var t=e.components,r=e.mdxType,a=e.originalType,s=e.parentName,c=l(e,["components","mdxType","originalType","parentName"]),p=u(t),h=r,m=p["".concat(s,".").concat(h)]||p[h]||d[h]||a;return t?o.createElement(m,i(i({ref:n},c),{},{components:t})):o.createElement(m,i({ref:n},c))}));function m(e,n){var t=arguments,r=n&&n.mdxType;if("string"==typeof e||r){var a=t.length,i=new Array(a);i[0]=h;var l={};for(var s in n)hasOwnProperty.call(n,s)&&(l[s]=n[s]);l.originalType=e,l[p]="string"==typeof e?e:r,i[1]=l;for(var u=2;u{t.r(n),t.d(n,{assets:()=>s,contentTitle:()=>i,default:()=>d,frontMatter:()=>a,metadata:()=>l,toc:()=>u});var o=t(7462),r=(t(7294),t(3905));const a={title:"Running Analyses",sidebar_position:3},i="Running Analyses",l={unversionedId:"guide/Project/Running",id:"guide/Project/Running",title:"Running Analyses",description:"You have a several options for running the analysis. In all cases, you will need your unique ``, which you can access for each Meta-Analysis within your Project.",source:"@site/docs/guide/Project/Running.md",sourceDirName:"guide/Project",slug:"/guide/Project/Running",permalink:"/compose-docs/guide/Project/Running",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/guide/Project/Running.md",tags:[],version:"current",lastUpdatedBy:"Alejandro de la Vega",lastUpdatedAt:1729891615,formattedLastUpdatedAt:"Oct 25, 2024",sidebarPosition:3,frontMatter:{title:"Running Analyses",sidebar_position:3},sidebar:"tutorialSidebar",previous:{title:"Specification",permalink:"/compose-docs/guide/Project/Specification"},next:{title:"Explore",permalink:"/compose-docs/guide/Explore/"}},s={},u=[{value:"Google Colab",id:"google-colab",level:2},{value:"Docker",id:"docker",level:2},{value:"Updating the Docker image",id:"updating-the-docker-image",level:3},{value:"Manually prepared environment using pip",id:"manually-prepared-environment-using-pip",level:2}],c={toc:u},p="wrapper";function d(e){let{components:n,...a}=e;return(0,r.kt)(p,(0,o.Z)({},c,a,{components:n,mdxType:"MDXLayout"}),(0,r.kt)("h1",{id:"running-analyses"},"Running Analyses"),(0,r.kt)("p",null,"You have a several options for running the analysis. In all cases, you will need your unique ",(0,r.kt)("inlineCode",{parentName:"p"},""),", which you can access for each Meta-Analysis within your Project."),(0,r.kt)("p",null,(0,r.kt)("img",{alt:"Meta-analysis run",src:t(3349).Z,width:"2994",height:"1030"})),(0,r.kt)("p",null,"Under the hood, analyses are managed by the ",(0,r.kt)("a",{parentName:"p",href:"https://github.com/neurostuff/nsc-runner"},"nsc-runner")," Python package, and executed by the ",(0,r.kt)("a",{parentName:"p",href:"https://nimare.readthedocs.io/en/stable/"},"NiMARE")," (Neuroimaging Meta-Analysis Research Environment) Python package."),(0,r.kt)("h2",{id:"google-colab"},"Google Colab"),(0,r.kt)("p",null,(0,r.kt)("a",{parentName:"p",href:"https://colab.research.google.com/github/neurostuff/neurosynth-compose-notebook/blob/main/run_and_explore.ipynb"},(0,r.kt)("img",{parentName:"a",src:"https://colab.research.google.com/assets/colab-badge.svg",alt:"text"}))),(0,r.kt)("p",null,"The easiest way to run an analysis is to use the ",(0,r.kt)("a",{parentName:"p",href:"https://colab.research.google.com/"},"Google Colab")," notebook linked above."),(0,r.kt)("p",null,"The provided notebook runs entirely in the cloud, and does not require any local installation of software.\nTo use simply paste your analysis ID into the first cell (",(0,r.kt)("inlineCode",{parentName:"p"},"META_ID"),"), and using the Toolbar selet (Runtime -> Run All)\nor the keyboard shortcut (Ctrl or \u2318 + F9) to run the notebook."),(0,r.kt)("p",null,(0,r.kt)("img",{alt:"Colab notebook",src:t(9128).Z,width:"971",height:"1046"})),(0,r.kt)("p",null,"The notebook will install all required software, run the analysis, and upload the results to Neurosynth Compose.\nOnce the analysis is complete, you can use the notebook to explore the results using the interative report, download an archive\nof the results, or browse the results in the Neurosynth Compose web interface, in the Meta-Analysis section of your Project."),(0,r.kt)("admonition",{type:"tip"},(0,r.kt)("p",{parentName:"admonition"},"The Colab notebook has limited and varying freely available resources, and may not be able to run large analyses.\nIf your analysis fails, try running it again, or using one of the other methods below.")),(0,r.kt)("h2",{id:"docker"},"Docker"),(0,r.kt)("p",null,"The easiest way to run analyses locally is to use the ",(0,r.kt)("inlineCode",{parentName:"p"},"nsc-runner")," ",(0,r.kt)("a",{parentName:"p",href:"https://www.docker.com/"},"Docker")," image provided by Neurosynth Compose."),(0,r.kt)("p",null,"Docker is a containerization technology that allows you to run software in a consistent environment, regardless of the underlying operating system."),(0,r.kt)("p",null,"To run the Docker image, you will need to install Docker on your local machine.\nInstructions for installing Docker can be found ",(0,r.kt)("a",{parentName:"p",href:"https://docs.docker.com/get-docker/"},"here"),"."),(0,r.kt)("p",null,"Once Docker is installed, you can run your analysis using the using the following command:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre"},"docker run -it -v -v /local/dir:/results ghcr.io/neurostuff/nsc-runner:latest \n")),(0,r.kt)("p",null,"where ",(0,r.kt)("inlineCode",{parentName:"p"},"/local/dir")," is the path to a local directory where you would like to save the results of your analysis, and ",(0,r.kt)("inlineCode",{parentName:"p"},"")," is the ID of the meta-analysis you would like to run."),(0,r.kt)("p",null,"If you are trying to run the analysis from a mac with an ARM chip (eg an M1 Macbook air) use this command instead:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre"},"docker run -it --platform=linux/amd64 -v /local/dir:/results ghcr.io/neurostuff/nsc-runner:latest \n")),(0,r.kt)("p",null,"The Docker image will download all required software, run the analysis, and upload the results to Neurovault & Neurosynth Compose.\nAn HTML report will be saved in the results directory, and the results will be available in the Meta-Analysis section of your Project on Neurosynth Compose."),(0,r.kt)("h3",{id:"updating-the-docker-image"},"Updating the Docker image"),(0,r.kt)("p",null,"For every release of ",(0,r.kt)("inlineCode",{parentName:"p"},"nsc-runner"),", we publish a corresponding Docker image."),(0,r.kt)("p",null,"You can manually download a specific neuroscout-cli release as follows:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre"},"docker pull ghcr.io/neurostuff/nsc-runner:\n")),(0,r.kt)("p",null,"where ",(0,r.kt)("inlineCode",{parentName:"p"},"")," is the version of ",(0,r.kt)("inlineCode",{parentName:"p"},"nsc-runner")," that you want to download. If you omit version, the latest stable version will be downloaded."),(0,r.kt)("p",null,"You can see the tags available for download on ",(0,r.kt)("a",{parentName:"p",href:"https://github.com/neurostuff/compose-runner/pkgs/container/nsc-runner"},"GitHub")),(0,r.kt)("h2",{id:"manually-prepared-environment-using-pip"},"Manually prepared environment using pip"),(0,r.kt)("admonition",{type:"warning"},(0,r.kt)("p",{parentName:"admonition"},"Manually installing ",(0,r.kt)("inlineCode",{parentName:"p"},"nsc-runner")," may be difficult due to complex dependencies in the SciPy stack, or fMRI-specific tooling. Proceed only if you know what you\u2019re doing.")),(0,r.kt)("p",null,"Use pip to install ",(0,r.kt)("inlineCode",{parentName:"p"},"nsc-runner")," from PyPI:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre"},"pip install nsc-runner\n")),(0,r.kt)("p",null,"and then run the analysis using the following command:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre"},"nsc-runner \n")))}d.isMDXComponent=!0},9128:(e,n,t)=>{t.d(n,{Z:()=>o});const o=t.p+"assets/images/nsc_colab_notebook-6dd430542ed9282c3b94937633f9c1d2.png"},3349:(e,n,t)=>{t.d(n,{Z:()=>o});const o=t.p+"assets/images/ma_run-21ff60898e902524975d8fc965d4a08c.png"}}]); \ No newline at end of file diff --git a/assets/js/0e33d78a.d8af7f03.js b/assets/js/0e33d78a.d8af7f03.js deleted file mode 100644 index 1bbf39f..0000000 --- a/assets/js/0e33d78a.d8af7f03.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[4755],{3905:(e,n,t)=>{t.d(n,{Zo:()=>c,kt:()=>h});var o=t(7294);function r(e,n,t){return n in e?Object.defineProperty(e,n,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[n]=t,e}function a(e,n){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);n&&(o=o.filter((function(n){return Object.getOwnPropertyDescriptor(e,n).enumerable}))),t.push.apply(t,o)}return t}function i(e){for(var n=1;n=0||(r[t]=e[t]);return r}(e,n);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(r[t]=e[t])}return r}var s=o.createContext({}),u=function(e){var n=o.useContext(s),t=n;return e&&(t="function"==typeof e?e(n):i(i({},n),e)),t},c=function(e){var n=u(e.components);return o.createElement(s.Provider,{value:n},e.children)},p="mdxType",d={inlineCode:"code",wrapper:function(e){var n=e.children;return o.createElement(o.Fragment,{},n)}},m=o.forwardRef((function(e,n){var t=e.components,r=e.mdxType,a=e.originalType,s=e.parentName,c=l(e,["components","mdxType","originalType","parentName"]),p=u(t),m=r,h=p["".concat(s,".").concat(m)]||p[m]||d[m]||a;return t?o.createElement(h,i(i({ref:n},c),{},{components:t})):o.createElement(h,i({ref:n},c))}));function h(e,n){var t=arguments,r=n&&n.mdxType;if("string"==typeof e||r){var a=t.length,i=new Array(a);i[0]=m;var l={};for(var s in n)hasOwnProperty.call(n,s)&&(l[s]=n[s]);l.originalType=e,l[p]="string"==typeof e?e:r,i[1]=l;for(var u=2;u{t.r(n),t.d(n,{assets:()=>s,contentTitle:()=>i,default:()=>d,frontMatter:()=>a,metadata:()=>l,toc:()=>u});var o=t(7462),r=(t(7294),t(3905));const a={title:"Running Analyses",sidebar_position:3},i="Running Analyses",l={unversionedId:"guide/Project/Running",id:"guide/Project/Running",title:"Running Analyses",description:"You have a several options for running the analysis. In all cases, you will need your unique ``, which you can access for each Meta-Analysis within your Project.",source:"@site/docs/guide/Project/Running.md",sourceDirName:"guide/Project",slug:"/guide/Project/Running",permalink:"/compose-docs/guide/Project/Running",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/guide/Project/Running.md",tags:[],version:"current",lastUpdatedBy:"James Kent",lastUpdatedAt:1727371503,formattedLastUpdatedAt:"Sep 26, 2024",sidebarPosition:3,frontMatter:{title:"Running Analyses",sidebar_position:3},sidebar:"tutorialSidebar",previous:{title:"Specification",permalink:"/compose-docs/guide/Project/Specification"},next:{title:"Explore",permalink:"/compose-docs/guide/Explore/"}},s={},u=[{value:"Google Colab",id:"google-colab",level:2},{value:"Docker",id:"docker",level:2},{value:"Updating the Docker image",id:"updating-the-docker-image",level:3},{value:"Manually prepared environment using pip",id:"manually-prepared-environment-using-pip",level:2}],c={toc:u},p="wrapper";function d(e){let{components:n,...a}=e;return(0,r.kt)(p,(0,o.Z)({},c,a,{components:n,mdxType:"MDXLayout"}),(0,r.kt)("h1",{id:"running-analyses"},"Running Analyses"),(0,r.kt)("p",null,"You have a several options for running the analysis. In all cases, you will need your unique ",(0,r.kt)("inlineCode",{parentName:"p"},""),", which you can access for each Meta-Analysis within your Project."),(0,r.kt)("p",null,(0,r.kt)("img",{alt:"Meta-analysis run",src:t(3349).Z,width:"2994",height:"1030"})),(0,r.kt)("p",null,"Under the hood, analyses are managed by the ",(0,r.kt)("a",{parentName:"p",href:"https://github.com/neurostuff/nsc-runner"},"nsc-runner")," Python package, and executed by the ",(0,r.kt)("a",{parentName:"p",href:"https://nimare.readthedocs.io/en/stable/"},"NiMARE")," (Neuroimaging Meta-Analysis Research Environment) Python package."),(0,r.kt)("h2",{id:"google-colab"},"Google Colab"),(0,r.kt)("p",null,(0,r.kt)("a",{parentName:"p",href:"https://colab.research.google.com/github/neurostuff/neurosynth-compose-notebook/blob/main/run_and_explore.ipynb"},(0,r.kt)("img",{parentName:"a",src:"https://colab.research.google.com/assets/colab-badge.svg",alt:"text"}))),(0,r.kt)("p",null,"The easiest way to run an analysis is to use the ",(0,r.kt)("a",{parentName:"p",href:"https://colab.research.google.com/"},"Google Colab")," notebook linked above."),(0,r.kt)("p",null,"The provided notebook runs entirely in the cloud, and does not require any local installation of software.\nTo use simply paste your analysis ID into the first cell (",(0,r.kt)("inlineCode",{parentName:"p"},"META_ID"),"), and using the Toolbar selet (Runtime -> Run All)\nor the keyboard shortcut (Ctrl or \u2318 + F9) to run the notebook."),(0,r.kt)("p",null,(0,r.kt)("img",{alt:"Colab notebook",src:t(9128).Z,width:"971",height:"1046"})),(0,r.kt)("p",null,"The notebook will install all required software, run the analysis, and upload the results to Neurosynth Compose.\nOnce the analysis is complete, you can use the notebook to explore the results using the interative report, download an archive\nof the results, or browse the results in the Neurosynth Compose web interface, in the Meta-Analysis section of your Project."),(0,r.kt)("admonition",{type:"tip"},(0,r.kt)("p",{parentName:"admonition"},"The Colab notebook has limited and varying freely available resources, and may not be able to run large analyses.\nIf your analysis fails, try running it again, or using one of the other methods below.")),(0,r.kt)("h2",{id:"docker"},"Docker"),(0,r.kt)("p",null,"The easiest way to run analyses locally is to use the ",(0,r.kt)("inlineCode",{parentName:"p"},"nsc-runner")," ",(0,r.kt)("a",{parentName:"p",href:"https://www.docker.com/"},"Docker")," image provided by Neurosynth Compose."),(0,r.kt)("p",null,"Docker is a containerization technology that allows you to run software in a consistent environment, regardless of the underlying operating system."),(0,r.kt)("p",null,"To run the Docker image, you will need to install Docker on your local machine.\nInstructions for installing Docker can be found ",(0,r.kt)("a",{parentName:"p",href:"https://docs.docker.com/get-docker/"},"here"),"."),(0,r.kt)("p",null,"Once Docker is installed, you can run your analysis using the using the following command:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre"},"docker run -it -v -v /local/dir:/results ghcr.io/neurostuff/nsc-runner:latest \n")),(0,r.kt)("p",null,"where ",(0,r.kt)("inlineCode",{parentName:"p"},"/local/dir")," is the path to a local directory where you would like to save the results of your analysis, and ",(0,r.kt)("inlineCode",{parentName:"p"},"")," is the ID of the meta-analysis you would like to run."),(0,r.kt)("p",null,"If you are trying to run the analysis from a mac with an ARM chip (eg an M1 Macbook air) use this command instead:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre"},"docker run -it --platform=linux/amd64 -v /local/dir:/results ghcr.io/neurostuff/nsc-runner:latest \n")),(0,r.kt)("p",null,"The Docker image will download all required software, run the analysis, and upload the results to Neurovault & Neurosynth Compose.\nAn HTML report will be saved in the results directory, and the results will be available in the Meta-Analysis section of your Project on Neurosynth Compose."),(0,r.kt)("h3",{id:"updating-the-docker-image"},"Updating the Docker image"),(0,r.kt)("p",null,"For every release of ",(0,r.kt)("inlineCode",{parentName:"p"},"nsc-runner"),", we publish a corresponding Docker image."),(0,r.kt)("p",null,"You can manually download a specific neuroscout-cli release as follows:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre"},"docker pull ghcr.io/neurostuff/nsc-runner:\n")),(0,r.kt)("p",null,"where ",(0,r.kt)("inlineCode",{parentName:"p"},"")," is the version of ",(0,r.kt)("inlineCode",{parentName:"p"},"nsc-runner")," that you want to download. If you omit version, the latest stable version will be downloaded."),(0,r.kt)("p",null,"You can see the tags available for download on ",(0,r.kt)("a",{parentName:"p",href:"https://github.com/neurostuff/compose-runner/pkgs/container/nsc-runner"},"GitHub")),(0,r.kt)("h2",{id:"manually-prepared-environment-using-pip"},"Manually prepared environment using pip"),(0,r.kt)("admonition",{type:"warning"},(0,r.kt)("p",{parentName:"admonition"},"Manually installing ",(0,r.kt)("inlineCode",{parentName:"p"},"nsc-runner")," may be difficult due to complex dependencies in the SciPy stack, or fMRI-specific tooling. Proceed only if you know what you\u2019re doing.")),(0,r.kt)("p",null,"Use pip to install ",(0,r.kt)("inlineCode",{parentName:"p"},"nsc-runner")," from PyPI:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre"},"pip install nsc-runner\n")),(0,r.kt)("p",null,"and then run the analysis using the following command:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre"},"nsc-runner \n")))}d.isMDXComponent=!0},9128:(e,n,t)=>{t.d(n,{Z:()=>o});const o=t.p+"assets/images/nsc_colab_notebook-6dd430542ed9282c3b94937633f9c1d2.png"},3349:(e,n,t)=>{t.d(n,{Z:()=>o});const o=t.p+"assets/images/ma_run-21ff60898e902524975d8fc965d4a08c.png"}}]); \ No newline at end of file diff --git a/assets/js/1f366607.e0018d80.js b/assets/js/1f366607.ca48932c.js similarity index 79% rename from assets/js/1f366607.e0018d80.js rename to assets/js/1f366607.ca48932c.js index 970f111..51f9962 100644 --- a/assets/js/1f366607.e0018d80.js +++ b/assets/js/1f366607.ca48932c.js @@ -1 +1 @@ -"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[8755],{3905:(e,t,r)=>{r.d(t,{Zo:()=>l,kt:()=>m});var n=r(7294);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function c(e){for(var t=1;t=0||(o[r]=e[r]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(o[r]=e[r])}return o}var s=n.createContext({}),p=function(e){var t=n.useContext(s),r=t;return e&&(r="function"==typeof e?e(t):c(c({},t),e)),r},l=function(e){var t=p(e.components);return n.createElement(s.Provider,{value:t},e.children)},u="mdxType",d={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},f=n.forwardRef((function(e,t){var r=e.components,o=e.mdxType,i=e.originalType,s=e.parentName,l=a(e,["components","mdxType","originalType","parentName"]),u=p(r),f=o,m=u["".concat(s,".").concat(f)]||u[f]||d[f]||i;return r?n.createElement(m,c(c({ref:t},l),{},{components:r})):n.createElement(m,c({ref:t},l))}));function m(e,t){var r=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var i=r.length,c=new Array(i);c[0]=f;var a={};for(var s in t)hasOwnProperty.call(t,s)&&(a[s]=t[s]);a.originalType=e,a[u]="string"==typeof e?e:o,c[1]=a;for(var p=2;p{r.r(t),r.d(t,{assets:()=>s,contentTitle:()=>c,default:()=>d,frontMatter:()=>i,metadata:()=>a,toc:()=>p});var n=r(7462),o=(r(7294),r(3905));const i={title:"Specification",sidebar_position:2},c=void 0,a={unversionedId:"guide/Project/Specification",id:"guide/Project/Specification",title:"Specification",description:"Work in progress!",source:"@site/docs/guide/Project/Specification.md",sourceDirName:"guide/Project",slug:"/guide/Project/Specification",permalink:"/compose-docs/guide/Project/Specification",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/guide/Project/Specification.md",tags:[],version:"current",lastUpdatedBy:"James Kent",lastUpdatedAt:1727371503,formattedLastUpdatedAt:"Sep 26, 2024",sidebarPosition:2,frontMatter:{title:"Specification",sidebar_position:2},sidebar:"tutorialSidebar",previous:{title:"Extraction",permalink:"/compose-docs/guide/Project/Extraction"},next:{title:"Running Analyses",permalink:"/compose-docs/guide/Project/Running"}},s={},p=[{value:"Work in progress!",id:"work-in-progress",level:2}],l={toc:p},u="wrapper";function d(e){let{components:t,...r}=e;return(0,o.kt)(u,(0,n.Z)({},l,r,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h2",{id:"work-in-progress"},"Work in progress!"),(0,o.kt)("p",null,"We're still working on completing the documentation for this. Please check back later."))}d.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[8755],{3905:(e,t,r)=>{r.d(t,{Zo:()=>l,kt:()=>m});var n=r(7294);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function c(e){for(var t=1;t=0||(o[r]=e[r]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(o[r]=e[r])}return o}var s=n.createContext({}),p=function(e){var t=n.useContext(s),r=t;return e&&(r="function"==typeof e?e(t):c(c({},t),e)),r},l=function(e){var t=p(e.components);return n.createElement(s.Provider,{value:t},e.children)},u="mdxType",d={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},f=n.forwardRef((function(e,t){var r=e.components,o=e.mdxType,i=e.originalType,s=e.parentName,l=a(e,["components","mdxType","originalType","parentName"]),u=p(r),f=o,m=u["".concat(s,".").concat(f)]||u[f]||d[f]||i;return r?n.createElement(m,c(c({ref:t},l),{},{components:r})):n.createElement(m,c({ref:t},l))}));function m(e,t){var r=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var i=r.length,c=new Array(i);c[0]=f;var a={};for(var s in t)hasOwnProperty.call(t,s)&&(a[s]=t[s]);a.originalType=e,a[u]="string"==typeof e?e:o,c[1]=a;for(var p=2;p{r.r(t),r.d(t,{assets:()=>s,contentTitle:()=>c,default:()=>d,frontMatter:()=>i,metadata:()=>a,toc:()=>p});var n=r(7462),o=(r(7294),r(3905));const i={title:"Specification",sidebar_position:2},c=void 0,a={unversionedId:"guide/Project/Specification",id:"guide/Project/Specification",title:"Specification",description:"Work in progress!",source:"@site/docs/guide/Project/Specification.md",sourceDirName:"guide/Project",slug:"/guide/Project/Specification",permalink:"/compose-docs/guide/Project/Specification",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/guide/Project/Specification.md",tags:[],version:"current",lastUpdatedBy:"Alejandro de la Vega",lastUpdatedAt:1729891615,formattedLastUpdatedAt:"Oct 25, 2024",sidebarPosition:2,frontMatter:{title:"Specification",sidebar_position:2},sidebar:"tutorialSidebar",previous:{title:"Extraction",permalink:"/compose-docs/guide/Project/Extraction"},next:{title:"Running Analyses",permalink:"/compose-docs/guide/Project/Running"}},s={},p=[{value:"Work in progress!",id:"work-in-progress",level:2}],l={toc:p},u="wrapper";function d(e){let{components:t,...r}=e;return(0,o.kt)(u,(0,n.Z)({},l,r,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h2",{id:"work-in-progress"},"Work in progress!"),(0,o.kt)("p",null,"We're still working on completing the documentation for this. Please check back later."))}d.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/2367c334.9757426a.js b/assets/js/2367c334.9757426a.js deleted file mode 100644 index 9de048a..0000000 --- a/assets/js/2367c334.9757426a.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[7068],{4894:(e,t,a)=>{a.r(t),a.d(t,{assets:()=>d,contentTitle:()=>l,default:()=>m,frontMatter:()=>s,metadata:()=>r,toc:()=>c});var i=a(7462),n=(a(7294),a(3905)),o=a(5154);const s={sidebar_label:"Manual Meta-Analysis",sidebar_position:1},l="Manual Meta-Analysis",r={unversionedId:"tutorial/manual",id:"tutorial/manual",title:"Manual Meta-Analysis",description:"How to create a custom, manual meta-analysis.",source:"@site/docs/tutorial/manual.md",sourceDirName:"tutorial",slug:"/tutorial/manual",permalink:"/compose-docs/tutorial/manual",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/tutorial/manual.md",tags:[],version:"current",lastUpdatedBy:"James Kent",lastUpdatedAt:1727371503,formattedLastUpdatedAt:"Sep 26, 2024",sidebarPosition:1,frontMatter:{sidebar_label:"Manual Meta-Analysis",sidebar_position:1},sidebar:"tutorialSidebar",previous:{title:"Tutorials",permalink:"/compose-docs/tutorial/"},next:{title:"Automated Meta-Analysis",permalink:"/compose-docs/tutorial/automated"}},d={},c=[{value:"Creating a new Project",id:"creating-a-new-project",level:2},{value:"Search & Curate",id:"search--curate",level:2},{value:"Importing studies",id:"importing-studies",level:3},{value:"Searching PubMed",id:"searching-pubmed",level:4},{value:"Identification",id:"identification",level:3},{value:"Screening",id:"screening",level:3},{value:"Eligibility",id:"eligibility",level:3},{value:"Included",id:"included",level:3},{value:"Extract and Annotation",id:"extract-and-annotation",level:2},{value:"Ingestion",id:"ingestion",level:3},{value:"Editing studies",id:"editing-studies",level:3},{value:"Analysis Data",id:"analysis-data",level:4},{value:"Annotations",id:"annotations",level:4},{value:"Meta-analysis specification",id:"meta-analysis-specification",level:2},{value:"Run your meta-analysis!",id:"run-your-meta-analysis",level:2}],u={toc:c},p="wrapper";function m(e){let{components:t,...s}=e;return(0,n.kt)(p,(0,i.Z)({},u,s,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"manual-meta-analysis"},"Manual Meta-Analysis"),(0,n.kt)("p",null,(0,n.kt)("em",{parentName:"p"},"How to create a custom, manual meta-analysis.")),(0,n.kt)("admonition",{type:"info"},(0,n.kt)("p",{parentName:"admonition"},"This is a condensed adaptation of a course taught at OHBM 2023.\nSee the ",(0,n.kt)("a",{parentName:"p",href:"https://neurostuff.github.io/meta-analysis-book/"},"course materials")," for a complete overview.")),(0,n.kt)("p",null,(0,n.kt)("em",{parentName:"p"},"Neurosynth Compose")," provides a streamlined workflow to facilitate study selection and\ndata extraction. You can then easily specify a high-quality manual meta-analysis and execute it in the cloud,\nrapidly generating results that you can inspect and share."),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},"We will perform a slimmed down replication of the following meta-analysis:\n",(0,n.kt)("a",{parentName:"p",href:"https://www.ncbi.nlm.nih.gov/pmc/articles/PMC4494985/"},"Neurobiological impact of nicotinic acetylcholine receptor agonists: An ALE meta-analysis of pharmacological neuroimaging studies"),"."),(0,n.kt)("p",{parentName:"admonition"},"For more guidance on how to choose a topic for meta-analysis, see the ",(0,n.kt)("a",{parentName:"p",href:"https://www.bmj.com/content/372/bmj.n71"},"PRISMA statement")," and the ",(0,n.kt)("a",{parentName:"p",href:"https://www.ncbi.nlm.nih.gov/pmc/articles/PMC5918306/"},"10 simple rules for neuroimaging meta-analyses"),".")),(0,n.kt)("h2",{id:"creating-a-new-project"},"Creating a new Project"),(0,n.kt)("p",null,(0,n.kt)("em",{parentName:"p"},"Projects")," contain all the Steps necessary to create a new meta-analysis in Neurosynth Compose.\nWe'll step through this process in detail."),(0,n.kt)("p",null,"To get started, ",(0,n.kt)("em",{parentName:"p"},"sign in"),", and select ",(0,n.kt)("strong",{parentName:"p"},"New Project"),'.\nThe default name of a new Project is "Untitled", change this to "Replication of: Neurobiological impact of nicotinic acetylcholine receptor agonists".'),(0,n.kt)("p",null,"You'll now see the Project page, showing the three stages of a meta-analysis:\n",(0,n.kt)("strong",{parentName:"p"},"Search & Curate, Extract & Annotate")," and ",(0,n.kt)("strong",{parentName:"p"},"Specify Meta-Analyses"),"."),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"New Project",src:a(4819).Z,width:"1557",height:"501"}),". "),(0,n.kt)("h2",{id:"search--curate"},"Search & Curate"),(0,n.kt)("p",null,"The first step in a meta-analysis is to ",(0,n.kt)("em",{parentName:"p"},"Search")," for studies, and ",(0,n.kt)("em",{parentName:"p"},"Curate")," these studies into a\nfinal ",(0,n.kt)("em",{parentName:"p"},"StudySet")," that contains the studies we want to include in a Meta-Analysis."),(0,n.kt)("p",null,"To get started, we must choose a Curation workflow. There are three options: Simple, PRISMA and Custom. The main difference between these options is the number of review steps involved in creating a final list of studies. ",(0,n.kt)("strong",{parentName:"p"},'For a rigorous Manual Meta-Analysis, select "PRISMA".')),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},"Reviewers typically require Preferred Reporting Items for Systematic Reviews and Meta-Analyses (PRISMA) reporting\nfor gold-standard meta-analyses. The PRISMA guidelines ensure a systematic selection and reporting process.\nHowever, a Simple workflow may be useful for exploratory and automated meta-analyses. ")),(0,n.kt)("p",null,"Next, you will be presented with the Curation board, consisting of four columns representing\nthe steps of a PRISMA workflow:"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("strong",{parentName:"p"},"Identification"),": Remove duplicate studies")),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("strong",{parentName:"p"},"Screening"),": Remove irrelevant studies")),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("strong",{parentName:"p"},"Elibility"),": Remove studies that do not meet inclusion criteria or do not have retrievable information")),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("strong",{parentName:"p"},"Included"),": Double check the studies and view which studies will be included in the meta-analysis"))),(0,n.kt)("p",null,"The overall goal is to go from a large number of studies from a broad search results, to only the\nstudies that are relevant to your research question. These steps should be completed in order!"),(0,n.kt)("h3",{id:"importing-studies"},"Importing studies"),(0,n.kt)("p",null,"But first, we must add studies to our Project. Click the ",(0,n.kt)("strong",{parentName:"p"},"Import Studies")," button on the top right of the screen."),(0,n.kt)("p",null,"You can search for studies within the ",(0,n.kt)("em",{parentName:"p"},"NeuroStore")," database\u2014which we maintain and indexes over 20,000 pre-processed neuroimaging studies\u2014or from external sources, such as PubMed or a Citation manager file. "),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Import Studies",src:a(3569).Z,width:"1543",height:"436"}),". "),(0,n.kt)("p",null,(0,n.kt)("em",{parentName:"p"},"Import via NeuroStore")," is simpler and faster, as these studies already exist on in our system\nand have pre-extracted imaging data (e.g. coordinates).\nAs a result, there will be fewer irrelevant studies to exclude, and less data extraction to complete."),(0,n.kt)("p",null,"However, ",(0,n.kt)("em",{parentName:"p"},"searching other sources")," is often recommended for a comprehensive literature search, as a single source can never index all possible studies."),(0,n.kt)("p",null,"To replicate the Nicotine meta-analysis, we will replicate the author's PubMed search."),(0,n.kt)("admonition",{type:"info"},(0,n.kt)("p",{parentName:"admonition"},"Searching NeuroStore is a valid option for a manual meta-analysis to balance rigor and efficiency. To learn more, see the ",(0,n.kt)("a",{parentName:"p",href:"/compose-docs/tutorial/automated"},"Automated Meta-Analysis tutorial"),". ")),(0,n.kt)("h4",{id:"searching-pubmed"},"Searching PubMed"),(0,n.kt)("p",null,"We can export any PubMed search result to file, and import that file into Neurosynth Compose.\nIn this example, we perform the following search which in the ",(0,n.kt)("a",{parentName:"p",href:"https://pubmed.ncbi.nlm.nih.gov/"},"PubMed")," search field:"),(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre"},'("fMRI" OR "PET" OR "neuroimaging" OR "Functional magnetic resonance imaging" OR "functional MRI") \nAND ("nicotine" OR "cigarette" OR "smok*" OR "DMXB-A")\n')),(0,n.kt)("p",null,"This results in over 3,000 studies that are potentially relevant for this meta-analysis."),(0,n.kt)("p",null,"Next, we save the results to ",(0,n.kt)("inlineCode",{parentName:"p"},"PMID")," format, with a PubMed ID on each line."),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Download PubMed",src:a(6652).Z,width:"1053",height:"475"})),(0,n.kt)("admonition",{type:"info"},(0,n.kt)("p",{parentName:"admonition"},"Reviewing 3,000 studies can take a long time!\nOnly a small percentage of these studies will meet all inclusion criteria. For the sake of the tutorial, we provide a shortened list of ",(0,n.kt)(o.aBF,{size:20,mdxType:"FaDownload"})," ",(0,n.kt)("a",{target:"_blank",href:a(7555).Z},"PUBMED IDS"),".")),(0,n.kt)("p",null,"We can import this file into our Project by clicking ",(0,n.kt)("strong",{parentName:"p"},"Upload File")," or by\ncopy/pasting the IDs into the box. Give this import a name for future reference.\nAll studies imported from this search will be ",(0,n.kt)("strong",{parentName:"p"},"Tagged")," with the search name. "),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Import name",src:a(212).Z,width:"1282",height:"354"})),(0,n.kt)("h3",{id:"identification"},"Identification"),(0,n.kt)("p",null,"All the imported studies are now visible in the first column of our PRISMA curation board. "),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Identification",src:a(8665).Z,width:"3595",height:"939"})),(0,n.kt)("p",null,"The purpose ",(0,n.kt)("strong",{parentName:"p"},"Identification")," is to find ",(0,n.kt)("em",{parentName:"p"},"duplicate studies"),", which is common when importing from multiple sources.\n",(0,n.kt)("em",{parentName:"p"},"Neurosynth Compose")," will automatically find potential duplicates (based on the Title, DOI, and PMID).\nHowever, you can also manually review studies to identify any duplicates we might have missed."),(0,n.kt)("p",null,"To review studies, click on the ",(0,n.kt)("strong",{parentName:"p"},"Identification"),' column header, or an individual study.\nFor each study, you can choose to "Promote" it to the next phase, "Exclude" as a duplicate, or flag for later review.'),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Identification review",src:a(3615).Z,width:"2251",height:"1211"})),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},"To remain PRISMA compliant, you should only exclude studies for being a duplicate in the Identification step.")),(0,n.kt)("p",null,"In this example, there are no duplicates. To quickly advance, click ",(0,n.kt)("strong",{parentName:"p"},"Promote All Uncategorized Studies")," under ",(0,n.kt)("em",{parentName:"p"},"Identification"),"."),(0,n.kt)("h3",{id:"screening"},"Screening"),(0,n.kt)("p",null,"The goal of ",(0,n.kt)("em",{parentName:"p"},"Screening")," is to determine if imported studies are relevant to your research question, based on the the Tile\nand Abstract of each."),(0,n.kt)("p",null,"To begin, click on the Screening column header from the main Curation board. The interface is\nidentical to the previous phase, except the default Exclusion reason is now ",(0,n.kt)("strong",{parentName:"p"},"irrelevant"),". "),(0,n.kt)("p",null,"Go ahead and review all 13 studies to determine if they are relevant to the topic of ",(0,n.kt)("em",{parentName:"p"},'"Nicotine administration'),'".\nAny studies that are not relevant will remain in this column and not advance.'),(0,n.kt)("h3",{id:"eligibility"},"Eligibility"),(0,n.kt)("p",null,"The goal ",(0,n.kt)("em",{parentName:"p"},"Eligibility")," is to determine studies meet the eligibility criteria of your meta-analysis.\nYou will need to read the ",(0,n.kt)("strong",{parentName:"p"},"full text")," to make this determination. "),(0,n.kt)("admonition",{type:"note"},(0,n.kt)("p",{parentName:"admonition"},"The eligibility criteria depends on your research question!\nThis is where your expertise is most necessary, in order to create an interesting research question,\nand filter studies accordingly. The results of this step depends on the researcher, and there may be reasonable scientific disagreements.")),(0,n.kt)("p",null,'To begin, click on the "Eligibility" column header, or a study, as before.'),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Custom Eligibility",src:a(940).Z,width:"2341",height:"1449"})),(0,n.kt)("p",null,"For this example, we will include studies that meet these criteria:"),(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre"},"* fMRI or PET\n* Reported brain activity in stereotaxic coordinates (Talairach or MNI space)\n* Reported a set of coordinates (i.e., foci) from a within-subjects or between-subjects contrast assessing the effects of nAChR agonist administration (i.e., pharmacological administration or cigarette smoking) relative to a baseline condition (i.e., placebo administration or smoking-abstinence condition)\n* Examined brain activity using a cognitive or affective task paradigm or at rest. \n* Studies examining functional connectivity, brain morphology, or neurochemistry are excluded.\n")),(0,n.kt)("p",null,"For this tutorial, go ahead and review all studies in this column, and Promote relevant studies to the next phase."),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},"Given that this phase is more open-ended, there is no default Exclusion reason. We provide four default options for you, and\nyou may define custom Exclusion reasons if you see fit.")),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},'For open source studies, we will link to the article full text (PDF). If not available, click\n"view article link" to view article\'s PubMed page, and access the full text using your credentials.')),(0,n.kt)("h3",{id:"included"},"Included"),(0,n.kt)("p",null,"Congratulations! Once you have reviewed all studies, you should have a set of studies that you want to include in your meta-analysis. "),(0,n.kt)("p",null,"At this point, you can review this final list, and view a PRISMA diagram visually outlining your review process:"),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"PRISMA",src:a(8718).Z,width:"1714",height:"1448"})),(0,n.kt)("p",null,"To finish ",(0,n.kt)("em",{parentName:"p"},"Curation"),", and create a final StudySet, click ",(0,n.kt)("em",{parentName:"p"},"Move on to Extraction")," at the top right. "),(0,n.kt)("h2",{id:"extract-and-annotation"},"Extract and Annotation"),(0,n.kt)("p",null,"The goal of this phase is to ",(0,n.kt)("strong",{parentName:"p"},"extract data")," from the text of studies (such as coordinates)\nthat will be used in the meta-analysis. You will also want to ",(0,n.kt)("strong",{parentName:"p"},"annotate")," relevant Study meta-data.\nMost commonly, for each Study you will designate which Analyses (i.e. Contrasts) to included in your meta-analysis."),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},"Studies that are already indexed by NeuroStore will have automatically extracted data (such as coordinates)\nsaving you a lot of time and effort. However, you may want to verify and improve this information.")),(0,n.kt)("h3",{id:"ingestion"},"Ingestion"),(0,n.kt)("p",null,"But first, we must create a StudySet containing your studies! "),(0,n.kt)("p",null,"New studies not in the NeuroStore database will be created, and studies that match existing studies will be added to a newly created StudySet."),(0,n.kt)("admonition",{type:"info"},(0,n.kt)("p",{parentName:"admonition"},"Studies in NeuroStore have multiple Versions, including those created by other users, as well as the original copy."),(0,n.kt)("p",{parentName:"admonition"},"If you ingest a study that is already indexed in the database, we will match to the newest possible Version, by default.\nIdeally, this will be a Version that another user has already improved, saving you even more time!"),(0,n.kt)("p",{parentName:"admonition"},"You can switch Study Versions at anytime (including to the original automate copy) by clicking ",(0,n.kt)("em",{parentName:"p"},"Switch Study Version")," at the bottom\nof Study's page. Any edits you make will automatically be saved as a new Version.")),(0,n.kt)("h3",{id:"editing-studies"},"Editing studies"),(0,n.kt)("p",null,"Once your StudySet is created, it's time to edit studies. You will see a list of your studies:"),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Extraction",src:a(9774).Z,width:"1540",height:"880"})),(0,n.kt)("p",null,"Click on any Study to edit:"),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Extraction study view",src:a(5362).Z,width:"2418",height:"856"})),(0,n.kt)("h4",{id:"analysis-data"},"Analysis Data"),(0,n.kt)("p",null,"Let's start by editing a Study's Analyses."),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Extraction study view",src:a(369).Z,width:"2128",height:"923"})),(0,n.kt)("admonition",{type:"info"},(0,n.kt)("p",{parentName:"admonition"},(0,n.kt)("em",{parentName:"p"},"Analyses"),' are groups of images or coordinates reported in a given study fir a specific analysis. This is often referred to as "Contrasts", but we use the more general term "Analyses" to accommodate a wider range of fMRI models. ')),(0,n.kt)("p",null,"For new studies, we will not have any data, and it is necessary to manually enter these data from the text of a study.\nWe can create a new Analysis for each group of Coordinates, and input the data from the text:"),(0,n.kt)("p",null,"For studies already indexed by NeuroStore, we will already have pre-extracted Coordinates. You can use this same interface to verify and correct these data. "),(0,n.kt)("admonition",{type:"caution"},(0,n.kt)("p",{parentName:"admonition"},"Automatically extracted coordinates can contain a number of errors. Mostly commonly, several distinct Analyses (i.e. contrasts), will get grouped into a single Analyses. You will want to create new Analyses to split up the Coordinates into distinct units. "),(0,n.kt)("p",{parentName:"admonition"},"Another common error is that Analyses are duplicated, meaning you may want to delete extra Analyses. ")),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},"You can copy and paste coordinates from Microsoft Excel or Google Sheets.")),(0,n.kt)("h4",{id:"annotations"},"Annotations"),(0,n.kt)("p",null,"A key goal of the Extraction phase, is to add Annotations that can help us distinguish Analyses, and include/exclude specific Analyses from a meta-analysis. Annotations are simply columns of data with a value for all Analyses within a StudySet."),(0,n.kt)("p",null,"Annotations can be explained as a way to categorize analyses within each study. For example, they can be categorized by task (e.g., Stroop, N-back, etc.), by modality (e.g., fMRI, PET, etc.), or by any other category that you want to use to filter the analyses. "),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},'By default, a single Annotation called "included" is created, which includes all Analyses.\nYou can modify this Annotation to select the relevant Analyses of interest to your research question')),(0,n.kt)("p",null,"For this replication, we are interested in the effects of nAChR agonists on the brain, which can either be excitatory or inhibitory, so we add both an \u201cactivation\u201d and \u201cdeactivation\u201d column. "),(0,n.kt)("p",null,'First create an Annotation. From the main Extraction page, click "View Annotations" on the top right. Here you can view all annotations and the value for each Analyses, as well as create new Annotations. You can choose the data type of each column as either a Number, String, or Boolean. Selected a Boolean data type for the \u201cactivation\u201d and \u201cdeactivation\u201d columns, which will allow you to filter the analyses by whether they are excitatory or inhibitory. By default you will have an \u201cinclude\u201d column to help get you started.'),(0,n.kt)("p",null,'Below, I am creating a new Annotation for "deactivations"'),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"annotation for a study",src:a(8669).Z,width:"920",height:"361"})),(0,n.kt)("p",null,'Now, when I look at a study, I can edit the value for Analyses, assigning each group of coordinates as "activations" or "deactivations":'),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"annotation for a study",src:a(4235).Z,width:"850",height:"128"})),(0,n.kt)("h2",{id:"meta-analysis-specification"},"Meta-analysis specification"),(0,n.kt)("p",null,"You are finally ready to specify a meta-analysis! "),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"start meta-analysis specification",src:a(234).Z,width:"834",height:"308"})),(0,n.kt)("p",null,"After clicking ",(0,n.kt)("strong",{parentName:"p"},'"+ Meta-Analysis Specification"'),", you'll see the following dialog:"),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Meta-analysis wizard",src:a(588).Z,width:"1762",height:"1014"})),(0,n.kt)("p",null,'For each Meta-Analysis, you will select an Annotation to filter the Analyses to include.\nRemember, by default, the "included" column will be created and include ',(0,n.kt)("em",{parentName:"p"},"all")," Analyses. "),(0,n.kt)("p",null,"Next, you will ",(0,n.kt)("strong",{parentName:"p"},"select a meta-analysis Algorithm and Corrector"),":"),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Meta-analysis algorithm",src:a(3556).Z,width:"1762",height:"1014"})),(0,n.kt)("p",null,'A variety of common meta-analysis algorithms such as "ALE" and "MKDA" are available, as well as two\nstrategies for controlling for multiple comparisons: FDR (false detection rate) and FWE (family wise error).'),(0,n.kt)("p",null,'For this example, we\'ll choose "MKDADensity" and and "FDRCorrection". You can modify the parameters for each, if you want,\nbut we provide sane defaults for all. '),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},"Learn more about meta-analysis algorithms in the ",(0,n.kt)("a",{parentName:"p",href:"https://nimare.readthedocs.io/en/stable/index.html"},"NiMARE Documentation"))),(0,n.kt)("p",null,"Next, you'll give your meta-analysis a name, and review the details of your specification. "),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Meta-analysis review",src:a(7832).Z,width:"1771",height:"1575"})),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},"You can define multiple Meta-Analysis specifications in a Project, paired to the same StudySet")),(0,n.kt)("h2",{id:"run-your-meta-analysis"},"Run your meta-analysis!"),(0,n.kt)("p",null,"Congratulations! You now have a Meta-Analysis specification that is ready to run."),(0,n.kt)("p",null,"You can execute your Meta-Analysis for free in the cloud on Google Colab by copying the unique ",(0,n.kt)("em",{parentName:"p"},"meta-analysis id"),"\nand pasting it into our Google Colab notebook."),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Meta-analysis run",src:a(3349).Z,width:"2994",height:"1030"})))}m.isMDXComponent=!0},7555:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/files/tutorial_pmids-434d072c0087956ffdef61013ba6d0da.txt"},369:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/add_coordinates-8bea486d4904648bcafa7ea0aa3ccf05.png"},5362:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/annotate_and_extract_study-ca3e4d3930ebf9dc60ad23185a36eefc.png"},8669:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/annotation_create-0e5cfa697b781e4ac721dc2f05c2b33a.png"},4235:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/annotation_view-bb152fb9777b96fa48ecf95ada750d97.png"},940:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/custom_exclusion-16ad73f8fbab6041651f04bf3deb4f80.png"},6652:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/download_search_results-d5ec087db9b8527d9891715d987540a0.png"},9774:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/extraction_and_annotation-e68cd9d76226936aea72213ff9fb5b8c.png"},8665:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/identification-7f834ceb21aa8027ee29b527ead7700d.png"},3615:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/identification_review-95da15912e8e3b0ecd45612d88ce8ae7.png"},212:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/import_name-47b2b52fb0476898def227448666b9c9.png"},3569:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/import_studies_options-70a63c5afc8073dc692a5361215a7ff4.png"},3556:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/ma_algorithm-76b551077f36af384173d025dd8d39cb.png"},7832:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/ma_review-dca9072320631a4c2b7bd8a3939763bf.png"},3349:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/ma_run-21ff60898e902524975d8fc965d4a08c.png"},588:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/ma_wizard-94f17423e2d4a4df7e23f88cb26c4595.png"},4819:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/new_project_view-865234e6c83825dde8320121d1d9c773.png"},8718:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/prisma_diagram-399aba8441e1b00d3ffb3cdc7b5c6d9c.png"},234:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/proceed_meta_analysis-ccd673905b3f5425823cc947b282bd48.png"}}]); \ No newline at end of file diff --git a/assets/js/2367c334.cf6418de.js b/assets/js/2367c334.cf6418de.js new file mode 100644 index 0000000..ba97a63 --- /dev/null +++ b/assets/js/2367c334.cf6418de.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[7068],{4894:(e,t,a)=>{a.r(t),a.d(t,{assets:()=>d,contentTitle:()=>l,default:()=>m,frontMatter:()=>s,metadata:()=>r,toc:()=>c});var i=a(7462),n=(a(7294),a(3905)),o=a(5154);const s={sidebar_label:"Manual Meta-Analysis",sidebar_position:1},l="Manual Meta-Analysis",r={unversionedId:"tutorial/manual",id:"tutorial/manual",title:"Manual Meta-Analysis",description:"How to create a custom, manual meta-analysis.",source:"@site/docs/tutorial/manual.md",sourceDirName:"tutorial",slug:"/tutorial/manual",permalink:"/compose-docs/tutorial/manual",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/tutorial/manual.md",tags:[],version:"current",lastUpdatedBy:"Alejandro de la Vega",lastUpdatedAt:1729891615,formattedLastUpdatedAt:"Oct 25, 2024",sidebarPosition:1,frontMatter:{sidebar_label:"Manual Meta-Analysis",sidebar_position:1},sidebar:"tutorialSidebar",previous:{title:"Tutorials",permalink:"/compose-docs/tutorial/"},next:{title:"Automated Meta-Analysis",permalink:"/compose-docs/tutorial/automated"}},d={},c=[{value:"Creating a new Project",id:"creating-a-new-project",level:2},{value:"Search & Curate",id:"search--curate",level:2},{value:"Importing studies",id:"importing-studies",level:3},{value:"Searching PubMed",id:"searching-pubmed",level:4},{value:"Identification",id:"identification",level:3},{value:"Screening",id:"screening",level:3},{value:"Eligibility",id:"eligibility",level:3},{value:"Included",id:"included",level:3},{value:"Extract and Annotation",id:"extract-and-annotation",level:2},{value:"Ingestion",id:"ingestion",level:3},{value:"Editing studies",id:"editing-studies",level:3},{value:"Analysis Data",id:"analysis-data",level:4},{value:"Annotations",id:"annotations",level:4},{value:"Meta-analysis specification",id:"meta-analysis-specification",level:2},{value:"Run your meta-analysis!",id:"run-your-meta-analysis",level:2}],u={toc:c},p="wrapper";function m(e){let{components:t,...s}=e;return(0,n.kt)(p,(0,i.Z)({},u,s,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"manual-meta-analysis"},"Manual Meta-Analysis"),(0,n.kt)("p",null,(0,n.kt)("em",{parentName:"p"},"How to create a custom, manual meta-analysis.")),(0,n.kt)("admonition",{type:"info"},(0,n.kt)("p",{parentName:"admonition"},"This is a condensed adaptation of a course taught at OHBM 2023.\nSee the ",(0,n.kt)("a",{parentName:"p",href:"https://neurostuff.github.io/meta-analysis-book/"},"course materials")," for a complete overview.")),(0,n.kt)("p",null,(0,n.kt)("em",{parentName:"p"},"Neurosynth Compose")," provides a streamlined workflow to facilitate study selection and\ndata extraction. You can then easily specify a high-quality manual meta-analysis and execute it in the cloud,\nrapidly generating results that you can inspect and share."),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},"We will perform a slimmed down replication of the following meta-analysis:\n",(0,n.kt)("a",{parentName:"p",href:"https://www.ncbi.nlm.nih.gov/pmc/articles/PMC4494985/"},"Neurobiological impact of nicotinic acetylcholine receptor agonists: An ALE meta-analysis of pharmacological neuroimaging studies"),"."),(0,n.kt)("p",{parentName:"admonition"},"For more guidance on how to choose a topic for meta-analysis, see the ",(0,n.kt)("a",{parentName:"p",href:"https://www.bmj.com/content/372/bmj.n71"},"PRISMA statement")," and the ",(0,n.kt)("a",{parentName:"p",href:"https://www.ncbi.nlm.nih.gov/pmc/articles/PMC5918306/"},"10 simple rules for neuroimaging meta-analyses"),".")),(0,n.kt)("h2",{id:"creating-a-new-project"},"Creating a new Project"),(0,n.kt)("p",null,(0,n.kt)("em",{parentName:"p"},"Projects")," contain all the Steps necessary to create a new meta-analysis in Neurosynth Compose.\nWe'll step through this process in detail."),(0,n.kt)("p",null,"To get started, ",(0,n.kt)("em",{parentName:"p"},"sign in"),", and select ",(0,n.kt)("strong",{parentName:"p"},"New Project"),'.\nThe default name of a new Project is "Untitled", change this to "Replication of: Neurobiological impact of nicotinic acetylcholine receptor agonists".'),(0,n.kt)("p",null,"You'll now see the Project page, showing the three stages of a meta-analysis:\n",(0,n.kt)("strong",{parentName:"p"},"Search & Curate, Extract & Annotate")," and ",(0,n.kt)("strong",{parentName:"p"},"Specify Meta-Analyses"),"."),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"New Project",src:a(4819).Z,width:"1557",height:"501"}),". "),(0,n.kt)("h2",{id:"search--curate"},"Search & Curate"),(0,n.kt)("p",null,"The first step in a meta-analysis is to ",(0,n.kt)("em",{parentName:"p"},"Search")," for studies, and ",(0,n.kt)("em",{parentName:"p"},"Curate")," these studies into a\nfinal ",(0,n.kt)("em",{parentName:"p"},"StudySet")," that contains the studies we want to include in a Meta-Analysis."),(0,n.kt)("p",null,"To get started, we must choose a Curation workflow. There are three options: Simple, PRISMA and Custom. The main difference between these options is the number of review steps involved in creating a final list of studies. ",(0,n.kt)("strong",{parentName:"p"},'For a rigorous Manual Meta-Analysis, select "PRISMA".')),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},"Reviewers typically require Preferred Reporting Items for Systematic Reviews and Meta-Analyses (PRISMA) reporting\nfor gold-standard meta-analyses. The PRISMA guidelines ensure a systematic selection and reporting process.\nHowever, a Simple workflow may be useful for exploratory and automated meta-analyses. ")),(0,n.kt)("p",null,"Next, you will be presented with the Curation board, consisting of four columns representing\nthe steps of a PRISMA workflow:"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("strong",{parentName:"p"},"Identification"),": Remove duplicate studies")),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("strong",{parentName:"p"},"Screening"),": Remove irrelevant studies")),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("strong",{parentName:"p"},"Elibility"),": Remove studies that do not meet inclusion criteria or do not have retrievable information")),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("strong",{parentName:"p"},"Included"),": Double check the studies and view which studies will be included in the meta-analysis"))),(0,n.kt)("p",null,"The overall goal is to go from a large number of studies from a broad search results, to only the\nstudies that are relevant to your research question. These steps should be completed in order!"),(0,n.kt)("h3",{id:"importing-studies"},"Importing studies"),(0,n.kt)("p",null,"But first, we must add studies to our Project. Click the ",(0,n.kt)("strong",{parentName:"p"},"Import Studies")," button on the top right of the screen."),(0,n.kt)("p",null,"You can search for studies within the ",(0,n.kt)("em",{parentName:"p"},"NeuroStore")," database\u2014which we maintain and indexes over 20,000 pre-processed neuroimaging studies\u2014or from external sources, such as PubMed or a Citation manager file. "),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Import Studies",src:a(3569).Z,width:"1543",height:"436"}),". "),(0,n.kt)("p",null,(0,n.kt)("em",{parentName:"p"},"Import via NeuroStore")," is simpler and faster, as these studies already exist on in our system\nand have pre-extracted imaging data (e.g. coordinates).\nAs a result, there will be fewer irrelevant studies to exclude, and less data extraction to complete."),(0,n.kt)("p",null,"However, ",(0,n.kt)("em",{parentName:"p"},"searching other sources")," is often recommended for a comprehensive literature search, as a single source can never index all possible studies."),(0,n.kt)("p",null,"To replicate the Nicotine meta-analysis, we will replicate the author's PubMed search."),(0,n.kt)("admonition",{type:"info"},(0,n.kt)("p",{parentName:"admonition"},"Searching NeuroStore is a valid option for a manual meta-analysis to balance rigor and efficiency. To learn more, see the ",(0,n.kt)("a",{parentName:"p",href:"/compose-docs/tutorial/automated"},"Automated Meta-Analysis tutorial"),". ")),(0,n.kt)("h4",{id:"searching-pubmed"},"Searching PubMed"),(0,n.kt)("p",null,"We can export any PubMed search result to file, and import that file into Neurosynth Compose.\nIn this example, we perform the following search which in the ",(0,n.kt)("a",{parentName:"p",href:"https://pubmed.ncbi.nlm.nih.gov/"},"PubMed")," search field:"),(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre"},'("fMRI" OR "PET" OR "neuroimaging" OR "Functional magnetic resonance imaging" OR "functional MRI") \nAND ("nicotine" OR "cigarette" OR "smok*" OR "DMXB-A")\n')),(0,n.kt)("p",null,"This results in over 3,000 studies that are potentially relevant for this meta-analysis."),(0,n.kt)("p",null,"Next, we save the results to ",(0,n.kt)("inlineCode",{parentName:"p"},"PMID")," format, with a PubMed ID on each line."),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Download PubMed",src:a(6652).Z,width:"1053",height:"475"})),(0,n.kt)("admonition",{type:"info"},(0,n.kt)("p",{parentName:"admonition"},"Reviewing 3,000 studies can take a long time!\nOnly a small percentage of these studies will meet all inclusion criteria. For the sake of the tutorial, we provide a shortened list of ",(0,n.kt)(o.aBF,{size:20,mdxType:"FaDownload"})," ",(0,n.kt)("a",{target:"_blank",href:a(7555).Z},"PUBMED IDS"),".")),(0,n.kt)("p",null,"We can import this file into our Project by clicking ",(0,n.kt)("strong",{parentName:"p"},"Upload File")," or by\ncopy/pasting the IDs into the box. Give this import a name for future reference.\nAll studies imported from this search will be ",(0,n.kt)("strong",{parentName:"p"},"Tagged")," with the search name. "),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Import name",src:a(212).Z,width:"1282",height:"354"})),(0,n.kt)("h3",{id:"identification"},"Identification"),(0,n.kt)("p",null,"All the imported studies are now visible in the first column of our PRISMA curation board. "),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Identification",src:a(8665).Z,width:"3595",height:"939"})),(0,n.kt)("p",null,"The purpose ",(0,n.kt)("strong",{parentName:"p"},"Identification")," is to find ",(0,n.kt)("em",{parentName:"p"},"duplicate studies"),", which is common when importing from multiple sources.\n",(0,n.kt)("em",{parentName:"p"},"Neurosynth Compose")," will automatically find potential duplicates (based on the Title, DOI, and PMID).\nHowever, you can also manually review studies to identify any duplicates we might have missed."),(0,n.kt)("p",null,"To review studies, click on the ",(0,n.kt)("strong",{parentName:"p"},"Identification"),' column header, or an individual study.\nFor each study, you can choose to "Promote" it to the next phase, "Exclude" as a duplicate, or flag for later review.'),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Identification review",src:a(3615).Z,width:"2251",height:"1211"})),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},"To remain PRISMA compliant, you should only exclude studies for being a duplicate in the Identification step.")),(0,n.kt)("p",null,"In this example, there are no duplicates. To quickly advance, click ",(0,n.kt)("strong",{parentName:"p"},"Promote All Uncategorized Studies")," under ",(0,n.kt)("em",{parentName:"p"},"Identification"),"."),(0,n.kt)("h3",{id:"screening"},"Screening"),(0,n.kt)("p",null,"The goal of ",(0,n.kt)("em",{parentName:"p"},"Screening")," is to determine if imported studies are relevant to your research question, based on the the Tile\nand Abstract of each."),(0,n.kt)("p",null,"To begin, click on the Screening column header from the main Curation board. The interface is\nidentical to the previous phase, except the default Exclusion reason is now ",(0,n.kt)("strong",{parentName:"p"},"irrelevant"),". "),(0,n.kt)("p",null,"Go ahead and review all 13 studies to determine if they are relevant to the topic of ",(0,n.kt)("em",{parentName:"p"},'"Nicotine administration'),'".\nAny studies that are not relevant will remain in this column and not advance.'),(0,n.kt)("h3",{id:"eligibility"},"Eligibility"),(0,n.kt)("p",null,"The goal ",(0,n.kt)("em",{parentName:"p"},"Eligibility")," is to determine studies meet the eligibility criteria of your meta-analysis.\nYou will need to read the ",(0,n.kt)("strong",{parentName:"p"},"full text")," to make this determination. "),(0,n.kt)("admonition",{type:"note"},(0,n.kt)("p",{parentName:"admonition"},"The eligibility criteria depends on your research question!\nThis is where your expertise is most necessary, in order to create an interesting research question,\nand filter studies accordingly. The results of this step depends on the researcher, and there may be reasonable scientific disagreements.")),(0,n.kt)("p",null,'To begin, click on the "Eligibility" column header, or a study, as before.'),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Custom Eligibility",src:a(940).Z,width:"2341",height:"1449"})),(0,n.kt)("p",null,"For this example, we will include studies that meet these criteria:"),(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre"},"* fMRI or PET\n* Reported brain activity in stereotaxic coordinates (Talairach or MNI space)\n* Reported a set of coordinates (i.e., foci) from a within-subjects or between-subjects contrast assessing the effects of nAChR agonist administration (i.e., pharmacological administration or cigarette smoking) relative to a baseline condition (i.e., placebo administration or smoking-abstinence condition)\n* Examined brain activity using a cognitive or affective task paradigm or at rest. \n* Studies examining functional connectivity, brain morphology, or neurochemistry are excluded.\n")),(0,n.kt)("p",null,"For this tutorial, go ahead and review all studies in this column, and Promote relevant studies to the next phase."),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},"Given that this phase is more open-ended, there is no default Exclusion reason. We provide four default options for you, and\nyou may define custom Exclusion reasons if you see fit.")),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},'For open source studies, we will link to the article full text (PDF). If not available, click\n"view article link" to view article\'s PubMed page, and access the full text using your credentials.')),(0,n.kt)("h3",{id:"included"},"Included"),(0,n.kt)("p",null,"Congratulations! Once you have reviewed all studies, you should have a set of studies that you want to include in your meta-analysis. "),(0,n.kt)("p",null,"At this point, you can review this final list, and view a PRISMA diagram visually outlining your review process:"),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"PRISMA",src:a(8718).Z,width:"1714",height:"1448"})),(0,n.kt)("p",null,"To finish ",(0,n.kt)("em",{parentName:"p"},"Curation"),", and create a final StudySet, click ",(0,n.kt)("em",{parentName:"p"},"Move on to Extraction")," at the top right. "),(0,n.kt)("h2",{id:"extract-and-annotation"},"Extract and Annotation"),(0,n.kt)("p",null,"The goal of this phase is to ",(0,n.kt)("strong",{parentName:"p"},"extract data")," from the text of studies (such as coordinates)\nthat will be used in the meta-analysis. You will also want to ",(0,n.kt)("strong",{parentName:"p"},"annotate")," relevant Study meta-data.\nMost commonly, for each Study you will designate which Analyses (i.e. Contrasts) to included in your meta-analysis."),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},"Studies that are already indexed by NeuroStore will have automatically extracted data (such as coordinates)\nsaving you a lot of time and effort. However, you may want to verify and improve this information.")),(0,n.kt)("h3",{id:"ingestion"},"Ingestion"),(0,n.kt)("p",null,"But first, we must create a StudySet containing your studies! "),(0,n.kt)("p",null,"New studies not in the NeuroStore database will be created, and studies that match existing studies will be added to a newly created StudySet."),(0,n.kt)("admonition",{type:"info"},(0,n.kt)("p",{parentName:"admonition"},"Studies in NeuroStore have multiple Versions, including those created by other users, as well as the original copy."),(0,n.kt)("p",{parentName:"admonition"},"If you ingest a study that is already indexed in the database, we will match to the newest possible Version, by default.\nIdeally, this will be a Version that another user has already improved, saving you even more time!"),(0,n.kt)("p",{parentName:"admonition"},"You can switch Study Versions at anytime (including to the original automate copy) by clicking ",(0,n.kt)("em",{parentName:"p"},"Switch Study Version")," at the bottom\nof Study's page. Any edits you make will automatically be saved as a new Version.")),(0,n.kt)("h3",{id:"editing-studies"},"Editing studies"),(0,n.kt)("p",null,"Once your StudySet is created, it's time to edit studies. You will see a list of your studies:"),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Extraction",src:a(9774).Z,width:"1540",height:"880"})),(0,n.kt)("p",null,"Click on any Study to edit:"),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Extraction study view",src:a(5362).Z,width:"2418",height:"856"})),(0,n.kt)("h4",{id:"analysis-data"},"Analysis Data"),(0,n.kt)("p",null,"Let's start by editing a Study's Analyses."),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Extraction study view",src:a(369).Z,width:"2128",height:"923"})),(0,n.kt)("admonition",{type:"info"},(0,n.kt)("p",{parentName:"admonition"},(0,n.kt)("em",{parentName:"p"},"Analyses"),' are groups of images or coordinates reported in a given study fir a specific analysis. This is often referred to as "Contrasts", but we use the more general term "Analyses" to accommodate a wider range of fMRI models. ')),(0,n.kt)("p",null,"For new studies, we will not have any data, and it is necessary to manually enter these data from the text of a study.\nWe can create a new Analysis for each group of Coordinates, and input the data from the text:"),(0,n.kt)("p",null,"For studies already indexed by NeuroStore, we will already have pre-extracted Coordinates. You can use this same interface to verify and correct these data. "),(0,n.kt)("admonition",{type:"caution"},(0,n.kt)("p",{parentName:"admonition"},"Automatically extracted coordinates can contain a number of errors. Mostly commonly, several distinct Analyses (i.e. contrasts), will get grouped into a single Analyses. You will want to create new Analyses to split up the Coordinates into distinct units. "),(0,n.kt)("p",{parentName:"admonition"},"Another common error is that Analyses are duplicated, meaning you may want to delete extra Analyses. ")),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},"You can copy and paste coordinates from Microsoft Excel or Google Sheets.")),(0,n.kt)("h4",{id:"annotations"},"Annotations"),(0,n.kt)("p",null,"A key goal of the Extraction phase, is to add Annotations that can help us distinguish Analyses, and include/exclude specific Analyses from a meta-analysis. Annotations are simply columns of data with a value for all Analyses within a StudySet."),(0,n.kt)("p",null,"Annotations can be explained as a way to categorize analyses within each study. For example, they can be categorized by task (e.g., Stroop, N-back, etc.), by modality (e.g., fMRI, PET, etc.), or by any other category that you want to use to filter the analyses. "),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},'By default, a single Annotation called "included" is created, which includes all Analyses.\nYou can modify this Annotation to select the relevant Analyses of interest to your research question')),(0,n.kt)("p",null,"For this replication, we are interested in the effects of nAChR agonists on the brain, which can either be excitatory or inhibitory, so we add both an \u201cactivation\u201d and \u201cdeactivation\u201d column. "),(0,n.kt)("p",null,'First create an Annotation. From the main Extraction page, click "View Annotations" on the top right. Here you can view all annotations and the value for each Analyses, as well as create new Annotations. You can choose the data type of each column as either a Number, String, or Boolean. Selected a Boolean data type for the \u201cactivation\u201d and \u201cdeactivation\u201d columns, which will allow you to filter the analyses by whether they are excitatory or inhibitory. By default you will have an \u201cinclude\u201d column to help get you started.'),(0,n.kt)("p",null,'Below, I am creating a new Annotation for "deactivations"'),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"annotation for a study",src:a(8669).Z,width:"920",height:"361"})),(0,n.kt)("p",null,'Now, when I look at a study, I can edit the value for Analyses, assigning each group of coordinates as "activations" or "deactivations":'),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"annotation for a study",src:a(4235).Z,width:"850",height:"128"})),(0,n.kt)("h2",{id:"meta-analysis-specification"},"Meta-analysis specification"),(0,n.kt)("p",null,"You are finally ready to specify a meta-analysis! "),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"start meta-analysis specification",src:a(234).Z,width:"834",height:"308"})),(0,n.kt)("p",null,"After clicking ",(0,n.kt)("strong",{parentName:"p"},'"+ Meta-Analysis Specification"'),", you'll see the following dialog:"),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Meta-analysis wizard",src:a(588).Z,width:"1762",height:"1014"})),(0,n.kt)("p",null,'For each Meta-Analysis, you will select an Annotation to filter the Analyses to include.\nRemember, by default, the "included" column will be created and include ',(0,n.kt)("em",{parentName:"p"},"all")," Analyses. "),(0,n.kt)("p",null,"Next, you will ",(0,n.kt)("strong",{parentName:"p"},"select a meta-analysis Algorithm and Corrector"),":"),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Meta-analysis algorithm",src:a(3556).Z,width:"1762",height:"1014"})),(0,n.kt)("p",null,'A variety of common meta-analysis algorithms such as "ALE" and "MKDA" are available, as well as two\nstrategies for controlling for multiple comparisons: FDR (false detection rate) and FWE (family wise error).'),(0,n.kt)("p",null,'For this example, we\'ll choose "MKDADensity" and and "FDRCorrection". You can modify the parameters for each, if you want,\nbut we provide sane defaults for all. '),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},"Learn more about meta-analysis algorithms in the ",(0,n.kt)("a",{parentName:"p",href:"https://nimare.readthedocs.io/en/stable/index.html"},"NiMARE Documentation"))),(0,n.kt)("p",null,"Next, you'll give your meta-analysis a name, and review the details of your specification. "),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Meta-analysis review",src:a(7832).Z,width:"1771",height:"1575"})),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},"You can define multiple Meta-Analysis specifications in a Project, paired to the same StudySet")),(0,n.kt)("h2",{id:"run-your-meta-analysis"},"Run your meta-analysis!"),(0,n.kt)("p",null,"Congratulations! You now have a Meta-Analysis specification that is ready to run."),(0,n.kt)("p",null,"You can execute your Meta-Analysis for free in the cloud on Google Colab by copying the unique ",(0,n.kt)("em",{parentName:"p"},"meta-analysis id"),"\nand pasting it into our Google Colab notebook."),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Meta-analysis run",src:a(3349).Z,width:"2994",height:"1030"})))}m.isMDXComponent=!0},7555:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/files/tutorial_pmids-434d072c0087956ffdef61013ba6d0da.txt"},369:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/add_coordinates-8bea486d4904648bcafa7ea0aa3ccf05.png"},5362:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/annotate_and_extract_study-ca3e4d3930ebf9dc60ad23185a36eefc.png"},8669:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/annotation_create-0e5cfa697b781e4ac721dc2f05c2b33a.png"},4235:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/annotation_view-bb152fb9777b96fa48ecf95ada750d97.png"},940:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/custom_exclusion-16ad73f8fbab6041651f04bf3deb4f80.png"},6652:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/download_search_results-d5ec087db9b8527d9891715d987540a0.png"},9774:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/extraction_and_annotation-e68cd9d76226936aea72213ff9fb5b8c.png"},8665:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/identification-7f834ceb21aa8027ee29b527ead7700d.png"},3615:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/identification_review-95da15912e8e3b0ecd45612d88ce8ae7.png"},212:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/import_name-47b2b52fb0476898def227448666b9c9.png"},3569:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/import_studies_options-70a63c5afc8073dc692a5361215a7ff4.png"},3556:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/ma_algorithm-76b551077f36af384173d025dd8d39cb.png"},7832:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/ma_review-dca9072320631a4c2b7bd8a3939763bf.png"},3349:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/ma_run-21ff60898e902524975d8fc965d4a08c.png"},588:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/ma_wizard-94f17423e2d4a4df7e23f88cb26c4595.png"},4819:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/new_project_view-865234e6c83825dde8320121d1d9c773.png"},8718:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/prisma_diagram-399aba8441e1b00d3ffb3cdc7b5c6d9c.png"},234:(e,t,a)=>{a.d(t,{Z:()=>i});const i=a.p+"assets/images/proceed_meta_analysis-ccd673905b3f5425823cc947b282bd48.png"}}]); \ No newline at end of file diff --git a/assets/js/4c0219fe.0186eafc.js b/assets/js/4c0219fe.0186eafc.js new file mode 100644 index 0000000..4bbbdbb --- /dev/null +++ b/assets/js/4c0219fe.0186eafc.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[3730],{5267:(e,t,a)=>{a.r(t),a.d(t,{assets:()=>c,contentTitle:()=>r,default:()=>h,frontMatter:()=>o,metadata:()=>l,toc:()=>d});var n=a(7462),i=(a(7294),a(3905)),s=a(6464);const o={sidebar_label:"MKDA Chi-Squared Association",sidebar_position:3},r="MKDA Chi-Squared and large-scale association tests",l={unversionedId:"tutorial/advanced/mkda_association",id:"tutorial/advanced/mkda_association",title:"MKDA Chi-Squared and large-scale association tests",description:"How to perform large-scale association tests using MKDA Chi-Squared Meta-Analysis, with a Social Processing example",source:"@site/docs/tutorial/advanced/mkda_association.md",sourceDirName:"tutorial/advanced",slug:"/tutorial/advanced/mkda_association",permalink:"/compose-docs/tutorial/advanced/mkda_association",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/tutorial/advanced/mkda_association.md",tags:[],version:"current",lastUpdatedBy:"Alejandro de la Vega",lastUpdatedAt:1729891615,formattedLastUpdatedAt:"Oct 25, 2024",sidebarPosition:3,frontMatter:{sidebar_label:"MKDA Chi-Squared Association",sidebar_position:3},sidebar:"tutorialSidebar",previous:{title:"Advanced tutorials",permalink:"/compose-docs/tutorial/advanced/"}},c={},d=[{value:"The Reverse Inference Problem",id:"the-reverse-inference-problem",level:2},{value:"MKDA Chi-Squared",id:"mkda-chi-squared",level:2},{value:"How to run MKDA Chi-Squared on Neurosynth Compose",id:"how-to-run-mkda-chi-squared-on-neurosynth-compose",level:2},{value:"Specification",id:"specification",level:3},{value:"Executing your analysis",id:"executing-your-analysis",level:3},{value:"Interpreting results",id:"interpreting-results",level:2},{value:"Example: Pintos Lobo (2022) - All Social Processing Tasks",id:"example-pintos-lobo-2022---all-social-processing-tasks",level:2},{value:"Results",id:"results",level:3},{value:"Footnotes & Limitations",id:"footnotes--limitations",level:2},{value:"References & Further Reading",id:"references--further-reading",level:2}],p={toc:d},m="wrapper";function h(e){let{components:t,...o}=e;return(0,i.kt)(m,(0,n.Z)({},p,o,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"mkda-chi-squared-and-large-scale-association-tests"},"MKDA Chi-Squared and large-scale association tests"),(0,i.kt)("p",null,(0,i.kt)("em",{parentName:"p"},"How to perform large-scale association tests using MKDA Chi-Squared Meta-Analysis, with a Social Processing example")),(0,i.kt)("h2",{id:"the-reverse-inference-problem"},"The Reverse Inference Problem"),(0,i.kt)("p",null,"A common goal of neuroimaging meta-analysis, is to pool a set of studies that invoke common psychological constructs to identify where brain activity is consistently activated."),(0,i.kt)("p",null,"Although this is a useful approach, there is a significant inferential challenge-- namely, determining how ",(0,i.kt)("em",{parentName:"p"},"specific")," the relationship between activity in a given region and the cognitive state invoked by the target task. Ideally, we would like to infer the probability of a mental state given activity in a given region. However, this is exceedingly difficult due to the well-established problem of ",(0,i.kt)("em",{parentName:"p"},"reverse inference")," (Poldrack, 2011). "),(0,i.kt)("p",null,"Even if we establish that a given task (e.g. working memory) activates a region 100% of the time (e.g. lateral prefrontal cortex), this observation only establishes that working memory engagement is a sufficient condition for LPFC activity, but ",(0,i.kt)("em",{parentName:"p"},"not")," that LPFC activity indicates working memory engagement (Poldrack & Yarkoni, 2015). In practice, we know that brain regions are activated by a variety of cognitive processes, and that certain regions of the brain- such as the insula, lateral PFC and medial frontal cingulate cotex (MFCC)- have a high base rate of activation, making it difficult to establish specificity. Using the Neurosynth database (15,000+ studies), we can map the probability of activation of all voxels. Across this large and diverse dataset, certain voxels in MFCC and insula are activate in as many as 20% of studies. "),(0,i.kt)("p",null,(0,i.kt)("img",{alt:"Prob-A",src:a(9569).Z,width:"1000",height:"180"}),"\n",(0,i.kt)("em",{parentName:"p"},"Probability of Activity for all Voxels across the Neurosynth Dataset")),(0,i.kt)("p",null,"The reverse inference problem is a challenge even for rigorous, high-quality meta-analyses. For example, a recent meta-analysis of RDoC social constructs across 864 fMRI contrasts, ",(0,i.kt)("a",{parentName:"p",href:"https://pubmed.ncbi.nlm.nih.gov/36436737/"},"Pintos Lobo et al., (2022)"),' found converging activation across a variety of regions for "All Social Processing Tasks", including mPFC, ACC, PCC, TPJ, bilateral insula, amygdala, fusiform gyrus, precuneus, and thalamus. However, some of the regions have a high base rate of activation, making it difficult to know how strongly associated their activity is with social processing.'),(0,i.kt)("p",null,(0,i.kt)("img",{alt:"Lobos Pinto",src:a(9377).Z,width:"517",height:"135"})),(0,i.kt)("p",null,(0,i.kt)("em",{parentName:"p"},"Fig 5a (condensed) from Pintos Lobo et al., (2022). Convergent Activation Patterns Across all social processing tasks (864 contrasts, 1,109 total annotations). ")),(0,i.kt)("p",null,"Although reverse inference poses a serious challenge, there are certain questions we can ask using large-scale meta-analytic databases that can help. Specifically: ",(0,i.kt)("strong",{parentName:"p"},"does activity occur ",(0,i.kt)("em",{parentName:"strong"},"more consistently")," for studies that elicit by the mental construct of interest (in this case, social processing) than studies that ",(0,i.kt)("em",{parentName:"strong"},"do not")," elicit that construct")," Large-scale meta-analytic datasets can serve as a useful reference, as they consists of tens of thousands of diverse neuroimaging studies automatically sampled from the literature."),(0,i.kt)("h2",{id:"mkda-chi-squared"},"MKDA Chi-Squared"),(0,i.kt)("p",null,"We can answer this question using a ",(0,i.kt)("inlineCode",{parentName:"p"},"Multilevel kernel density (MKDA) analysis - Chi-square")," analysis, originally introduced in ",(0,i.kt)("a",{parentName:"p",href:"https://doi.org/10.1093/scan/nsm015"},"Wager et al.,"),". For every voxel, we test if a greater proportion of studies in our meta-analysis activate a given voxel than in a large set of studies that ",(0,i.kt)("em",{parentName:"p"},"we did not select")," for our inclusion criteria. "),(0,i.kt)("p",null,"Conceptually, this tests if there's evidence of a ",(0,i.kt)("em",{parentName:"p"},"population level")," association between the task or psychological construct in our meta-analysis and brain activation (for every voxel). It is equivalent to conducting a chi-squared test of independence for a 2-by-2 table of counts for each voxel, where the binary variables are foci occurrence in the meta-analysis of interest and foci occurrence in the reference set of unselected studies."),(0,i.kt)("h2",{id:"how-to-run-mkda-chi-squared-on-neurosynth-compose"},"How to run MKDA Chi-Squared on Neurosynth Compose"),(0,i.kt)("h3",{id:"specification"},"Specification"),(0,i.kt)("p",null,"Specifying an MKDA Chi-Square meta-analysis in Neurosynth is easy. Simply, select a target set of Analyses to include from your StudySet as you would for any other meta-analysis. "),(0,i.kt)("p",null,'In Step 3 ("Create Meta-Analysis Specification") of your Project, select ',(0,i.kt)("em",{parentName:"p"},"MKDAChi2")," as the ",(0,i.kt)("em",{parentName:"p"},"algorithm"),". "),(0,i.kt)("p",null,(0,i.kt)("img",{alt:"MKDA Chi Squared",src:a(541).Z,width:"1169",height:"408"})),(0,i.kt)("admonition",{type:"note"},(0,i.kt)("p",{parentName:"admonition"},"By default, the ",(0,i.kt)("inlineCode",{parentName:"p"},"FDRCorrector")," is selected, which will perform cluster correction using False Detection Rate with an ",(0,i.kt)("em",{parentName:"p"},"alpha")," of 0.05.\nThis is a fast algorithm, however, it is recommended to use ",(0,i.kt)("inlineCode",{parentName:"p"},"FWECorrector")," (family-wise-error) with the ",(0,i.kt)("inlineCode",{parentName:"p"},"montecarlo")," method for more accurate, publication-quality results.")),(0,i.kt)("p",null,'Next, select the annotation inclusion column you want to use, as before (by default, the "included" column will be used).'),(0,i.kt)("p",null,"Now, select a reference dataset from the dropdown list below. The Neurosynth dataset represents the latest release of the legacy ",(0,i.kt)("em",{parentName:"p"},"Neurosynth")," dataset (version 7), released July, 2018. The ",(0,i.kt)("em",{parentName:"p"},"Neurostore"),' dataset represents the latest update of our continuously updating "live" dataset, spanning over 20,000 neuroimaging studies. '),(0,i.kt)("p",null,(0,i.kt)("img",{alt:"MKDA Chi Squared Reference",src:a(6344).Z,width:"1136",height:"243"})),(0,i.kt)("p",null,"Now simply complete the rest of the meta-analysis specification wizard to finish. "),(0,i.kt)("h3",{id:"executing-your-analysis"},"Executing your analysis"),(0,i.kt)("p",null,"As usual, you can execute your meta-analysis using Google Colab or on a local computational resource using Docker. "),(0,i.kt)("admonition",{type:"tip"},(0,i.kt)("p",{parentName:"admonition"},"The ",(0,i.kt)("inlineCode",{parentName:"p"},"MKDAChi2")," algorithm takes between ~30s-2minutes to run. However, the ",(0,i.kt)("inlineCode",{parentName:"p"},"FWECorrector")," with 5,000+ montecarlo iterations can take several hours to complete.\nWe recommend using a workstation or HPC and specifying ",(0,i.kt)("inlineCode",{parentName:"p"},"--n-cores")," at run-time.")),(0,i.kt)("h2",{id:"interpreting-results"},"Interpreting results"),(0,i.kt)("p",null,"The ",(0,i.kt)("em",{parentName:"p"},"MKDA Chi-Squared")," Workflow outputs two key maps: ",(0,i.kt)("strong",{parentName:"p"},"uniformity")," and ",(0,i.kt)("strong",{parentName:"p"},"association")," test maps."),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("strong",{parentName:"li"},"Uniformity test map:")," z-scores from a one-way ANOVA testing whether the proportion of studies that report activation at a given voxel differs from the rate that would be expected if activations were uniformly distributed throughout gray matter.")),(0,i.kt)("p",null,'The uniformity test map can be interpreted in roughly the same way as most standard whole-brain fMRI analysis: it displays the degree to which each voxel is consistently activated in studies that use a given term. For instance, for a meta-analysis of "emotion" high z-scores in the amygdala implies that studies that use the word emotion a lot tend to consistently report activation in the amygdala--at least, more consistently than one would expect if activation were uniformly distributed throughout gray matter. '),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("strong",{parentName:"li"},"Association test map"),": z-scores from a two-way ANOVA testing for the presence of a non-zero association between term use and voxel activation.")),(0,i.kt)("p",null,"The association test maps tell you whether activation in a region ",(0,i.kt)("strong",{parentName:"p"},"XXX")," occurs more consistently for studies in your meta-analytic sample ",(0,i.kt)("strong",{parentName:"p"},"m")," than for other studies in the reference dataset. In other words, a large positive z-score implies that studies in a meta-analysis are more likely to report ",(0,i.kt)("strong",{parentName:"p"},"XXX")," activation than studies whose abstracts don't include the word 'emotion'. "),(0,i.kt)("p",null,"Note that association maps ",(0,i.kt)("em",{parentName:"p"},"do not")," tell you what the probability of a given psychological concept or task is. High Z-scores do not imply that a certain region or voxel is ",(0,i.kt)("em",{parentName:"p"},"selective")," for a given concept or task. Instead, it just means there is evidence that there is at least a non-zero difference between reference studies, and studies in the meta-analysis."),(0,i.kt)("admonition",{type:"note"},(0,i.kt)("p",{parentName:"admonition"},(0,i.kt)("em",{parentName:"p"},"NiMARE")," outputs a variety of maps, including cluster-corrected and uncorrected versions of all maps. "),(0,i.kt)("p",{parentName:"admonition"},"See the documentation sections on ",(0,i.kt)("a",{parentName:"p",href:"https://nimare.readthedocs.io/en/stable/outputs.html"},"Outputs of NIMARE")," and ",(0,i.kt)("a",{parentName:"p",href:"https://nimare.readthedocs.io/en/stable/cbma.html#the-monte-carlo-multiple-comparisons-correction-method"},"Monte Carlo multiple comparisons")," for more details.")),(0,i.kt)("h2",{id:"example-pintos-lobo-2022---all-social-processing-tasks"},"Example: Pintos Lobo (2022) - All Social Processing Tasks"),(0,i.kt)("p",null,"To demonstrate, we used Neurosynth-Compose to replicate the ",(0,i.kt)("a",{parentName:"p",href:"https://pubmed.ncbi.nlm.nih.gov/36436737/"},"Pintos Lobo et al., (2022)")," meta-analysis for All Social Processing Tasks. For this example, we have already created a ",(0,i.kt)("inlineCode",{parentName:"p"},"Project")," and ",(0,i.kt)("inlineCode",{parentName:"p"},"StudySet")," with the coordinates used in this meta-analysis."),(0,i.kt)("p",null,"We then specified a ",(0,i.kt)("inlineCode",{parentName:"p"},"MKDAChi2")," Meta-Analysis with ",(0,i.kt)("inlineCode",{parentName:"p"},"FWECorrector")," with the ",(0,i.kt)("inlineCode",{parentName:"p"},"montecarlo")," method with 5,000 iterations. "),(0,i.kt)(s.Z,{variant:"contained",color:"primary",href:"https://compose.neurosynth.org/projects/4x4NsrWg8heS/meta-analyses/7K9BVG9hJQRu",mdxType:"Button"},"Meta-Analysis Specification and Results on Neurosynth Compose"),(0,i.kt)("h3",{id:"results"},"Results"),(0,i.kt)("p",null,"First, let's look at the FWE cluster corrected ",(0,i.kt)("strong",{parentName:"p"},"uniformity test")," map."),(0,i.kt)("p",null,(0,i.kt)("inlineCode",{parentName:"p"},"z_desc-uniformityMass_level-cluster_corr-FWE_method-montecarlo"),"\n",(0,i.kt)("img",{alt:"Uniformity",src:a(4568).Z,width:"950",height:"180"})),(0,i.kt)("p",null,"In this analysis, we replicate the findings of Pinto Lobos (2022), showing consistent activation for social processing across a variety of regions."),(0,i.kt)("p",null,"Next, let's look at the FWE cluster corrected ",(0,i.kt)("strong",{parentName:"p"},"association map"),":"),(0,i.kt)("p",null,(0,i.kt)("inlineCode",{parentName:"p"},"z_desc-associationMass_level-cluster_corr-FWE_method-montecarlo"),"\n",(0,i.kt)("img",{alt:"Association",src:a(2167).Z,width:"950",height:"180"})),(0,i.kt)("p",null,"As before, regions which have been previously implicated with social processing, such as the tempo-parietal junction (TPJ), and dorso-medial and ventro-medial PFC are present, meaning that activity in these social processing studies report activity in these regions with greater frequency than other studies in the Neurosynth database."),(0,i.kt)("p",null,"However, certain regions which we know to have low specificity, such as the insula, medial frontal cingulate cortex (MFCC) and parts of dorso-lateral PFC, are absent, meaning that there is ",(0,i.kt)("em",{parentName:"p"},"no evidence")," that social processing tasks report activity in these regions ",(0,i.kt)("em",{parentName:"p"},"more frequently")," than other studies in the database."),(0,i.kt)("p",null,"This example demonstrates how ",(0,i.kt)("inlineCode",{parentName:"p"},"MKDA Chi-Squared")," association analysis can help determine the specificity activity and tasks in a meta-analysis, even for high-quality manual meta-analyses."),(0,i.kt)("h2",{id:"footnotes--limitations"},"Footnotes & Limitations"),(0,i.kt)("p",null,(0,i.kt)("strong",{parentName:"p"},'What happened to the "forward inference" and "reverse inference" maps?')),(0,i.kt)("p",null,'We renamed the pre-generated forward and reverse inference maps; they\'re now referred to as the "uniformity test" and "association test" maps that we discuss here.'),(0,i.kt)("p",null,"Although the method we used hasn't changed (",(0,i.kt)("inlineCode",{parentName:"p"},"MKDA Chi-Squared"),"), the latter names more accurately capture what these maps actually mean. It was a mistake on our part to have used the forward and reverse inference labels; those labels should properly be reserved for posterior probability maps generated via a Bayesian estimation analysis, rather than for z-scores resulting from a frequentist inferential test of association. Probability maps are more difficult to interpret and use correctly, as they depend on the ",(0,i.kt)("em",{parentName:"p"},"prior")," assumed by the researcher. Since setting an appropriate prior is highly non-trivial, these maps are disabled by default."),(0,i.kt)("p",null,(0,i.kt)("strong",{parentName:"p"}," Using MKDA Chi Squared on manual meta-analyses ")),(0,i.kt)("p",null,"In this tutorial, we applied ",(0,i.kt)("inlineCode",{parentName:"p"},"MKDA Chi-Squared"),' to a manual meta-analysis. However, this is not a perfect comparison, as there are differences between the reference sample (Neurosynth), the high-quality manual annotations given as input. Studies in large-scale meta-analytic databases are automatically populated, meaning there are potential sampling biases. Most notably, studies in Neurosynth include all reported coordinates, not only "target" analyses/contrasts. Thus, it is possible that low-level task > no task contrasts are over-represented in this reference sample. '),(0,i.kt)("h2",{id:"references--further-reading"},"References & Further Reading"),(0,i.kt)("p",null,"If you want to understand the nuances of what inferences you can and cannot make using these maps, we recommend reading Tal Yarkoni's blog posts on how these maps do not provide evidence that the dACC is select for pain: ",(0,i.kt)("a",{parentName:"p",href:"https://www.talyarkoni.org/blog/2015/12/05/no-the-dorsal-anterior-cingulate-is-not-selective-for-pain-comment-on-lieberman-and-eisenberger-2015/"},"Post 1"),", ",(0,i.kt)("a",{parentName:"p",href:"https://www.talyarkoni.org/blog/2015/12/14/still-not-selective-comment-on-comment-on-comment-on-lieberman-eisenberger-2015/"},"Post 2"),", as well as a commentary by ",(0,i.kt)("a",{parentName:"p",href:"https://www.pnas.org/doi/10.1073/pnas.1600282113"},"Tor Wager et al., 2016")),(0,i.kt)("p",null,"Poldrack RA. Inferring mental states from neuroimaging data: from reverse inference to large-scale decoding. Neuron. 2011 Dec 8;72(5):692-7. doi: 10.1016/j.neuron.2011.11.001. PMID: 22153367; PMCID: PMC3240863."),(0,i.kt)("p",null,"Poldrack RA, Yarkoni T. From Brain Maps to Cognitive Ontologies: Informatics and the Search for Mental Structure. Annu Rev Psychol. 2016;67:587-612. doi: 10.1146/annurev-psych-122414-033729. Epub 2015 Sep 21. PMID: 26393866; PMCID: PMC4701616."))}h.isMDXComponent=!0},541:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/mkda_chi_squared_algo-ccaec6b8f53a020b314e09162dccf9b7.png"},6344:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/mkda_chi_squared_reference-418d3c236f463dcdd4f007e4a649c1ba.png"},9377:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/pinto_lobos_figa-115dccb8db33fc1a969fa252124b9e96.png"},2167:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/pinto_lobos_z_desc-associationMass_level-cluster_corr-FWE_method-montecarlo.nii.gz-7f5395616d7b1943c618393fca6e4e88.png"},4568:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/pinto_lobos_z_desc-uniformityMass_level-cluster_corr-FWE_method-montecarlo.nii.gz-db297c21a1e3a0c952b683a8d0f07981.png"},9569:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/prob-A_neurosynth-8d7c0db5edbb4d6862b9e503cc30e694.png"}}]); \ No newline at end of file diff --git a/assets/js/4c0219fe.6628a1fc.js b/assets/js/4c0219fe.6628a1fc.js deleted file mode 100644 index 8f372ea..0000000 --- a/assets/js/4c0219fe.6628a1fc.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[3730],{5267:(e,t,a)=>{a.r(t),a.d(t,{assets:()=>c,contentTitle:()=>r,default:()=>h,frontMatter:()=>o,metadata:()=>l,toc:()=>p});var n=a(7462),i=(a(7294),a(3905)),s=a(6464);const o={sidebar_label:"MKDA Chi-Squared Association",sidebar_position:3},r="MKDA Chi-Squared and large-scale association tests",l={unversionedId:"tutorial/advanced/mkda_association",id:"tutorial/advanced/mkda_association",title:"MKDA Chi-Squared and large-scale association tests",description:"How to perform large-scale association tests using MKDA Chi-Squared Meta-Analysis, with a Social Processing example",source:"@site/docs/tutorial/advanced/mkda_association.md",sourceDirName:"tutorial/advanced",slug:"/tutorial/advanced/mkda_association",permalink:"/compose-docs/tutorial/advanced/mkda_association",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/tutorial/advanced/mkda_association.md",tags:[],version:"current",lastUpdatedBy:"James Kent",lastUpdatedAt:1727371503,formattedLastUpdatedAt:"Sep 26, 2024",sidebarPosition:3,frontMatter:{sidebar_label:"MKDA Chi-Squared Association",sidebar_position:3},sidebar:"tutorialSidebar",previous:{title:"Advanced tutorials",permalink:"/compose-docs/tutorial/advanced/"}},c={},p=[{value:"The Reverse Inference Problem",id:"the-reverse-inference-problem",level:2},{value:"MKDA Chi-Squared",id:"mkda-chi-squared",level:2},{value:"How to run MKDA Chi-Squared on Neurosynth Compose",id:"how-to-run-mkda-chi-squared-on-neurosynth-compose",level:2},{value:"Specification",id:"specification",level:3},{value:"Executing your analysis",id:"executing-your-analysis",level:3},{value:"Interpreting results",id:"interpreting-results",level:2},{value:"Example: Pintos Lobo (2022) - All Social Processing Tasks",id:"example-pintos-lobo-2022---all-social-processing-tasks",level:2},{value:"Results",id:"results",level:3},{value:"Footnotes & Limitations",id:"footnotes--limitations",level:2},{value:"References & Further Reading",id:"references--further-reading",level:2}],d={toc:p},m="wrapper";function h(e){let{components:t,...o}=e;return(0,i.kt)(m,(0,n.Z)({},d,o,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"mkda-chi-squared-and-large-scale-association-tests"},"MKDA Chi-Squared and large-scale association tests"),(0,i.kt)("p",null,(0,i.kt)("em",{parentName:"p"},"How to perform large-scale association tests using MKDA Chi-Squared Meta-Analysis, with a Social Processing example")),(0,i.kt)("h2",{id:"the-reverse-inference-problem"},"The Reverse Inference Problem"),(0,i.kt)("p",null,"A common goal of neuroimaging meta-analysis, is to pool a set of studies that invoke common psychological constructs to identify where brain activity is consistently activated."),(0,i.kt)("p",null,"Although this is a useful approach, there is a significant inferential challenge-- namely, determining how ",(0,i.kt)("em",{parentName:"p"},"specific")," the relationship between activity in a given region and the cognitive state invoked by the target task. Ideally, we would like to infer the probability of a mental state given activity in a given region. However, this is exceedingly difficult due to the well-established problem of ",(0,i.kt)("em",{parentName:"p"},"reverse inference")," (Poldrack, 2011). "),(0,i.kt)("p",null,"Even if we establish that a given task (e.g. working memory) activates a region 100% of the time (e.g. lateral prefrontal cortex), this observation only establishes that working memory engagement is a sufficient condition for LPFC activity, but ",(0,i.kt)("em",{parentName:"p"},"not")," that LPFC activity indicates working memory engagement (Poldrack & Yarkoni, 2015). In practice, we know that brain regions are activated by a variety of cognitive processes, and that certain regions of the brain- such as the insula, lateral PFC and medial frontal cingulate cotex (MFCC)- have a high base rate of activation, making it difficult to establish specificity. Using the Neurosynth database (15,000+ studies), we can map the probability of activation of all voxels. Across this large and diverse dataset, certain voxels in MFCC and insula are activate in as many as 20% of studies. "),(0,i.kt)("p",null,(0,i.kt)("img",{alt:"Prob-A",src:a(9569).Z,width:"1000",height:"180"}),"\n",(0,i.kt)("em",{parentName:"p"},"Probability of Activity for all Voxels across the Neurosynth Dataset")),(0,i.kt)("p",null,"The reverse inference problem is a challenge even for rigorous, high-quality meta-analyses. For example, a recent meta-analysis of RDoC social constructs across 864 fMRI contrasts, ",(0,i.kt)("a",{parentName:"p",href:"https://pubmed.ncbi.nlm.nih.gov/36436737/"},"Pintos Lobo et al., (2022)"),' found converging activation across a variety of regions for "All Social Processing Tasks", including mPFC, ACC, PCC, TPJ, bilateral insula, amygdala, fusiform gyrus, precuneus, and thalamus. However, some of the regions have a high base rate of activation, making it difficult to know how strongly associated their activity is with social processing.'),(0,i.kt)("p",null,(0,i.kt)("img",{alt:"Lobos Pinto",src:a(9377).Z,width:"517",height:"135"})),(0,i.kt)("p",null,(0,i.kt)("em",{parentName:"p"},"Fig 5a (condensed) from Pintos Lobo et al., (2022). Convergent Activation Patterns Across all social processing tasks (864 contrasts, 1,109 total annotations). ")),(0,i.kt)("p",null,"Although reverse inference poses a serious challenge, there are certain questions we can ask using large-scale meta-analytic databases that can help. Specifically: ",(0,i.kt)("strong",{parentName:"p"},"does activity occur ",(0,i.kt)("em",{parentName:"strong"},"more consistently")," for studies that elicit by the mental construct of interest (in this case, social processing) than studies that ",(0,i.kt)("em",{parentName:"strong"},"do not")," elicit that construct")," Large-scale meta-analytic datasets can serve as a useful reference, as they consists of tens of thousands of diverse neuroimaging studies automatically sampled from the literature."),(0,i.kt)("h2",{id:"mkda-chi-squared"},"MKDA Chi-Squared"),(0,i.kt)("p",null,"We can answer this question using a ",(0,i.kt)("inlineCode",{parentName:"p"},"Multilevel kernel density (MKDA) analysis - Chi-square")," analysis, originally introduced in ",(0,i.kt)("a",{parentName:"p",href:"https://doi.org/10.1093/scan/nsm015"},"Wager et al.,"),". For every voxel, we test if a greater proportion of studies in our meta-analysis activate a given voxel than in a large set of studies that ",(0,i.kt)("em",{parentName:"p"},"we did not select")," for our inclusion criteria. "),(0,i.kt)("p",null,"Conceptually, this tests if there's evidence of a ",(0,i.kt)("em",{parentName:"p"},"population level")," association between the task or psychological construct in our meta-analysis and brain activation (for every voxel). It is equivalent to conducting a chi-squared test of independence for a 2-by-2 table of counts for each voxel, where the binary variables are foci occurrence in the meta-analysis of interest and foci occurrence in the reference set of unselected studies."),(0,i.kt)("h2",{id:"how-to-run-mkda-chi-squared-on-neurosynth-compose"},"How to run MKDA Chi-Squared on Neurosynth Compose"),(0,i.kt)("h3",{id:"specification"},"Specification"),(0,i.kt)("p",null,"Specifying an MKDA Chi-Square meta-analysis in Neurosynth is easy. Simply, select a target set of Analyses to include from your StudySet as you would for any other meta-analysis. "),(0,i.kt)("p",null,'In Step 3 ("Create Meta-Analysis Specification") of your Project, select ',(0,i.kt)("em",{parentName:"p"},"MKDAChi2")," as the ",(0,i.kt)("em",{parentName:"p"},"algorithm"),". "),(0,i.kt)("p",null,(0,i.kt)("img",{alt:"MKDA Chi Squared",src:a(541).Z,width:"1169",height:"408"})),(0,i.kt)("admonition",{type:"note"},(0,i.kt)("p",{parentName:"admonition"},"By default, the ",(0,i.kt)("inlineCode",{parentName:"p"},"FDRCorrector")," is selected, which will perform cluster correction using False Detection Rate with an ",(0,i.kt)("em",{parentName:"p"},"alpha")," of 0.05.\nThis is a fast algorithm, however, it is recommended to use ",(0,i.kt)("inlineCode",{parentName:"p"},"FWECorrector")," (family-wise-error) with the ",(0,i.kt)("inlineCode",{parentName:"p"},"montecarlo")," method for more accurate, publication-quality results.")),(0,i.kt)("p",null,'Next, select the annotation inclusion column you want to use, as before (by default, the "included" column will be used).'),(0,i.kt)("p",null,"Now, select a reference dataset from the dropdown list below. The Neurosynth dataset represents the latest release of the legacy ",(0,i.kt)("em",{parentName:"p"},"Neurosynth")," dataset (version 7), released July, 2018. The ",(0,i.kt)("em",{parentName:"p"},"Neurostore"),' dataset represents the latest update of our continuously updating "live" dataset, spanning over 20,000 neuroimaging studies. '),(0,i.kt)("p",null,(0,i.kt)("img",{alt:"MKDA Chi Squared Reference",src:a(6344).Z,width:"1136",height:"243"})),(0,i.kt)("p",null,"Now simply complete the rest of the meta-analysis specification wizard to finish. "),(0,i.kt)("h3",{id:"executing-your-analysis"},"Executing your analysis"),(0,i.kt)("p",null,"As usual, you can execute your meta-analysis using Google Colab or on a local computational resource using Docker. "),(0,i.kt)("admonition",{type:"tip"},(0,i.kt)("p",{parentName:"admonition"},"The ",(0,i.kt)("inlineCode",{parentName:"p"},"MKDAChi2")," algorithm takes between ~30s-2minutes to run. However, the ",(0,i.kt)("inlineCode",{parentName:"p"},"FWECorrector")," with 5,000+ montecarlo iterations can take several hours to complete.\nWe recommend using a workstation or HPC and specifying ",(0,i.kt)("inlineCode",{parentName:"p"},"--n-cores")," at run-time.")),(0,i.kt)("h2",{id:"interpreting-results"},"Interpreting results"),(0,i.kt)("p",null,"The ",(0,i.kt)("em",{parentName:"p"},"MKDA Chi-Squared")," Workflow outputs two key maps: ",(0,i.kt)("strong",{parentName:"p"},"uniformity")," and ",(0,i.kt)("strong",{parentName:"p"},"association")," test maps."),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("strong",{parentName:"li"},"Uniformity test map:")," z-scores from a one-way ANOVA testing whether the proportion of studies that report activation at a given voxel differs from the rate that would be expected if activations were uniformly distributed throughout gray matter.")),(0,i.kt)("p",null,'The uniformity test map can be interpreted in roughly the same way as most standard whole-brain fMRI analysis: it displays the degree to which each voxel is consistently activated in studies that use a given term. For instance, for a meta-analysis of "emotion" high z-scores in the amygdala implies that studies that use the word emotion a lot tend to consistently report activation in the amygdala--at least, more consistently than one would expect if activation were uniformly distributed throughout gray matter. '),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("strong",{parentName:"li"},"Association test map"),": z-scores from a two-way ANOVA testing for the presence of a non-zero association between term use and voxel activation.")),(0,i.kt)("p",null,"The association test maps tell you whether activation in a region ",(0,i.kt)("strong",{parentName:"p"},"XXX")," occurs more consistently for studies in your meta-analytic sample ",(0,i.kt)("strong",{parentName:"p"},"m")," than for other studies in the reference dataset. In other words, a large positive z-score implies that studies in a meta-analysis are more likely to report ",(0,i.kt)("strong",{parentName:"p"},"XXX")," activation than studies whose abstracts don't include the word 'emotion'. "),(0,i.kt)("p",null,"Note that association maps ",(0,i.kt)("em",{parentName:"p"},"do not")," tell you what the probability of a given psychological concept or task is. High Z-scores do not imply that a certain region or voxel is ",(0,i.kt)("em",{parentName:"p"},"selective")," for a given concept or task. Instead, it just means there is evidence that there is at least a non-zero difference between reference studies, and studies in the meta-analysis."),(0,i.kt)("admonition",{type:"note"},(0,i.kt)("p",{parentName:"admonition"},(0,i.kt)("em",{parentName:"p"},"NiMARE")," outputs a variety of maps, including cluster-corrected and uncorrected versions of all maps. "),(0,i.kt)("p",{parentName:"admonition"},"See the documentation sections on ",(0,i.kt)("a",{parentName:"p",href:"https://nimare.readthedocs.io/en/stable/outputs.html"},"Outputs of NIMARE")," and ",(0,i.kt)("a",{parentName:"p",href:"https://nimare.readthedocs.io/en/stable/cbma.html#the-monte-carlo-multiple-comparisons-correction-method"},"Monte Carlo multiple comparisons")," for more details.")),(0,i.kt)("h2",{id:"example-pintos-lobo-2022---all-social-processing-tasks"},"Example: Pintos Lobo (2022) - All Social Processing Tasks"),(0,i.kt)("p",null,"To demonstrate, we used Neurosynth-Compose to replicate the ",(0,i.kt)("a",{parentName:"p",href:"https://pubmed.ncbi.nlm.nih.gov/36436737/"},"Pintos Lobo et al., (2022)")," meta-analysis for All Social Processing Tasks. For this example, we have already created a ",(0,i.kt)("inlineCode",{parentName:"p"},"Project")," and ",(0,i.kt)("inlineCode",{parentName:"p"},"StudySet")," with the coordinates used in this meta-analysis."),(0,i.kt)("p",null,"We then specified a ",(0,i.kt)("inlineCode",{parentName:"p"},"MKDAChi2")," Meta-Analysis with ",(0,i.kt)("inlineCode",{parentName:"p"},"FWECorrector")," with the ",(0,i.kt)("inlineCode",{parentName:"p"},"montecarlo")," method with 5,000 iterations. "),(0,i.kt)(s.Z,{variant:"contained",color:"primary",href:"https://compose.neurosynth.org/projects/4x4NsrWg8heS/meta-analyses/7K9BVG9hJQRu",mdxType:"Button"},"Meta-Analysis Specification and Results on Neurosynth Compose"),(0,i.kt)("h3",{id:"results"},"Results"),(0,i.kt)("p",null,"First, let's look at the FWE cluster corrected ",(0,i.kt)("strong",{parentName:"p"},"uniformity test")," map."),(0,i.kt)("p",null,(0,i.kt)("inlineCode",{parentName:"p"},"z_desc-uniformityMass_level-cluster_corr-FWE_method-montecarlo"),"\n",(0,i.kt)("img",{alt:"Uniformity",src:a(4568).Z,width:"950",height:"180"})),(0,i.kt)("p",null,"In this analysis, we replicate the findings of Pinto Lobos (2022), showing consistent activation for social processing across a variety of regions."),(0,i.kt)("p",null,"Next, let's look at the FWE cluster corrected ",(0,i.kt)("strong",{parentName:"p"},"association map"),":"),(0,i.kt)("p",null,(0,i.kt)("inlineCode",{parentName:"p"},"z_desc-associationMass_level-cluster_corr-FWE_method-montecarlo"),"\n",(0,i.kt)("img",{alt:"Association",src:a(2167).Z,width:"950",height:"180"})),(0,i.kt)("p",null,"As before, regions which have been previously implicated with social processing, such as the tempo-parietal junction (TPJ), and dorso-medial and ventro-medial PFC are present, meaning that activity in these social processing studies report activity in these regions with greater frequency than other studies in the Neurosynth database."),(0,i.kt)("p",null,"However, certain regions which we know to have low specificity, such as the insula, medial frontal cingulate cortex (MFCC) and parts of dorso-lateral PFC, are absent, meaning that there is ",(0,i.kt)("em",{parentName:"p"},"no evidence")," that social processing tasks report activity in these regions ",(0,i.kt)("em",{parentName:"p"},"more frequently")," than other studies in the database."),(0,i.kt)("p",null,"This example demonstrates how ",(0,i.kt)("inlineCode",{parentName:"p"},"MKDA Chi-Squared")," association analysis can help determine the specificity activity and tasks in a meta-analysis, even for high-quality manual meta-analyses."),(0,i.kt)("h2",{id:"footnotes--limitations"},"Footnotes & Limitations"),(0,i.kt)("p",null,(0,i.kt)("strong",{parentName:"p"},'What happened to the "forward inference" and "reverse inference" maps?')),(0,i.kt)("p",null,'We renamed the pre-generated forward and reverse inference maps; they\'re now referred to as the "uniformity test" and "association test" maps that we discuss here.'),(0,i.kt)("p",null,"Although the method we used hasn't changed (",(0,i.kt)("inlineCode",{parentName:"p"},"MKDA Chi-Squared"),"), the latter names more accurately capture what these maps actually mean. It was a mistake on our part to have used the forward and reverse inference labels; those labels should properly be reserved for posterior probability maps generated via a Bayesian estimation analysis, rather than for z-scores resulting from a frequentist inferential test of association. Probability maps are more difficult to interpret and use correctly, as they depend on the ",(0,i.kt)("em",{parentName:"p"},"prior")," assumed by the researcher. Since setting an appropriate prior is highly non-trivial, these maps are disabled by default."),(0,i.kt)("p",null,(0,i.kt)("strong",{parentName:"p"}," Using MKDA Chi Squared on manual meta-analyses ")),(0,i.kt)("p",null,"In this tutorial, we applied ",(0,i.kt)("inlineCode",{parentName:"p"},"MKDA Chi-Squared"),' to a manual meta-analysis. However, this is not a perfect comparison, as there are differences between the reference sample (Neurosynth), the high-quality manual annotations given as input. Studies in large-scale meta-analytic databases are automatically populated, meaning there are potential sampling biases. Most notably, studies in Neurosynth include all reported coordinates, not only "target" analyses/contrasts. Thus, it is possible that low-level task > no task contrasts are over-represented in this reference sample. '),(0,i.kt)("h2",{id:"references--further-reading"},"References & Further Reading"),(0,i.kt)("p",null,"If you want to understand the nuances of what inferences you can and cannot make using these maps, we recommend reading Tal Yarkoni's blog posts on how these maps do not provide evidence that the dACC is select for pain: ",(0,i.kt)("a",{parentName:"p",href:"https://www.talyarkoni.org/blog/2015/12/05/no-the-dorsal-anterior-cingulate-is-not-selective-for-pain-comment-on-lieberman-and-eisenberger-2015/"},"Post 1"),", ",(0,i.kt)("a",{parentName:"p",href:"https://www.talyarkoni.org/blog/2015/12/14/still-not-selective-comment-on-comment-on-comment-on-lieberman-eisenberger-2015/"},"Post 2"),", as well as a commentary by ",(0,i.kt)("a",{parentName:"p",href:"https://www.pnas.org/doi/10.1073/pnas.1600282113"},"Tor Wager et al., 2016")),(0,i.kt)("p",null,"Poldrack RA. Inferring mental states from neuroimaging data: from reverse inference to large-scale decoding. Neuron. 2011 Dec 8;72(5):692-7. doi: 10.1016/j.neuron.2011.11.001. PMID: 22153367; PMCID: PMC3240863."),(0,i.kt)("p",null,"Poldrack RA, Yarkoni T. From Brain Maps to Cognitive Ontologies: Informatics and the Search for Mental Structure. Annu Rev Psychol. 2016;67:587-612. doi: 10.1146/annurev-psych-122414-033729. Epub 2015 Sep 21. PMID: 26393866; PMCID: PMC4701616."))}h.isMDXComponent=!0},541:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/mkda_chi_squared_algo-ccaec6b8f53a020b314e09162dccf9b7.png"},6344:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/mkda_chi_squared_reference-418d3c236f463dcdd4f007e4a649c1ba.png"},9377:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/pinto_lobos_figa-115dccb8db33fc1a969fa252124b9e96.png"},2167:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/pinto_lobos_z_desc-associationMass_level-cluster_corr-FWE_method-montecarlo.nii.gz-7f5395616d7b1943c618393fca6e4e88.png"},4568:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/pinto_lobos_z_desc-uniformityMass_level-cluster_corr-FWE_method-montecarlo.nii.gz-db297c21a1e3a0c952b683a8d0f07981.png"},9569:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/prob-A_neurosynth-8d7c0db5edbb4d6862b9e503cc30e694.png"}}]); \ No newline at end of file diff --git a/assets/js/4d19d8bc.7ba67632.js b/assets/js/4d19d8bc.7ba67632.js deleted file mode 100644 index 6a6804e..0000000 --- a/assets/js/4d19d8bc.7ba67632.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[7999],{3905:(e,t,n)=>{n.d(t,{Zo:()=>c,kt:()=>p});var a=n(7294);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function r(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function s(e){for(var t=1;t=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var l=a.createContext({}),u=function(e){var t=a.useContext(l),n=t;return e&&(n="function"==typeof e?e(t):s(s({},t),e)),n},c=function(e){var t=u(e.components);return a.createElement(l.Provider,{value:t},e.children)},d="mdxType",y={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},m=a.forwardRef((function(e,t){var n=e.components,o=e.mdxType,r=e.originalType,l=e.parentName,c=i(e,["components","mdxType","originalType","parentName"]),d=u(n),m=o,p=d["".concat(l,".").concat(m)]||d[m]||y[m]||r;return n?a.createElement(p,s(s({ref:t},c),{},{components:n})):a.createElement(p,s({ref:t},c))}));function p(e,t){var n=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var r=n.length,s=new Array(r);s[0]=m;var i={};for(var l in t)hasOwnProperty.call(t,l)&&(i[l]=t[l]);i.originalType=e,i[d]="string"==typeof e?e:o,s[1]=i;for(var u=2;u{n.r(t),n.d(t,{assets:()=>l,contentTitle:()=>s,default:()=>y,frontMatter:()=>r,metadata:()=>i,toc:()=>u});var a=n(7462),o=(n(7294),n(3905));const r={sidebar_label:"FAQ",sidebar_position:2},s="Frequently Asked Questions",i={unversionedId:"introduction/faq",id:"introduction/faq",title:"Frequently Asked Questions",description:"Is this service free to use?",source:"@site/docs/introduction/faq.md",sourceDirName:"introduction",slug:"/introduction/faq",permalink:"/compose-docs/introduction/faq",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/introduction/faq.md",tags:[],version:"current",lastUpdatedBy:"James Kent",lastUpdatedAt:1727371503,formattedLastUpdatedAt:"Sep 26, 2024",sidebarPosition:2,frontMatter:{sidebar_label:"FAQ",sidebar_position:2},sidebar:"tutorialSidebar",previous:{title:"About Compose!",permalink:"/compose-docs/"},next:{title:"Our Team",permalink:"/compose-docs/introduction/team"}},l={},u=[],c={toc:u},d="wrapper";function y(e){let{components:t,...n}=e;return(0,o.kt)(d,(0,a.Z)({},c,n,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"frequently-asked-questions"},"Frequently Asked Questions"),(0,o.kt)("details",null,(0,o.kt)("summary",null,"Is this service free to use?"),"Yes! Note, however, that NS-Compose is a web-based engine for neuroimaging meta-analysis specification; at the moment, we don\u2019t (yet?) provide free computing resources for the execution of the resulting meta-analysis specifications. However, you can easily run your meta-analysis in the cloud using Google Colab, or locally using Python. Instructions are provided after you complete a meta-analysis."),(0,o.kt)("details",null,(0,o.kt)("summary",null,"Are there any restrictions on meta-analyses created?"),"Yes. Once a meta-analysis specification is executed and results are uploaded to our platform, you will no longer be able to ",(0,o.kt)("em",null,"delete or edit")," the analysis specification. A complete copy of the StudySet and Analysis is kept on our system to ensure complete provenance. You can, however, keep the analysis as private to ensure it is unlisted in the public search.",(0,o.kt)("br",null),"If you wish to make any edits, you can edit the StudySet and create a new Analysis specification, which will receive a new unique ID.",(0,o.kt)("br",null),(0,o.kt)("br",null),"In the event that you publish any results generated using the Neurosynth Compose, you MUST provide a link to the corresponding meta-analysis specification ID on the platform."),(0,o.kt)("details",null,(0,o.kt)("summary",null,"I've noticed that a study on your platform contains errors or is incomplete, can I fix them?"),"Yes! We welcome user contributions. You can correct or add details on a study, including meta-data and peak activation coordinates. A key piece of information that you may want to correct is how Activation coordinates are grouped into distinct Analyses (i.e., Contrasts). Please ensure that any edits you make are as objective as possible and reflect what is represented in the original Study, and *not* the goals of your meta-analysis.",(0,o.kt)("br",null),(0,o.kt)("br",null),"To avoid debates about the ground truth of a Study, when you make edits a new Version of the study is created, which is associated with your User."),(0,o.kt)("details",null,(0,o.kt)("summary",null,"If I contribute new studies to the platform, or edit existing studies, will other users be able to see them?"),"Yes! Although a new Version of the study is created when you make any edits, we default to displaying user edited Versions over the automatically extracted versions. This is because we assume that any edits made by users will be improvements on the extraction algorithm. Please ensure any changes you make reflect this. You may also make a Version private if you don't want to share your edits with others."),(0,o.kt)("details",null,(0,o.kt)("summary",null,"How does this project relate to the original Neurosynth?"),"Neurosynth 1.0 was an online platform for browsing automatically generated large-scale neuroimaging meta-analyses. However, because all analyses were pre-generated, users were unable to define custom meta-analyses using the Neurosynth database. Instead, Neurosynth 1.0 used text mining techniques to automatically group studies based on the frequency of the terms mentioned in the text. Neurosynth Compose is focused on allowing users to overcome the limitations of automated large-scale meta-analysis, by enabling users to annotate studies, and curate sets of studies amenable for meta-analysis. This way, users can systematically define meta-analyses using their own expertise, while still leveraging the Neurosynth database, and an easy-to-use web-based analysis builder to accelerate the meta-analysis process.",(0,o.kt)("br",null)))}y.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/4d19d8bc.d631161d.js b/assets/js/4d19d8bc.d631161d.js new file mode 100644 index 0000000..9059350 --- /dev/null +++ b/assets/js/4d19d8bc.d631161d.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[7999],{3905:(e,t,n)=>{n.d(t,{Zo:()=>c,kt:()=>p});var a=n(7294);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function r(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function s(e){for(var t=1;t=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var l=a.createContext({}),u=function(e){var t=a.useContext(l),n=t;return e&&(n="function"==typeof e?e(t):s(s({},t),e)),n},c=function(e){var t=u(e.components);return a.createElement(l.Provider,{value:t},e.children)},d="mdxType",y={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},m=a.forwardRef((function(e,t){var n=e.components,o=e.mdxType,r=e.originalType,l=e.parentName,c=i(e,["components","mdxType","originalType","parentName"]),d=u(n),m=o,p=d["".concat(l,".").concat(m)]||d[m]||y[m]||r;return n?a.createElement(p,s(s({ref:t},c),{},{components:n})):a.createElement(p,s({ref:t},c))}));function p(e,t){var n=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var r=n.length,s=new Array(r);s[0]=m;var i={};for(var l in t)hasOwnProperty.call(t,l)&&(i[l]=t[l]);i.originalType=e,i[d]="string"==typeof e?e:o,s[1]=i;for(var u=2;u{n.r(t),n.d(t,{assets:()=>l,contentTitle:()=>s,default:()=>y,frontMatter:()=>r,metadata:()=>i,toc:()=>u});var a=n(7462),o=(n(7294),n(3905));const r={sidebar_label:"FAQ",sidebar_position:2},s="Frequently Asked Questions",i={unversionedId:"introduction/faq",id:"introduction/faq",title:"Frequently Asked Questions",description:"Is this service free to use?",source:"@site/docs/introduction/faq.md",sourceDirName:"introduction",slug:"/introduction/faq",permalink:"/compose-docs/introduction/faq",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/introduction/faq.md",tags:[],version:"current",lastUpdatedBy:"Alejandro de la Vega",lastUpdatedAt:1729891615,formattedLastUpdatedAt:"Oct 25, 2024",sidebarPosition:2,frontMatter:{sidebar_label:"FAQ",sidebar_position:2},sidebar:"tutorialSidebar",previous:{title:"About Compose!",permalink:"/compose-docs/"},next:{title:"Our Team",permalink:"/compose-docs/introduction/team"}},l={},u=[],c={toc:u},d="wrapper";function y(e){let{components:t,...n}=e;return(0,o.kt)(d,(0,a.Z)({},c,n,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"frequently-asked-questions"},"Frequently Asked Questions"),(0,o.kt)("details",null,(0,o.kt)("summary",null,"Is this service free to use?"),"Yes! Note, however, that NS-Compose is a web-based engine for neuroimaging meta-analysis specification; at the moment, we don\u2019t (yet?) provide free computing resources for the execution of the resulting meta-analysis specifications. However, you can easily run your meta-analysis in the cloud using Google Colab, or locally using Python. Instructions are provided after you complete a meta-analysis."),(0,o.kt)("details",null,(0,o.kt)("summary",null,"Are there any restrictions on meta-analyses created?"),"Yes. Once a meta-analysis specification is executed and results are uploaded to our platform, you will no longer be able to ",(0,o.kt)("em",null,"delete or edit")," the analysis specification. A complete copy of the StudySet and Analysis is kept on our system to ensure complete provenance. You can, however, keep the analysis as private to ensure it is unlisted in the public search.",(0,o.kt)("br",null),"If you wish to make any edits, you can edit the StudySet and create a new Analysis specification, which will receive a new unique ID.",(0,o.kt)("br",null),(0,o.kt)("br",null),"In the event that you publish any results generated using the Neurosynth Compose, you MUST provide a link to the corresponding meta-analysis specification ID on the platform."),(0,o.kt)("details",null,(0,o.kt)("summary",null,"I've noticed that a study on your platform contains errors or is incomplete, can I fix them?"),"Yes! We welcome user contributions. You can correct or add details on a study, including meta-data and peak activation coordinates. A key piece of information that you may want to correct is how Activation coordinates are grouped into distinct Analyses (i.e., Contrasts). Please ensure that any edits you make are as objective as possible and reflect what is represented in the original Study, and *not* the goals of your meta-analysis.",(0,o.kt)("br",null),(0,o.kt)("br",null),"To avoid debates about the ground truth of a Study, when you make edits a new Version of the study is created, which is associated with your User."),(0,o.kt)("details",null,(0,o.kt)("summary",null,"If I contribute new studies to the platform, or edit existing studies, will other users be able to see them?"),"Yes! Although a new Version of the study is created when you make any edits, we default to displaying user edited Versions over the automatically extracted versions. This is because we assume that any edits made by users will be improvements on the extraction algorithm. Please ensure any changes you make reflect this. You may also make a Version private if you don't want to share your edits with others."),(0,o.kt)("details",null,(0,o.kt)("summary",null,"How does this project relate to the original Neurosynth?"),"Neurosynth 1.0 was an online platform for browsing automatically generated large-scale neuroimaging meta-analyses. However, because all analyses were pre-generated, users were unable to define custom meta-analyses using the Neurosynth database. Instead, Neurosynth 1.0 used text mining techniques to automatically group studies based on the frequency of the terms mentioned in the text. Neurosynth Compose is focused on allowing users to overcome the limitations of automated large-scale meta-analysis, by enabling users to annotate studies, and curate sets of studies amenable for meta-analysis. This way, users can systematically define meta-analyses using their own expertise, while still leveraging the Neurosynth database, and an easy-to-use web-based analysis builder to accelerate the meta-analysis process.",(0,o.kt)("br",null)))}y.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/5d9fd5dd.3810dfdd.js b/assets/js/5d9fd5dd.469881d2.js similarity index 73% rename from assets/js/5d9fd5dd.3810dfdd.js rename to assets/js/5d9fd5dd.469881d2.js index 6b84d3a..71e8d64 100644 --- a/assets/js/5d9fd5dd.3810dfdd.js +++ b/assets/js/5d9fd5dd.469881d2.js @@ -1 +1 @@ -"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[6808],{1903:(e,t,i)=>{i.r(t),i.d(t,{assets:()=>p,contentTitle:()=>c,default:()=>b,frontMatter:()=>d,metadata:()=>u,toc:()=>f});var a=i(7462),o=i(7294),r=i(3905),n=i(4996),l=i(5154);const s=e=>{let{name:t,title:i,affiliation:a,imageUrl:r,websiteUrl:n,githubProfile:s}=e;return o.createElement("div",{className:"team-member-card"},o.createElement("img",{src:r,alt:t,className:"team-member-image"}),o.createElement("div",{className:"team-member-info"},o.createElement("h3",null,t),o.createElement("p",null,i,o.createElement("br",null),a),o.createElement("div",{className:"team-member-links"},n&&o.createElement("a",{href:n,target:"_blank",rel:"noopener noreferrer"},o.createElement(l.ssk,{size:20})),o.createElement("span",null," "),s&&o.createElement("a",{href:s,target:"_blank",rel:"noopener noreferrer",className:"github-link"},o.createElement(l.hJX,{size:20})))))},m=()=>{const e=[{id:1,name:"Alejandro de la Vega",title:"Principal Investigator",affiliation:"University of Texas at Austin",imageUrl:(0,n.Z)("team/delavega.jpg"),websiteUrl:"https://adelavega.github.io/",githubProfile:"https://github.com/adelavega"},{id:2,name:"James Kent",title:"Postdoctoral Fellow & Principal Engineer",affiliation:"University of Texas at Austin",imageUrl:(0,n.Z)("team/kent.jpg"),githubProfile:"https://github.com/jdkent"},{id:3,name:"Nicholas Lee",title:"Frontend Engineer",affiliation:"McGill University",imageUrl:(0,n.Z)("team/lee.jpg"),githubProfile:"https://github.com/nicoalee"},{id:4,name:"Taylor Salo",title:"Postdoctoral fellow",affiliation:"University of Pennsylvania",imageUrl:(0,n.Z)("team/salo.png"),websiteUrl:"tsalo.github.io",githubProfile:"https://github.com/tsalo"},{id:5,name:"Katie Bottenhorn",title:"Postdoctoral Fellow",affiliation:"University of Southern California",imageUrl:(0,n.Z)("team/bottenhorn.jpg"),websiteUrl:"katherinebottenhorn.com",githubProfile:"https://github.com/62442katieb"},{id:6,name:"Jean-Baptiste Poline",title:"Associate Professor",affiliation:"McGill University",websiteUrl:"https://www.mcgill.ca/neuro/jean-baptiste-poline-phd",imageUrl:(0,n.Z)("team/poline.png")},{id:7,name:"Angela Laird",title:"Professor",affiliation:"Florida International University",websiteUrl:"https://case.fiu.edu/about/directory/profiles/laird-angela.html",imageUrl:(0,n.Z)("team/laird.jpg")},{id:8,name:"Julio Peraza",title:"Graduate Student",affiliation:"Florida International University",imageUrl:(0,n.Z)("team/pedraza.jpg"),githubProfile:"https://github.com/julioAPeraza"},{id:9,name:"Russ Poldrack",title:"Professor",affiliation:"Stanford University",imageUrl:(0,n.Z)("team/poldrack.jpg"),websiteUrl:"http://poldracklab.org/",githubProfile:"https://github.com/poldrack"},{id:10,name:"Tom Nichols",title:"Professor",affiliation:"Oxford University",websiteUrl:"https://www.bdi.ox.ac.uk/Team/t-e-nichols",imageUrl:(0,n.Z)("team/nichols.jpg")},{id:11,name:"Yifan Yu",title:"Graduate Student",affiliation:"Oxford University",imageUrl:(0,n.Z)("team/yu.jpg"),githubProfile:"https://github.com/yifan0330"},{id:12,name:"Kendra Oudyk",title:"Graduate Student",affiliation:"McGill University",imageUrl:(0,n.Z)("team/oudyk.jpg"),githubProfile:"https://github.com/koudyk"}];return o.createElement("div",{className:"team-grid"},e.map((e=>o.createElement(s,(0,a.Z)({key:e.id},e)))))},d={sidebar_label:"Our Team",sidebar_position:3},c="Our Team",u={unversionedId:"introduction/team",id:"introduction/team",title:"Our Team",description:"Neurosynth-Compose is collaborative effort across several laboratories, and is supported by the National Institute of Mental Health award 5R01MH096906.",source:"@site/docs/introduction/team.md",sourceDirName:"introduction",slug:"/introduction/team",permalink:"/compose-docs/introduction/team",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/introduction/team.md",tags:[],version:"current",lastUpdatedBy:"James Kent",lastUpdatedAt:1727371503,formattedLastUpdatedAt:"Sep 26, 2024",sidebarPosition:3,frontMatter:{sidebar_label:"Our Team",sidebar_position:3},sidebar:"tutorialSidebar",previous:{title:"FAQ",permalink:"/compose-docs/introduction/faq"},next:{title:"Ecosystem",permalink:"/compose-docs/introduction/ecosystem"}},p={},f=[],h={toc:f},g="wrapper";function b(e){let{components:t,...i}=e;return(0,r.kt)(g,(0,a.Z)({},h,i,{components:t,mdxType:"MDXLayout"}),(0,r.kt)("h1",{id:"our-team"},"Our Team"),(0,r.kt)("p",null,"Neurosynth-Compose is collaborative effort across several laboratories, and is supported by the ",(0,r.kt)("a",{parentName:"p",href:"http://www.nimh.nih.gov/"},"National Institute of Mental Health")," award 5R01MH096906.\nTogether, we developed Neurosynth-Compose, and related tools, such as NiMARE and Neurostore."),(0,r.kt)(m,{mdxType:"TeamGrid"}))}b.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[6808],{1903:(e,t,a)=>{a.r(t),a.d(t,{assets:()=>p,contentTitle:()=>c,default:()=>b,frontMatter:()=>d,metadata:()=>u,toc:()=>f});var i=a(7462),o=a(7294),r=a(3905),n=a(4996),l=a(5154);const s=e=>{let{name:t,title:a,affiliation:i,imageUrl:r,websiteUrl:n,githubProfile:s}=e;return o.createElement("div",{className:"team-member-card"},o.createElement("img",{src:r,alt:t,className:"team-member-image"}),o.createElement("div",{className:"team-member-info"},o.createElement("h3",null,t),o.createElement("p",null,a,o.createElement("br",null),i),o.createElement("div",{className:"team-member-links"},n&&o.createElement("a",{href:n,target:"_blank",rel:"noopener noreferrer"},o.createElement(l.ssk,{size:20})),o.createElement("span",null," "),s&&o.createElement("a",{href:s,target:"_blank",rel:"noopener noreferrer",className:"github-link"},o.createElement(l.hJX,{size:20})))))},m=()=>{const e=[{id:1,name:"Alejandro de la Vega",title:"Principal Investigator",affiliation:"University of Texas at Austin",imageUrl:(0,n.Z)("team/delavega.jpg"),websiteUrl:"https://adelavega.github.io/",githubProfile:"https://github.com/adelavega"},{id:2,name:"James Kent",title:"Postdoctoral Fellow & Principal Engineer",affiliation:"University of Texas at Austin",imageUrl:(0,n.Z)("team/kent.jpg"),githubProfile:"https://github.com/jdkent"},{id:3,name:"Nicholas Lee",title:"Frontend Engineer",affiliation:"McGill University",imageUrl:(0,n.Z)("team/lee.jpg"),githubProfile:"https://github.com/nicoalee"},{id:4,name:"Taylor Salo",title:"Postdoctoral fellow",affiliation:"University of Pennsylvania",imageUrl:(0,n.Z)("team/salo.png"),websiteUrl:"tsalo.github.io",githubProfile:"https://github.com/tsalo"},{id:5,name:"Katie Bottenhorn",title:"Postdoctoral Fellow",affiliation:"University of Southern California",imageUrl:(0,n.Z)("team/bottenhorn.jpg"),websiteUrl:"katherinebottenhorn.com",githubProfile:"https://github.com/62442katieb"},{id:6,name:"Jean-Baptiste Poline",title:"Associate Professor",affiliation:"McGill University",websiteUrl:"https://www.mcgill.ca/neuro/jean-baptiste-poline-phd",imageUrl:(0,n.Z)("team/poline.png")},{id:7,name:"Angela Laird",title:"Professor",affiliation:"Florida International University",websiteUrl:"https://case.fiu.edu/about/directory/profiles/laird-angela.html",imageUrl:(0,n.Z)("team/laird.jpg")},{id:8,name:"Julio Peraza",title:"Graduate Student",affiliation:"Florida International University",imageUrl:(0,n.Z)("team/pedraza.jpg"),githubProfile:"https://github.com/julioAPeraza"},{id:9,name:"Russ Poldrack",title:"Professor",affiliation:"Stanford University",imageUrl:(0,n.Z)("team/poldrack.jpg"),websiteUrl:"http://poldracklab.org/",githubProfile:"https://github.com/poldrack"},{id:10,name:"Tom Nichols",title:"Professor",affiliation:"Oxford University",websiteUrl:"https://www.bdi.ox.ac.uk/Team/t-e-nichols",imageUrl:(0,n.Z)("team/nichols.jpg")},{id:11,name:"Yifan Yu",title:"Graduate Student",affiliation:"Oxford University",imageUrl:(0,n.Z)("team/yu.jpg"),githubProfile:"https://github.com/yifan0330"},{id:12,name:"Kendra Oudyk",title:"Graduate Student",affiliation:"McGill University",imageUrl:(0,n.Z)("team/oudyk.jpg"),githubProfile:"https://github.com/koudyk"}];return o.createElement("div",{className:"team-grid"},e.map((e=>o.createElement(s,(0,i.Z)({key:e.id},e)))))},d={sidebar_label:"Our Team",sidebar_position:3},c="Our Team",u={unversionedId:"introduction/team",id:"introduction/team",title:"Our Team",description:"Neurosynth-Compose is collaborative effort across several laboratories, and is supported by the National Institute of Mental Health award 5R01MH096906.",source:"@site/docs/introduction/team.md",sourceDirName:"introduction",slug:"/introduction/team",permalink:"/compose-docs/introduction/team",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/introduction/team.md",tags:[],version:"current",lastUpdatedBy:"Alejandro de la Vega",lastUpdatedAt:1729891615,formattedLastUpdatedAt:"Oct 25, 2024",sidebarPosition:3,frontMatter:{sidebar_label:"Our Team",sidebar_position:3},sidebar:"tutorialSidebar",previous:{title:"FAQ",permalink:"/compose-docs/introduction/faq"},next:{title:"Ecosystem",permalink:"/compose-docs/introduction/ecosystem"}},p={},f=[],h={toc:f},g="wrapper";function b(e){let{components:t,...a}=e;return(0,r.kt)(g,(0,i.Z)({},h,a,{components:t,mdxType:"MDXLayout"}),(0,r.kt)("h1",{id:"our-team"},"Our Team"),(0,r.kt)("p",null,"Neurosynth-Compose is collaborative effort across several laboratories, and is supported by the ",(0,r.kt)("a",{parentName:"p",href:"http://www.nimh.nih.gov/"},"National Institute of Mental Health")," award 5R01MH096906.\nTogether, we developed Neurosynth-Compose, and related tools, such as NiMARE and Neurostore."),(0,r.kt)(m,{mdxType:"TeamGrid"}))}b.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/708a3a2f.b9393d91.js b/assets/js/708a3a2f.b9393d91.js new file mode 100644 index 0000000..9942e90 --- /dev/null +++ b/assets/js/708a3a2f.b9393d91.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[1397],{6048:(e,t,o)=>{o.r(t),o.d(t,{assets:()=>m,contentTitle:()=>d,default:()=>g,frontMatter:()=>u,metadata:()=>l,toc:()=>h});var a=o(7462),r=(o(7294),o(3905)),n=o(6464),s=o(9937),i=o(4267),p=o(8862);const u={sidebar_label:"About Compose!",sidebar_position:1,slug:"/"},d="What is Neurosynth Compose?",l={unversionedId:"introduction/index",id:"introduction/index",title:"What is Neurosynth Compose?",description:"Neurosynth Compose is the next-generation of Neurosynth, enabling users to easily perform custom neuroimaging meta-analyses using a fully web-based platform, with no programming experience required.",source:"@site/docs/introduction/index.mdx",sourceDirName:"introduction",slug:"/",permalink:"/compose-docs/",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/introduction/index.mdx",tags:[],version:"current",lastUpdatedBy:"Alejandro de la Vega",lastUpdatedAt:1729891615,formattedLastUpdatedAt:"Oct 25, 2024",sidebarPosition:1,frontMatter:{sidebar_label:"About Compose!",sidebar_position:1,slug:"/"},sidebar:"tutorialSidebar",next:{title:"FAQ",permalink:"/compose-docs/introduction/faq"}},m={},h=[{value:"Get started! \ud83d\ude80",id:"get-started-",level:2},{value:"Getting Help",id:"getting-help",level:2}],c={toc:h},y="wrapper";function g(e){let{components:t,...o}=e;return(0,r.kt)(y,(0,a.Z)({},c,o,{components:t,mdxType:"MDXLayout"}),(0,r.kt)("h1",{id:"what-is-neurosynth-compose"},"What is Neurosynth Compose?"),(0,r.kt)("p",null,(0,r.kt)("em",{parentName:"p"},"Neurosynth Compose")," is the next-generation of Neurosynth, enabling users to easily perform custom neuroimaging meta-analyses using a fully web-based platform, with no programming experience required. "),(0,r.kt)("p",null,(0,r.kt)("em",{parentName:"p"},"Neurosynth Compose")," is ",(0,r.kt)("em",{parentName:"p"},"free to use")," and helps users:"),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},"\ud83d\udd0e ",(0,r.kt)("strong",{parentName:"li"},"Search")," across over 20,000 studies in the Neurosynth database, or import from external databases such as PubMed."),(0,r.kt)("li",{parentName:"ul"},"\ud83d\uddc3\ufe0f ",(0,r.kt)("strong",{parentName:"li"},"Curate")," your StudySet using systematic review tools conforming to the ",(0,r.kt)("a",{parentName:"li",href:"https://www.prisma-statement.org/"},"PRISMA")," guidelines."),(0,r.kt)("li",{parentName:"ul"},"\ud83d\udcdd ",(0,r.kt)("strong",{parentName:"li"},"Extract")," coordinates and metadata for each study, leveraging thousands of pre-extracted studies to minimize effort."),(0,r.kt)("li",{parentName:"ul"},"\ud83d\udcca ",(0,r.kt)("strong",{parentName:"li"},"Analyze")," by specifying a reproducible ",(0,r.kt)("a",{parentName:"li",href:"https://readthedocs.org/projects/nimare/"},"NiMARE")," workflow, and execute it locally or in the cloud. "),(0,r.kt)("li",{parentName:"ul"},"\ud83d\udd17 ",(0,r.kt)("strong",{parentName:"li"},"Share")," with the community with complete provenance and reproducibility.")),(0,r.kt)("h2",{id:"get-started-"},"Get started! \ud83d\ude80"),(0,r.kt)("div",{style:{display:"flex"}},(0,r.kt)(s.Z,{style:{width:"100%",display:"flex",marginRight:"50px"},mdxType:"Card"},(0,r.kt)(i.Z,{mdxType:"CardContent"},(0,r.kt)(p.Z,{variant:"h5",component:"h2",gutterBottom:!0,mdxType:"Typography"},"Tutorials"),(0,r.kt)(p.Z,{variant:"body1",gutterBottom:!0,mdxType:"Typography"},"Tutorials show you how to use Neurosynth Compose with complete end-to-end examples."),(0,r.kt)(n.Z,{variant:"contained",color:"primary",href:"tutorial",mdxType:"Button"},"Go to Tutorials"))),(0,r.kt)(s.Z,{style:{width:"100%",display:"flex"},mdxType:"Card"},(0,r.kt)(i.Z,{mdxType:"CardContent"},(0,r.kt)(p.Z,{variant:"h5",component:"h2",gutterBottom:!0,mdxType:"Typography"},"User Guide"),(0,r.kt)(p.Z,{variant:"body1",gutterBottom:!0,mdxType:"Typography"},"The User Guide provides a detailed overview of the platform, and explains key concepts and features."),(0,r.kt)(n.Z,{variant:"contained",color:"primary",href:"guide",mdxType:"Button"},"Go to User Guide")))),(0,r.kt)("h2",{id:"getting-help"},"Getting Help"),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},"Ask a question on ",(0,r.kt)("a",{parentName:"li",href:"https://neurostars.org/tag/neurosynth-compose"},"Neurostars")," using the ",(0,r.kt)("inlineCode",{parentName:"li"},"neurosynth-compose")," tag. "),(0,r.kt)("li",{parentName:"ul"},"Report a bug or request a feature on ",(0,r.kt)("a",{parentName:"li",href:"https://github.com/neurostuff/neurostore/issues"},"GitHub")),(0,r.kt)("li",{parentName:"ul"},"Help us improve the platform by using the feedback button in the bottom right corner of the page.")))}g.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/708a3a2f.f677cb89.js b/assets/js/708a3a2f.f677cb89.js deleted file mode 100644 index 77cf037..0000000 --- a/assets/js/708a3a2f.f677cb89.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[1397],{6048:(e,t,o)=>{o.r(t),o.d(t,{assets:()=>m,contentTitle:()=>d,default:()=>g,frontMatter:()=>u,metadata:()=>l,toc:()=>h});var a=o(7462),r=(o(7294),o(3905)),n=o(6464),s=o(9937),i=o(4267),p=o(8862);const u={sidebar_label:"About Compose!",sidebar_position:1,slug:"/"},d="What is Neurosynth Compose?",l={unversionedId:"introduction/index",id:"introduction/index",title:"What is Neurosynth Compose?",description:"Neurosynth Compose is the next-generation of Neurosynth, enabling users to easily perform custom neuroimaging meta-analyses using a fully web-based platform, with no programming experience required.",source:"@site/docs/introduction/index.mdx",sourceDirName:"introduction",slug:"/",permalink:"/compose-docs/",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/introduction/index.mdx",tags:[],version:"current",lastUpdatedBy:"James Kent",lastUpdatedAt:1727371503,formattedLastUpdatedAt:"Sep 26, 2024",sidebarPosition:1,frontMatter:{sidebar_label:"About Compose!",sidebar_position:1,slug:"/"},sidebar:"tutorialSidebar",next:{title:"FAQ",permalink:"/compose-docs/introduction/faq"}},m={},h=[{value:"Get started! \ud83d\ude80",id:"get-started-",level:2},{value:"Getting Help",id:"getting-help",level:2}],c={toc:h},y="wrapper";function g(e){let{components:t,...o}=e;return(0,r.kt)(y,(0,a.Z)({},c,o,{components:t,mdxType:"MDXLayout"}),(0,r.kt)("h1",{id:"what-is-neurosynth-compose"},"What is Neurosynth Compose?"),(0,r.kt)("p",null,(0,r.kt)("em",{parentName:"p"},"Neurosynth Compose")," is the next-generation of Neurosynth, enabling users to easily perform custom neuroimaging meta-analyses using a fully web-based platform, with no programming experience required. "),(0,r.kt)("p",null,(0,r.kt)("em",{parentName:"p"},"Neurosynth Compose")," is ",(0,r.kt)("em",{parentName:"p"},"free to use")," and helps users:"),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},"\ud83d\udd0e ",(0,r.kt)("strong",{parentName:"li"},"Search")," across over 20,000 studies in the Neurosynth database, or import from external databases such as PubMed."),(0,r.kt)("li",{parentName:"ul"},"\ud83d\uddc3\ufe0f ",(0,r.kt)("strong",{parentName:"li"},"Curate")," your StudySet using systematic review tools conforming to the ",(0,r.kt)("a",{parentName:"li",href:"https://www.prisma-statement.org/"},"PRISMA")," guidelines."),(0,r.kt)("li",{parentName:"ul"},"\ud83d\udcdd ",(0,r.kt)("strong",{parentName:"li"},"Extract")," coordinates and metadata for each study, leveraging thousands of pre-extracted studies to minimize effort."),(0,r.kt)("li",{parentName:"ul"},"\ud83d\udcca ",(0,r.kt)("strong",{parentName:"li"},"Analyze")," by specifying a reproducible ",(0,r.kt)("a",{parentName:"li",href:"https://readthedocs.org/projects/nimare/"},"NiMARE")," workflow, and execute it locally or in the cloud. "),(0,r.kt)("li",{parentName:"ul"},"\ud83d\udd17 ",(0,r.kt)("strong",{parentName:"li"},"Share")," with the community with complete provenance and reproducibility.")),(0,r.kt)("h2",{id:"get-started-"},"Get started! \ud83d\ude80"),(0,r.kt)("div",{style:{display:"flex"}},(0,r.kt)(s.Z,{style:{width:"100%",display:"flex",marginRight:"50px"},mdxType:"Card"},(0,r.kt)(i.Z,{mdxType:"CardContent"},(0,r.kt)(p.Z,{variant:"h5",component:"h2",gutterBottom:!0,mdxType:"Typography"},"Tutorials"),(0,r.kt)(p.Z,{variant:"body1",gutterBottom:!0,mdxType:"Typography"},"Tutorials show you how to use Neurosynth Compose with complete end-to-end examples."),(0,r.kt)(n.Z,{variant:"contained",color:"primary",href:"tutorial",mdxType:"Button"},"Go to Tutorials"))),(0,r.kt)(s.Z,{style:{width:"100%",display:"flex"},mdxType:"Card"},(0,r.kt)(i.Z,{mdxType:"CardContent"},(0,r.kt)(p.Z,{variant:"h5",component:"h2",gutterBottom:!0,mdxType:"Typography"},"User Guide"),(0,r.kt)(p.Z,{variant:"body1",gutterBottom:!0,mdxType:"Typography"},"The User Guide provides a detailed overview of the platform, and explains key concepts and features."),(0,r.kt)(n.Z,{variant:"contained",color:"primary",href:"guide",mdxType:"Button"},"Go to User Guide")))),(0,r.kt)("h2",{id:"getting-help"},"Getting Help"),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},"Ask a question on ",(0,r.kt)("a",{parentName:"li",href:"https://neurostars.org/tag/neurosynth-compose"},"Neurostars")," using the ",(0,r.kt)("inlineCode",{parentName:"li"},"neurosynth-compose")," tag. "),(0,r.kt)("li",{parentName:"ul"},"Report a bug or request a feature on ",(0,r.kt)("a",{parentName:"li",href:"https://github.com/neurostuff/neurostore/issues"},"GitHub")),(0,r.kt)("li",{parentName:"ul"},"Help us improve the platform by using the feedback button in the bottom right corner of the page.")))}g.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/8cd595a7.ab2ea4e7.js b/assets/js/8cd595a7.ab2ea4e7.js deleted file mode 100644 index b125684..0000000 --- a/assets/js/8cd595a7.ab2ea4e7.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[606],{3905:(e,t,n)=>{n.d(t,{Zo:()=>c,kt:()=>h});var r=n(7294);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function a(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function i(e){for(var t=1;t=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var l=r.createContext({}),p=function(e){var t=r.useContext(l),n=t;return e&&(n="function"==typeof e?e(t):i(i({},t),e)),n},c=function(e){var t=p(e.components);return r.createElement(l.Provider,{value:t},e.children)},d="mdxType",u={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var n=e.components,o=e.mdxType,a=e.originalType,l=e.parentName,c=s(e,["components","mdxType","originalType","parentName"]),d=p(n),m=o,h=d["".concat(l,".").concat(m)]||d[m]||u[m]||a;return n?r.createElement(h,i(i({ref:t},c),{},{components:n})):r.createElement(h,i({ref:t},c))}));function h(e,t){var n=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var a=n.length,i=new Array(a);i[0]=m;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s[d]="string"==typeof e?e:o,i[1]=s;for(var p=2;p{n.r(t),n.d(t,{assets:()=>l,contentTitle:()=>i,default:()=>u,frontMatter:()=>a,metadata:()=>s,toc:()=>p});var r=n(7462),o=(n(7294),n(3905));const a={},i=void 0,s={unversionedId:"guide/Explore/Searching",id:"guide/Explore/Searching",title:"Searching",description:"Neurosynth-Compose works with the neurostore database to provide a convenient and functional interface to search for studies.",source:"@site/docs/guide/Explore/Searching.md",sourceDirName:"guide/Explore",slug:"/guide/Explore/Searching",permalink:"/compose-docs/guide/Explore/Searching",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/guide/Explore/Searching.md",tags:[],version:"current",lastUpdatedBy:"James Kent",lastUpdatedAt:1727371503,formattedLastUpdatedAt:"Sep 26, 2024",frontMatter:{},sidebar:"tutorialSidebar",previous:{title:"Explore",permalink:"/compose-docs/guide/Explore/"},next:{title:"Glossary",permalink:"/compose-docs/guide/glossary"}},l={},p=[{value:"Search Mechanics",id:"search-mechanics",level:3},{value:"Study Data Type",id:"study-data-type",level:3},{value:"Sorting Results",id:"sorting-results",level:3},{value:"Filtering",id:"filtering",level:3}],c={toc:p},d="wrapper";function u(e){let{components:t,...n}=e;return(0,o.kt)(d,(0,r.Z)({},c,n,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("p",null,"Neurosynth-Compose works with the neurostore database to provide a convenient and functional interface to search for studies."),(0,o.kt)("h3",{id:"search-mechanics"},"Search Mechanics"),(0,o.kt)("p",null,'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 ',(0,o.kt)("a",{parentName:"p",href:"https://www.postgresql.org/docs/current/textsearch-controls.html"},"docs for text search"),"."),(0,o.kt)("p",null,"Searches are conducted across title and abstract fields.\nThe input supports ",(0,o.kt)("inlineCode",{parentName:"p"},"AND"),", ",(0,o.kt)("inlineCode",{parentName:"p"},"OR"),", and ",(0,o.kt)("inlineCode",{parentName:"p"},"NOT")," operations. "),(0,o.kt)("p",null,"For example to use the ",(0,o.kt)("inlineCode",{parentName:"p"},"AND")," operator, you can enter in a value like ",(0,o.kt)("inlineCode",{parentName:"p"},"nicotine and memory"),". Similarly, you can enter an input like ",(0,o.kt)("inlineCode",{parentName:"p"},"smoking or nicotine")," for the ",(0,o.kt)("inlineCode",{parentName:"p"},"OR")," operator, and ",(0,o.kt)("inlineCode",{parentName:"p"},"smoking -marijuana")," for the ",(0,o.kt)("inlineCode",{parentName:"p"},"NOT")," operator (where marijuana is the excluded term)."),(0,o.kt)("p",null,"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 ",(0,o.kt)("inlineCode",{parentName:"p"},'"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: ',(0,o.kt)("inlineCode",{parentName:"p"},'smokers -"anterior insula"')),(0,o.kt)("admonition",{type:"caution"},(0,o.kt)("p",{parentName:"admonition"},"PostgreSQL's search treats the ",(0,o.kt)("inlineCode",{parentName:"p"},"OR")," operator as a union between multiple different search groups. This means that for more complicated queries, you will need to repeat\ncertain ",(0,o.kt)("inlineCode",{parentName:"p"},"AND")," or ",(0,o.kt)("inlineCode",{parentName:"p"},"NOT")," operators amongst multiple clauses."),(0,o.kt)("p",{parentName:"admonition"},"For example, consider the search: ",(0,o.kt)("inlineCode",{parentName:"p"},"nicotine OR smoking -marijuana"),".\nIn this example, the search results returned to you will be all the results yielded from ",(0,o.kt)("inlineCode",{parentName:"p"},"nicotine")," unioned with all the results of ",(0,o.kt)("inlineCode",{parentName:"p"},"smoking -marijuana"),". Having ",(0,o.kt)("inlineCode",{parentName:"p"},"-marijuana")," here does not relate to the entire search term - just ",(0,o.kt)("inlineCode",{parentName:"p"},"smoking"),"."),(0,o.kt)("p",{parentName:"admonition"},"To ensure that you do not have any mention of marijuana in your returned papers, you must search: ",(0,o.kt)("inlineCode",{parentName:"p"},"nicotine -marijuana or smoking -marijuana"),"."),(0,o.kt)("p",{parentName:"admonition"},"The same case applies for ",(0,o.kt)("inlineCode",{parentName:"p"},"AND")," operations. In general, ",(0,o.kt)("inlineCode",{parentName:"p"},"OR")," unions between various search groups consisting of ",(0,o.kt)("inlineCode",{parentName:"p"},"and"),", ",(0,o.kt)("inlineCode",{parentName:"p"},"not"),", and quoted search terms. ")),(0,o.kt)("h3",{id:"study-data-type"},"Study Data Type"),(0,o.kt)("p",null,"Studies can either report their findings as coordinate data, image data, or in some cases, both. Using the Study Data Type button, you\ncan filter the results so that only coordinate or image data appears. For example, if you are doing a coordinate based meta-analysis, you\nwill want to filter the results to show only studies that report coordinates."),(0,o.kt)("h3",{id:"sorting-results"},"Sorting Results"),(0,o.kt)("p",null,"Use the Sort By feature to sort the results based on a given property. You can also set this to be ascending or descending."),(0,o.kt)("h3",{id:"filtering"},"Filtering"),(0,o.kt)("p",null,"To filter the results of the search, click on the orange ",(0,o.kt)("span",{style:{fontWeight:"bold",color:"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."),(0,o.kt)("p",null,"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."))}u.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/8cd595a7.b868e5b5.js b/assets/js/8cd595a7.b868e5b5.js new file mode 100644 index 0000000..85c7d35 --- /dev/null +++ b/assets/js/8cd595a7.b868e5b5.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[606],{3905:(e,t,n)=>{n.d(t,{Zo:()=>d,kt:()=>h});var r=n(7294);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function a(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function i(e){for(var t=1;t=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var l=r.createContext({}),p=function(e){var t=r.useContext(l),n=t;return e&&(n="function"==typeof e?e(t):i(i({},t),e)),n},d=function(e){var t=p(e.components);return r.createElement(l.Provider,{value:t},e.children)},c="mdxType",u={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var n=e.components,o=e.mdxType,a=e.originalType,l=e.parentName,d=s(e,["components","mdxType","originalType","parentName"]),c=p(n),m=o,h=c["".concat(l,".").concat(m)]||c[m]||u[m]||a;return n?r.createElement(h,i(i({ref:t},d),{},{components:n})):r.createElement(h,i({ref:t},d))}));function h(e,t){var n=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var a=n.length,i=new Array(a);i[0]=m;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s[c]="string"==typeof e?e:o,i[1]=s;for(var p=2;p{n.r(t),n.d(t,{assets:()=>l,contentTitle:()=>i,default:()=>u,frontMatter:()=>a,metadata:()=>s,toc:()=>p});var r=n(7462),o=(n(7294),n(3905));const a={},i=void 0,s={unversionedId:"guide/Explore/Searching",id:"guide/Explore/Searching",title:"Searching",description:"Neurosynth-Compose works with the neurostore database to provide a convenient and functional interface to search for studies.",source:"@site/docs/guide/Explore/Searching.md",sourceDirName:"guide/Explore",slug:"/guide/Explore/Searching",permalink:"/compose-docs/guide/Explore/Searching",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/guide/Explore/Searching.md",tags:[],version:"current",lastUpdatedBy:"Alejandro de la Vega",lastUpdatedAt:1729891615,formattedLastUpdatedAt:"Oct 25, 2024",frontMatter:{},sidebar:"tutorialSidebar",previous:{title:"Explore",permalink:"/compose-docs/guide/Explore/"},next:{title:"Glossary",permalink:"/compose-docs/guide/glossary"}},l={},p=[{value:"Search Mechanics",id:"search-mechanics",level:3},{value:"Study Data Type",id:"study-data-type",level:3},{value:"Sorting Results",id:"sorting-results",level:3},{value:"Filtering",id:"filtering",level:3}],d={toc:p},c="wrapper";function u(e){let{components:t,...n}=e;return(0,o.kt)(c,(0,r.Z)({},d,n,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("p",null,"Neurosynth-Compose works with the neurostore database to provide a convenient and functional interface to search for studies."),(0,o.kt)("h3",{id:"search-mechanics"},"Search Mechanics"),(0,o.kt)("p",null,'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 ',(0,o.kt)("a",{parentName:"p",href:"https://www.postgresql.org/docs/current/textsearch-controls.html"},"docs for text search"),"."),(0,o.kt)("p",null,"Searches are conducted across title and abstract fields.\nThe input supports ",(0,o.kt)("inlineCode",{parentName:"p"},"AND"),", ",(0,o.kt)("inlineCode",{parentName:"p"},"OR"),", and ",(0,o.kt)("inlineCode",{parentName:"p"},"NOT")," operations. "),(0,o.kt)("p",null,"For example to use the ",(0,o.kt)("inlineCode",{parentName:"p"},"AND")," operator, you can enter in a value like ",(0,o.kt)("inlineCode",{parentName:"p"},"nicotine and memory"),". Similarly, you can enter an input like ",(0,o.kt)("inlineCode",{parentName:"p"},"smoking or nicotine")," for the ",(0,o.kt)("inlineCode",{parentName:"p"},"OR")," operator, and ",(0,o.kt)("inlineCode",{parentName:"p"},"smoking -marijuana")," for the ",(0,o.kt)("inlineCode",{parentName:"p"},"NOT")," operator (where marijuana is the excluded term)."),(0,o.kt)("p",null,"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 ",(0,o.kt)("inlineCode",{parentName:"p"},'"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: ',(0,o.kt)("inlineCode",{parentName:"p"},'smokers -"anterior insula"')),(0,o.kt)("admonition",{type:"caution"},(0,o.kt)("p",{parentName:"admonition"},"PostgreSQL's search treats the ",(0,o.kt)("inlineCode",{parentName:"p"},"OR")," operator as a union between multiple different search groups. This means that for more complicated queries, you will need to repeat\ncertain ",(0,o.kt)("inlineCode",{parentName:"p"},"AND")," or ",(0,o.kt)("inlineCode",{parentName:"p"},"NOT")," operators amongst multiple clauses."),(0,o.kt)("p",{parentName:"admonition"},"For example, consider the search: ",(0,o.kt)("inlineCode",{parentName:"p"},"nicotine OR smoking -marijuana"),".\nIn this example, the search results returned to you will be all the results yielded from ",(0,o.kt)("inlineCode",{parentName:"p"},"nicotine")," unioned with all the results of ",(0,o.kt)("inlineCode",{parentName:"p"},"smoking -marijuana"),". Having ",(0,o.kt)("inlineCode",{parentName:"p"},"-marijuana")," here does not relate to the entire search term - just ",(0,o.kt)("inlineCode",{parentName:"p"},"smoking"),"."),(0,o.kt)("p",{parentName:"admonition"},"To ensure that you do not have any mention of marijuana in your returned papers, you must search: ",(0,o.kt)("inlineCode",{parentName:"p"},"nicotine -marijuana or smoking -marijuana"),"."),(0,o.kt)("p",{parentName:"admonition"},"The same case applies for ",(0,o.kt)("inlineCode",{parentName:"p"},"AND")," operations. In general, ",(0,o.kt)("inlineCode",{parentName:"p"},"OR")," unions between various search groups consisting of ",(0,o.kt)("inlineCode",{parentName:"p"},"and"),", ",(0,o.kt)("inlineCode",{parentName:"p"},"not"),", and quoted search terms. ")),(0,o.kt)("h3",{id:"study-data-type"},"Study Data Type"),(0,o.kt)("p",null,"Studies can either report their findings as coordinate data, image data, or in some cases, both. Using the Study Data Type button, you\ncan filter the results so that only coordinate or image data appears. For example, if you are doing a coordinate based meta-analysis, you\nwill want to filter the results to show only studies that report coordinates."),(0,o.kt)("h3",{id:"sorting-results"},"Sorting Results"),(0,o.kt)("p",null,"Use the Sort By feature to sort the results based on a given property. You can also set this to be ascending or descending."),(0,o.kt)("h3",{id:"filtering"},"Filtering"),(0,o.kt)("p",null,"To filter the results of the search, click on the orange ",(0,o.kt)("span",{style:{fontWeight:"bold",color:"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."),(0,o.kt)("p",null,"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."))}u.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/935f2afb.4a27909c.js b/assets/js/935f2afb.bbbf707d.js similarity index 59% rename from assets/js/935f2afb.4a27909c.js rename to assets/js/935f2afb.bbbf707d.js index 04a232e..af3731e 100644 --- a/assets/js/935f2afb.4a27909c.js +++ b/assets/js/935f2afb.bbbf707d.js @@ -1 +1 @@ -"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[53],{1109:e=>{e.exports=JSON.parse('{"pluginId":"default","version":"current","label":"Next","banner":null,"badge":false,"noIndex":false,"className":"docs-version-current","isLast":true,"docsSidebars":{"tutorialSidebar":[{"type":"category","label":"Introduction","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"FAQ","href":"/compose-docs/introduction/faq","docId":"introduction/faq"},{"type":"link","label":"Our Team","href":"/compose-docs/introduction/team","docId":"introduction/team"},{"type":"link","label":"Ecosystem","href":"/compose-docs/introduction/ecosystem","docId":"introduction/ecosystem"}],"href":"/compose-docs/"},{"type":"category","label":"User Guide","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Project","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Curation","href":"/compose-docs/guide/Project/Curation","docId":"guide/Project/Curation"},{"type":"link","label":"Extraction","href":"/compose-docs/guide/Project/Extraction","docId":"guide/Project/Extraction"},{"type":"link","label":"Specification","href":"/compose-docs/guide/Project/Specification","docId":"guide/Project/Specification"},{"type":"link","label":"Running Analyses","href":"/compose-docs/guide/Project/Running","docId":"guide/Project/Running"}],"href":"/compose-docs/guide/Project/"},{"type":"category","label":"Explore","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Searching","href":"/compose-docs/guide/Explore/Searching","docId":"guide/Explore/Searching"}],"href":"/compose-docs/guide/Explore/"},{"type":"link","label":"Glossary","href":"/compose-docs/guide/glossary","docId":"guide/glossary"}],"href":"/compose-docs/guide/"},{"type":"category","label":"Tutorials","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Manual Meta-Analysis","href":"/compose-docs/tutorial/manual","docId":"tutorial/manual"},{"type":"link","label":"Automated Meta-Analysis","href":"/compose-docs/tutorial/automated","docId":"tutorial/automated"},{"type":"category","label":"Advanced tutorials","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"MKDA Chi-Squared Association","href":"/compose-docs/tutorial/advanced/mkda_association","docId":"tutorial/advanced/mkda_association"}],"href":"/compose-docs/tutorial/advanced/"}],"href":"/compose-docs/tutorial/"}]},"docs":{"guide/Explore/index":{"id":"guide/Explore/index","title":"Explore","description":"Here, you can browse and search existing public Studies, StudySets and Meta-Analyses created on the platform.","sidebar":"tutorialSidebar"},"guide/Explore/Searching":{"id":"guide/Explore/Searching","title":"Searching","description":"Neurosynth-Compose works with the neurostore database to provide a convenient and functional interface to search for studies.","sidebar":"tutorialSidebar"},"guide/glossary":{"id":"guide/glossary","title":"Glossary","description":"This page contains a glossary of terms used in Neurosynth-Compose.","sidebar":"tutorialSidebar"},"guide/index":{"id":"guide/index","title":"User Guide","description":"Overview","sidebar":"tutorialSidebar"},"guide/Project/Curation":{"id":"guide/Project/Curation","title":"Curation","description":"Curation is the first step in creating a meta-analysis, and begins by searching for and importing studies into the project. You will then review those studies for inclusion based on their relevancy to your research question. This involves excluding irrelevant studies, and including relevant ones.","sidebar":"tutorialSidebar"},"guide/Project/Extraction":{"id":"guide/Project/Extraction","title":"Extraction","description":"Extraction is the second step in creating a meta-analysis. It involves taking the","sidebar":"tutorialSidebar"},"guide/Project/index":{"id":"guide/Project/index","title":"Project","description":"Overview","sidebar":"tutorialSidebar"},"guide/Project/Running":{"id":"guide/Project/Running","title":"Running Analyses","description":"You have a several options for running the analysis. In all cases, you will need your unique ``, which you can access for each Meta-Analysis within your Project.","sidebar":"tutorialSidebar"},"guide/Project/Specification":{"id":"guide/Project/Specification","title":"Specification","description":"Work in progress!","sidebar":"tutorialSidebar"},"introduction/ecosystem":{"id":"introduction/ecosystem","title":"Ecosystem for fMRI Meta-Analysis","description":"ecosystem","sidebar":"tutorialSidebar"},"introduction/faq":{"id":"introduction/faq","title":"Frequently Asked Questions","description":"Is this service free to use?","sidebar":"tutorialSidebar"},"introduction/index":{"id":"introduction/index","title":"What is Neurosynth Compose?","description":"Neurosynth Compose is the next-generation of Neurosynth, enabling users to easily perform custom neuroimaging meta-analyses using a fully web-based platform, with no programming experience required.","sidebar":"tutorialSidebar"},"introduction/team":{"id":"introduction/team","title":"Our Team","description":"Neurosynth-Compose is collaborative effort across several laboratories, and is supported by the National Institute of Mental Health award 5R01MH096906.","sidebar":"tutorialSidebar"},"tutorial/advanced/index":{"id":"tutorial/advanced/index","title":"Advanced tutorials","description":"After you\'ve completed the core Manual and Advanced tutorials, you can continue your learning journey with these advanced tutorials.","sidebar":"tutorialSidebar"},"tutorial/advanced/mkda_association":{"id":"tutorial/advanced/mkda_association","title":"MKDA Chi-Squared and large-scale association tests","description":"How to perform large-scale association tests using MKDA Chi-Squared Meta-Analysis, with a Social Processing example","sidebar":"tutorialSidebar"},"tutorial/automated":{"id":"tutorial/automated","title":"Automated Meta-Analysis","description":"How to create a fully automated meta-analysis","sidebar":"tutorialSidebar"},"tutorial/index":{"id":"tutorial/index","title":"Tutorials","description":"Quickstart","sidebar":"tutorialSidebar"},"tutorial/manual":{"id":"tutorial/manual","title":"Manual Meta-Analysis","description":"How to create a custom, manual meta-analysis.","sidebar":"tutorialSidebar"}}}')}}]); \ No newline at end of file +"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[53],{1109:e=>{e.exports=JSON.parse('{"pluginId":"default","version":"current","label":"Next","banner":null,"badge":false,"noIndex":false,"className":"docs-version-current","isLast":true,"docsSidebars":{"tutorialSidebar":[{"type":"category","label":"Introduction","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"FAQ","href":"/compose-docs/introduction/faq","docId":"introduction/faq"},{"type":"link","label":"Our Team","href":"/compose-docs/introduction/team","docId":"introduction/team"},{"type":"link","label":"Ecosystem","href":"/compose-docs/introduction/ecosystem","docId":"introduction/ecosystem"}],"href":"/compose-docs/"},{"type":"category","label":"User Guide","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Project","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Curation","href":"/compose-docs/guide/Project/Curation","docId":"guide/Project/Curation"},{"type":"link","label":"Extraction","href":"/compose-docs/guide/Project/Extraction","docId":"guide/Project/Extraction"},{"type":"link","label":"Specification","href":"/compose-docs/guide/Project/Specification","docId":"guide/Project/Specification"},{"type":"link","label":"Running Analyses","href":"/compose-docs/guide/Project/Running","docId":"guide/Project/Running"}],"href":"/compose-docs/guide/Project/"},{"type":"category","label":"Explore","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Searching","href":"/compose-docs/guide/Explore/Searching","docId":"guide/Explore/Searching"}],"href":"/compose-docs/guide/Explore/"},{"type":"link","label":"Glossary","href":"/compose-docs/guide/glossary","docId":"guide/glossary"}],"href":"/compose-docs/guide/"},{"type":"category","label":"Tutorials","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Manual Meta-Analysis","href":"/compose-docs/tutorial/manual","docId":"tutorial/manual"},{"type":"link","label":"Automated Meta-Analysis","href":"/compose-docs/tutorial/automated","docId":"tutorial/automated"},{"type":"category","label":"Advanced tutorials","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"MKDA Chi-Squared Association","href":"/compose-docs/tutorial/advanced/mkda_association","docId":"tutorial/advanced/mkda_association"}],"href":"/compose-docs/tutorial/advanced/"}],"href":"/compose-docs/tutorial/"}]},"docs":{"guide/Explore/index":{"id":"guide/Explore/index","title":"Explore","description":"Here, you can browse and search existing public Studies, StudySets and Meta-Analyses created on the platform.","sidebar":"tutorialSidebar"},"guide/Explore/Searching":{"id":"guide/Explore/Searching","title":"Searching","description":"Neurosynth-Compose works with the neurostore database to provide a convenient and functional interface to search for studies.","sidebar":"tutorialSidebar"},"guide/glossary":{"id":"guide/glossary","title":"Glossary","description":"This page contains a glossary of terms used in Neurosynth-Compose.","sidebar":"tutorialSidebar"},"guide/index":{"id":"guide/index","title":"User Guide","description":"Overview","sidebar":"tutorialSidebar"},"guide/Project/Curation":{"id":"guide/Project/Curation","title":"Curation","description":"Curation is the first step in creating a meta-analysis, and begins by searching for and importing studies into the project. You will then review those studies for inclusion based on their relevancy to your research question. This involves excluding irrelevant studies, and including relevant ones.","sidebar":"tutorialSidebar"},"guide/Project/Extraction":{"id":"guide/Project/Extraction","title":"Extraction","description":"Extraction is the second step in creating a meta-analysis. It involves using the","sidebar":"tutorialSidebar"},"guide/Project/index":{"id":"guide/Project/index","title":"Project","description":"Overview","sidebar":"tutorialSidebar"},"guide/Project/Running":{"id":"guide/Project/Running","title":"Running Analyses","description":"You have a several options for running the analysis. In all cases, you will need your unique ``, which you can access for each Meta-Analysis within your Project.","sidebar":"tutorialSidebar"},"guide/Project/Specification":{"id":"guide/Project/Specification","title":"Specification","description":"Work in progress!","sidebar":"tutorialSidebar"},"introduction/ecosystem":{"id":"introduction/ecosystem","title":"Ecosystem for fMRI Meta-Analysis","description":"ecosystem","sidebar":"tutorialSidebar"},"introduction/faq":{"id":"introduction/faq","title":"Frequently Asked Questions","description":"Is this service free to use?","sidebar":"tutorialSidebar"},"introduction/index":{"id":"introduction/index","title":"What is Neurosynth Compose?","description":"Neurosynth Compose is the next-generation of Neurosynth, enabling users to easily perform custom neuroimaging meta-analyses using a fully web-based platform, with no programming experience required.","sidebar":"tutorialSidebar"},"introduction/team":{"id":"introduction/team","title":"Our Team","description":"Neurosynth-Compose is collaborative effort across several laboratories, and is supported by the National Institute of Mental Health award 5R01MH096906.","sidebar":"tutorialSidebar"},"tutorial/advanced/index":{"id":"tutorial/advanced/index","title":"Advanced tutorials","description":"After you\'ve completed the core Manual and Advanced tutorials, you can continue your learning journey with these advanced tutorials.","sidebar":"tutorialSidebar"},"tutorial/advanced/mkda_association":{"id":"tutorial/advanced/mkda_association","title":"MKDA Chi-Squared and large-scale association tests","description":"How to perform large-scale association tests using MKDA Chi-Squared Meta-Analysis, with a Social Processing example","sidebar":"tutorialSidebar"},"tutorial/automated":{"id":"tutorial/automated","title":"Automated Meta-Analysis","description":"How to create a fully automated meta-analysis","sidebar":"tutorialSidebar"},"tutorial/index":{"id":"tutorial/index","title":"Tutorials","description":"Quickstart","sidebar":"tutorialSidebar"},"tutorial/manual":{"id":"tutorial/manual","title":"Manual Meta-Analysis","description":"How to create a custom, manual meta-analysis.","sidebar":"tutorialSidebar"}}}')}}]); \ No newline at end of file diff --git a/assets/js/a1b719ab.3cfefc71.js b/assets/js/a1b719ab.3cfefc71.js new file mode 100644 index 0000000..074cec5 --- /dev/null +++ b/assets/js/a1b719ab.3cfefc71.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[4530],{3905:(e,t,n)=>{n.d(t,{Zo:()=>d,kt:()=>y});var i=n(7294);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function a(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,i)}return n}function r(e){for(var t=1;t=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var l=i.createContext({}),u=function(e){var t=i.useContext(l),n=t;return e&&(n="function"==typeof e?e(t):r(r({},t),e)),n},d=function(e){var t=u(e.components);return i.createElement(l.Provider,{value:t},e.children)},c="mdxType",v={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},p=i.forwardRef((function(e,t){var n=e.components,o=e.mdxType,a=e.originalType,l=e.parentName,d=s(e,["components","mdxType","originalType","parentName"]),c=u(n),p=o,y=c["".concat(l,".").concat(p)]||c[p]||v[p]||a;return n?i.createElement(y,r(r({ref:t},d),{},{components:n})):i.createElement(y,r({ref:t},d))}));function y(e,t){var n=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var a=n.length,r=new Array(a);r[0]=p;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s[c]="string"==typeof e?e:o,r[1]=s;for(var u=2;u{n.r(t),n.d(t,{assets:()=>l,contentTitle:()=>r,default:()=>v,frontMatter:()=>a,metadata:()=>s,toc:()=>u});var i=n(7462),o=(n(7294),n(3905));const a={title:"Glossary",sidebar_position:3},r="Glossary",s={unversionedId:"guide/glossary",id:"guide/glossary",title:"Glossary",description:"This page contains a glossary of terms used in Neurosynth-Compose.",source:"@site/docs/guide/glossary.md",sourceDirName:"guide",slug:"/guide/glossary",permalink:"/compose-docs/guide/glossary",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/guide/glossary.md",tags:[],version:"current",lastUpdatedBy:"Alejandro de la Vega",lastUpdatedAt:1729891615,formattedLastUpdatedAt:"Oct 25, 2024",sidebarPosition:3,frontMatter:{title:"Glossary",sidebar_position:3},sidebar:"tutorialSidebar",previous:{title:"Searching",permalink:"/compose-docs/guide/Explore/Searching"},next:{title:"Tutorials",permalink:"/compose-docs/tutorial/"}},l={},u=[{value:"Studyset",id:"studyset",level:2},{value:"Overview",id:"overview",level:3},{value:"Functions",id:"functions",level:3},{value:"Annotation",id:"annotation",level:2},{value:"Overview",id:"overview-1",level:3},{value:"Functions",id:"functions-1",level:3},{value:"Study",id:"study",level:2},{value:"Overview",id:"overview-2",level:3},{value:"Functions",id:"functions-2",level:3},{value:"Analysis",id:"analysis",level:2},{value:"Overview",id:"overview-3",level:3},{value:"Condition",id:"condition",level:2},{value:"Overview",id:"overview-4",level:3},{value:"Weights",id:"weights",level:2},{value:"Point",id:"point",level:2},{value:"Overview",id:"overview-5",level:3},{value:"Image",id:"image",level:2}],d={toc:u},c="wrapper";function v(e){let{components:t,...n}=e;return(0,o.kt)(c,(0,i.Z)({},d,n,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"glossary"},"Glossary"),(0,o.kt)("p",null,"This page contains a glossary of terms used in Neurosynth-Compose."),(0,o.kt)("h2",{id:"studyset"},"Studyset"),(0,o.kt)("h3",{id:"overview"},"Overview"),(0,o.kt)("p",null,"A studyset is a collection of studies and serves as the primary input\nto a meta-analysis."),(0,o.kt)("h3",{id:"functions"},"Functions"),(0,o.kt)("p",null,"If an existing studyset is close to what you want or provides a good starting\npoint, you may clone the studyset.\nFrom there you can add additional studies or remove studies from the studyset.\nIf you would like to change which analyses are included for analysis in the studyset,\nwe recommend you use annotations instead."),(0,o.kt)("h2",{id:"annotation"},"Annotation"),(0,o.kt)("h3",{id:"overview-1"},"Overview"),(0,o.kt)("p",null,"Annotations serve three functions:"),(0,o.kt)("ol",null,(0,o.kt)("li",{parentName:"ol"},"human-readable documentation (for example, following PRISMA)"),(0,o.kt)("li",{parentName:"ol"},"Specifying co-variates to be used in the meta-analysis"),(0,o.kt)("li",{parentName:"ol"},"Filtering Analyses for inclusion in the meta-analysis")),(0,o.kt)("p",null,'Annotations can be thought of like an excel sheet, where\nthe columns are variables serving one of the three functions mentioned above, and the rows are\neach analysis and its value for that variable.\nFor example, let\'s say we were to create an annotation for purpose (3). To filter analyses for inclusion, we can create\nan "include" column may have a corresponding values of "True" or "False"\nfor each analysis indicating whether to include the analysis in the meta-analysis.'),(0,o.kt)("h3",{id:"functions-1"},"Functions"),(0,o.kt)("p",null,"Annotations can also be cloned if you disagree with an existing annotation\nyou do not own and want to edit it."),(0,o.kt)("h2",{id:"study"},"Study"),(0,o.kt)("h3",{id:"overview-2"},"Overview"),(0,o.kt)("p",null,"A study is a publishable unit of research containing neuroimaging\ndata.\nThe data can be represented as peak coordinates or actual images.\nThe study is connected to the original journal it was published in."),(0,o.kt)("h3",{id:"functions-2"},"Functions"),(0,o.kt)("p",null,"Studies can be created, cloned, and edited to accomodate your needs for your meta-analysis"),(0,o.kt)("h2",{id:"analysis"},"Analysis"),(0,o.kt)("h3",{id:"overview-3"},"Overview"),(0,o.kt)("p",null,"An analysis represents a single statistical contrast between any number of groups/conditions.\nThe contents of an analysis include the terms applied to the groups/conditions and their respective\nweights in the contrast.\nAn analysis also contains the results of the statistical contrast either with an image and/or a table\nindicating significant results "),(0,o.kt)("h2",{id:"condition"},"Condition"),(0,o.kt)("h3",{id:"overview-4"},"Overview"),(0,o.kt)("p",null,"A condition is term/word that represents a psychological (e.g., 2-back), physical (e.g., biking)"),(0,o.kt)("h2",{id:"weights"},"Weights"),(0,o.kt)("h2",{id:"point"},"Point"),(0,o.kt)("h3",{id:"overview-5"},"Overview"),(0,o.kt)("h2",{id:"image"},"Image"))}v.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/a1b719ab.3f1f88dd.js b/assets/js/a1b719ab.3f1f88dd.js deleted file mode 100644 index ba7cd29..0000000 --- a/assets/js/a1b719ab.3f1f88dd.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[4530],{3905:(e,t,n)=>{n.d(t,{Zo:()=>d,kt:()=>y});var i=n(7294);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function a(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,i)}return n}function r(e){for(var t=1;t=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var l=i.createContext({}),u=function(e){var t=i.useContext(l),n=t;return e&&(n="function"==typeof e?e(t):r(r({},t),e)),n},d=function(e){var t=u(e.components);return i.createElement(l.Provider,{value:t},e.children)},c="mdxType",v={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},p=i.forwardRef((function(e,t){var n=e.components,o=e.mdxType,a=e.originalType,l=e.parentName,d=s(e,["components","mdxType","originalType","parentName"]),c=u(n),p=o,y=c["".concat(l,".").concat(p)]||c[p]||v[p]||a;return n?i.createElement(y,r(r({ref:t},d),{},{components:n})):i.createElement(y,r({ref:t},d))}));function y(e,t){var n=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var a=n.length,r=new Array(a);r[0]=p;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s[c]="string"==typeof e?e:o,r[1]=s;for(var u=2;u{n.r(t),n.d(t,{assets:()=>l,contentTitle:()=>r,default:()=>v,frontMatter:()=>a,metadata:()=>s,toc:()=>u});var i=n(7462),o=(n(7294),n(3905));const a={title:"Glossary",sidebar_position:3},r="Glossary",s={unversionedId:"guide/glossary",id:"guide/glossary",title:"Glossary",description:"This page contains a glossary of terms used in Neurosynth-Compose.",source:"@site/docs/guide/glossary.md",sourceDirName:"guide",slug:"/guide/glossary",permalink:"/compose-docs/guide/glossary",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/guide/glossary.md",tags:[],version:"current",lastUpdatedBy:"James Kent",lastUpdatedAt:1727371503,formattedLastUpdatedAt:"Sep 26, 2024",sidebarPosition:3,frontMatter:{title:"Glossary",sidebar_position:3},sidebar:"tutorialSidebar",previous:{title:"Searching",permalink:"/compose-docs/guide/Explore/Searching"},next:{title:"Tutorials",permalink:"/compose-docs/tutorial/"}},l={},u=[{value:"Studyset",id:"studyset",level:2},{value:"Overview",id:"overview",level:3},{value:"Functions",id:"functions",level:3},{value:"Annotation",id:"annotation",level:2},{value:"Overview",id:"overview-1",level:3},{value:"Functions",id:"functions-1",level:3},{value:"Study",id:"study",level:2},{value:"Overview",id:"overview-2",level:3},{value:"Functions",id:"functions-2",level:3},{value:"Analysis",id:"analysis",level:2},{value:"Overview",id:"overview-3",level:3},{value:"Condition",id:"condition",level:2},{value:"Overview",id:"overview-4",level:3},{value:"Weights",id:"weights",level:2},{value:"Point",id:"point",level:2},{value:"Overview",id:"overview-5",level:3},{value:"Image",id:"image",level:2}],d={toc:u},c="wrapper";function v(e){let{components:t,...n}=e;return(0,o.kt)(c,(0,i.Z)({},d,n,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"glossary"},"Glossary"),(0,o.kt)("p",null,"This page contains a glossary of terms used in Neurosynth-Compose."),(0,o.kt)("h2",{id:"studyset"},"Studyset"),(0,o.kt)("h3",{id:"overview"},"Overview"),(0,o.kt)("p",null,"A studyset is a collection of studies and serves as the primary input\nto a meta-analysis."),(0,o.kt)("h3",{id:"functions"},"Functions"),(0,o.kt)("p",null,"If an existing studyset is close to what you want or provides a good starting\npoint, you may clone the studyset.\nFrom there you can add additional studies or remove studies from the studyset.\nIf you would like to change which analyses are included for analysis in the studyset,\nwe recommend you use annotations instead."),(0,o.kt)("h2",{id:"annotation"},"Annotation"),(0,o.kt)("h3",{id:"overview-1"},"Overview"),(0,o.kt)("p",null,"Annotations serve three functions:"),(0,o.kt)("ol",null,(0,o.kt)("li",{parentName:"ol"},"human-readable documentation (for example, following PRISMA)"),(0,o.kt)("li",{parentName:"ol"},"Specifying co-variates to be used in the meta-analysis"),(0,o.kt)("li",{parentName:"ol"},"Filtering Analyses for inclusion in the meta-analysis")),(0,o.kt)("p",null,'Annotations can be thought of like an excel sheet, where\nthe columns are variables serving one of the three functions mentioned above, and the rows are\neach analysis and its value for that variable.\nFor example, let\'s say we were to create an annotation for purpose (3). To filter analyses for inclusion, we can create\nan "include" column may have a corresponding values of "True" or "False"\nfor each analysis indicating whether to include the analysis in the meta-analysis.'),(0,o.kt)("h3",{id:"functions-1"},"Functions"),(0,o.kt)("p",null,"Annotations can also be cloned if you disagree with an existing annotation\nyou do not own and want to edit it."),(0,o.kt)("h2",{id:"study"},"Study"),(0,o.kt)("h3",{id:"overview-2"},"Overview"),(0,o.kt)("p",null,"A study is a publishable unit of research containing neuroimaging\ndata.\nThe data can be represented as peak coordinates or actual images.\nThe study is connected to the original journal it was published in."),(0,o.kt)("h3",{id:"functions-2"},"Functions"),(0,o.kt)("p",null,"Studies can be created, cloned, and edited to accomodate your needs for your meta-analysis"),(0,o.kt)("h2",{id:"analysis"},"Analysis"),(0,o.kt)("h3",{id:"overview-3"},"Overview"),(0,o.kt)("p",null,"An analysis represents a single statistical contrast between any number of groups/conditions.\nThe contents of an analysis include the terms applied to the groups/conditions and their respective\nweights in the contrast.\nAn analysis also contains the results of the statistical contrast either with an image and/or a table\nindicating significant results "),(0,o.kt)("h2",{id:"condition"},"Condition"),(0,o.kt)("h3",{id:"overview-4"},"Overview"),(0,o.kt)("p",null,"A condition is term/word that represents a psychological (e.g., 2-back), physical (e.g., biking)"),(0,o.kt)("h2",{id:"weights"},"Weights"),(0,o.kt)("h2",{id:"point"},"Point"),(0,o.kt)("h3",{id:"overview-5"},"Overview"),(0,o.kt)("h2",{id:"image"},"Image"))}v.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/a3562974.4d0710a1.js b/assets/js/a3562974.4d0710a1.js deleted file mode 100644 index 48d0a72..0000000 --- a/assets/js/a3562974.4d0710a1.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[9735],{3905:(e,t,o)=>{o.d(t,{Zo:()=>u,kt:()=>h});var n=o(7294);function i(e,t,o){return t in e?Object.defineProperty(e,t,{value:o,enumerable:!0,configurable:!0,writable:!0}):e[t]=o,e}function a(e,t){var o=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),o.push.apply(o,n)}return o}function r(e){for(var t=1;t=0||(i[o]=e[o]);return i}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,o)&&(i[o]=e[o])}return i}var l=n.createContext({}),d=function(e){var t=n.useContext(l),o=t;return e&&(o="function"==typeof e?e(t):r(r({},t),e)),o},u=function(e){var t=d(e.components);return n.createElement(l.Provider,{value:t},e.children)},c="mdxType",p={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},m=n.forwardRef((function(e,t){var o=e.components,i=e.mdxType,a=e.originalType,l=e.parentName,u=s(e,["components","mdxType","originalType","parentName"]),c=d(o),m=i,h=c["".concat(l,".").concat(m)]||c[m]||p[m]||a;return o?n.createElement(h,r(r({ref:t},u),{},{components:o})):n.createElement(h,r({ref:t},u))}));function h(e,t){var o=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var a=o.length,r=new Array(a);r[0]=m;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s[c]="string"==typeof e?e:i,r[1]=s;for(var d=2;d{o.r(t),o.d(t,{assets:()=>l,contentTitle:()=>r,default:()=>p,frontMatter:()=>a,metadata:()=>s,toc:()=>d});var n=o(7462),i=(o(7294),o(3905));const a={title:"Curation",sidebar_position:0},r="Curation",s={unversionedId:"guide/Project/Curation",id:"guide/Project/Curation",title:"Curation",description:"Curation is the first step in creating a meta-analysis, and begins by searching for and importing studies into the project. You will then review those studies for inclusion based on their relevancy to your research question. This involves excluding irrelevant studies, and including relevant ones.",source:"@site/docs/guide/Project/Curation.md",sourceDirName:"guide/Project",slug:"/guide/Project/Curation",permalink:"/compose-docs/guide/Project/Curation",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/guide/Project/Curation.md",tags:[],version:"current",lastUpdatedBy:"James Kent",lastUpdatedAt:1727371503,formattedLastUpdatedAt:"Sep 26, 2024",sidebarPosition:0,frontMatter:{title:"Curation",sidebar_position:0},sidebar:"tutorialSidebar",previous:{title:"Project",permalink:"/compose-docs/guide/Project/"},next:{title:"Extraction",permalink:"/compose-docs/guide/Project/Extraction"}},l={},d=[{value:"Getting Started",id:"getting-started",level:2},{value:"PRISMA Workflow",id:"prisma-workflow",level:3},{value:"Simple Workflow",id:"simple-workflow",level:3},{value:"Importing",id:"importing",level:2},{value:"Import Method 1: Import from Neurostore",id:"import-method-1-import-from-neurostore",level:3},{value:"Import Method 2: Import from PubMed",id:"import-method-2-import-from-pubmed",level:3},{value:"Import Method 3: Import from BibTex/RIS/endnote",id:"import-method-3-import-from-bibtexrisendnote",level:3},{value:"Import Method 4: Custom Studies",id:"import-method-4-custom-studies",level:3},{value:"Sleuth files",id:"sleuth-files",level:3},{value:"Duplicates",id:"duplicates",level:3},{value:"Duplicates are detected between the studies being imported and the studies already in the project",id:"duplicates-are-detected-between-the-studies-being-imported-and-the-studies-already-in-the-project",level:4},{value:"Duplicates are detected within the file you are importing",id:"duplicates-are-detected-within-the-file-you-are-importing",level:4},{value:"Excluding and Promoting Studies",id:"excluding-and-promoting-studies",level:2},{value:"Exclude",id:"exclude",level:3},{value:"Promote",id:"promote",level:3},{value:"Downloading included studies",id:"downloading-included-studies",level:2},{value:"On to Extraction",id:"on-to-extraction",level:2}],u={toc:d},c="wrapper";function p(e){let{components:t,...o}=e;return(0,i.kt)(c,(0,n.Z)({},u,o,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"curation"},"Curation"),(0,i.kt)("p",null,(0,i.kt)("em",{parentName:"p"},"Curation")," is the first step in creating a meta-analysis, and begins by ",(0,i.kt)("em",{parentName:"p"},"searching")," for and ",(0,i.kt)("em",{parentName:"p"},"importing")," studies into the project. You will then ",(0,i.kt)("em",{parentName:"p"},"review")," those studies for inclusion based on their relevancy to your research question. This involves ",(0,i.kt)("strong",{parentName:"p"},"excluding")," irrelevant studies, and ",(0,i.kt)("strong",{parentName:"p"},"including")," relevant ones."),(0,i.kt)("p",null,"At the end of the process, you will be ready to create a ",(0,i.kt)("a",{parentName:"p",href:"/compose-docs/guide/glossary#studyset"},(0,i.kt)("strong",{parentName:"a"},"Studyset"))," of related studies that are amenable for neuroimaging meta-analysis"),(0,i.kt)("h2",{id:"getting-started"},"Getting Started"),(0,i.kt)("p",null,"The curation interface uses columns as a way to label studies based on their current status.\nThe left most column is the starting point and all studies imported into the project will begin there.\nThe right most column is the ",(0,i.kt)("strong",{parentName:"p"},"inclusion column")," and is the place where studies will go to be included in the meta-analysis."),(0,i.kt)("p",null,'The goal is to get studies from the left most starting column, and narrow them down to a final subset of included studies in the right most column.\nIf a study is not eligible for inclusion at any point, it should be marked as "excluded" before reaching the inclusion column.'),(0,i.kt)("p",null,"The curation step is complete when all studies have been categorized, either by being included or excluded."),(0,i.kt)("p",null,"When you first begin ",(0,i.kt)("em",{parentName:"p"},"Curation"),", you will choose between different workflows, which vary in how rigorous or systematic the selection of studies will be."),(0,i.kt)("admonition",{title:"How specific to be?",type:"tip"},(0,i.kt)("p",{parentName:"admonition"},"Performing a systematic meta-analysis involves a substantial amount of effort. It is up to you, the researcher, how rigorous to be in this process. We reccomend thinking about your ",(0,i.kt)("em",{parentName:"p"},"goals")," prior to starting this process so that you can have clear inclusion guidelines. If you are looking for an exploratory analysis, we reccomend following the tutorial for ",(0,i.kt)("em",{parentName:"p"},"automated meta-analysis"),", which replaces manual curation with an automated selection of studies. Note that automated meta-analyses are not a replacement for a careful systematic meta-analysis.")),(0,i.kt)("h3",{id:"prisma-workflow"},"PRISMA Workflow"),(0,i.kt)("p",null,"PRISMA stands for the ",(0,i.kt)("strong",{parentName:"p"},"Preferred Reporting Items for Systematic Review and Meta-Analyses"),". The\n",(0,i.kt)("a",{parentName:"p",href:"http://www.prisma-statement.org/?AspxAutoDetectCookieSupport=1"},"PRISMA guidelines")," are a set of rules for reporting a\nsystematic review, and are the gold standard for producing a proper, rigorous, and transparent meta-analysis."),(0,i.kt)("p",null,"If you are trying to create a rigorous ",(0,i.kt)("a",{parentName:"p",href:"/compose-docs/tutorial/manual"},"PRISMA compliant manual meta-analysis")," you will want to select this option."),(0,i.kt)("p",null,"When you select this option, neurosynth-compose will automatically initialize the curation step with 4 distinct columns as\ndictated by PRISMA guidelines: ",(0,i.kt)("strong",{parentName:"p"},"Identification, Screening, Eligibility, Included"),"."),(0,i.kt)("p",null,"After importing studies into neurosynth, they will be placed into the identification column and studies are triaged from there."),(0,i.kt)("admonition",{title:"PRISMA Summary",type:"info"},(0,i.kt)("p",{parentName:"admonition"},"The ",(0,i.kt)("strong",{parentName:"p"},"Identification")," column is where all imported studies are deposited into initially. As alluded to by the name, the identification\ncolumn is where you identify all records yielded from your search. In this column, you wil exclude studies purely based on whether they are\nduplicates of existing studies. All other studies are promoted."),(0,i.kt)("p",{parentName:"admonition"},"The ",(0,i.kt)("strong",{parentName:"p"},"Screening")," column consists of all records that have been screened for duplicates. In this column, you want to review the titles/abstracts of studies\nand exclude purely based on whether they are irrelevant to your research question or domain. All other studies are promoted."),(0,i.kt)("p",{parentName:"admonition"},"The ",(0,i.kt)("strong",{parentName:"p"},"Eligibility")," column consists of all records that have been screened for duplicates and irrelevant content. In this column, you want to\nreview the full text of studies and exclude based on whether the study described aligns with the standards of the meta-analysis itself. Reasons\nfor exclusion may include wrong setting, wrong patient population, wrong intervention, wrong paragdigm, etc."),(0,i.kt)("p",{parentName:"admonition"},"The ",(0,i.kt)("strong",{parentName:"p"},"Included")," column consists of all records that have passed previous levels of exclusion and can be considered for the next step of the project."),(0,i.kt)("p",{parentName:"admonition"},"For more information, consult the ",(0,i.kt)("a",{parentName:"p",href:"http://www.prisma-statement.org/?AspxAutoDetectCookieSupport=1"},"PRISMA guidelines"),".")),(0,i.kt)("h3",{id:"simple-workflow"},"Simple Workflow"),(0,i.kt)("p",null,"If you want to create a semi-automated meta-analysis (i.e. perform manual review on a large-scale study search), you'll want to select this option."),(0,i.kt)("p",null,"This workflow is initalized with only two columns. As before, the left most column is where studies will be placed when they are imported. However, unlike a full PRISMA workflow, all exclusion occurs in this column. All studies not excluded are then promoted to the right most column for inclusion into the meta-analysis."),(0,i.kt)("h2",{id:"importing"},"Importing"),(0,i.kt)("p",null,"To begin importing studies into your project click the ",(0,i.kt)("strong",{parentName:"p"},"IMPORT STUDIES")," button."),(0,i.kt)("p",null,"You will be asked to choose an import method, source, name for your import, and finally address\nany potential duplicate studies."),(0,i.kt)("admonition",{type:"tip"},(0,i.kt)("p",{parentName:"admonition"},"We recommend giving each import a meaningful name. This will be useful when you come back\nand want to know where a certain study was imported from.")),(0,i.kt)("h3",{id:"import-method-1-import-from-neurostore"},"Import Method 1: Import from Neurostore"),(0,i.kt)("p",null,"Neurostore indexes a large number of neuroimaging studies which are ready for meta-analysis. Studies in Neurostore have been pre-processed, including extracting peak activation coordinates from Tables in the text, and computing semantic features from the abstract/full text. Neurostore also indexes studies which other users have annotated and made available to others for re-use."),(0,i.kt)("p",null,"Importing from Neurostore utilizes the Study search UI similar to the ",(0,i.kt)("a",{parentName:"p",href:"https://compose.neurosynth.org/studies"},"Study Page"),".\nAfter entering your search, click the bottom right button to import the searched studies into your project."),(0,i.kt)("admonition",{type:"tip"},(0,i.kt)("p",{parentName:"admonition"},"Importing from Neurostore can save you a lot of time, as these studies are much more likely to be amenable to meta-analysis, and have pre-extracted coordinates. However, note that some manual annotation may still be required to verify the coordinate extraction, and choose the relevant Analysis (i.e. contrast) for final inclusion.")),(0,i.kt)("h3",{id:"import-method-2-import-from-pubmed"},"Import Method 2: Import from PubMed"),(0,i.kt)("p",null,"Use this option to import studies directly from PubMed. To start, you need to go to the ",(0,i.kt)("a",{parentName:"p",href:"https://pubmed.ncbi.nlm.nih.gov/"},"PubMed Site"),"\nand either enter in a search or navigate to a previously created collection."),(0,i.kt)("p",null,"To import the search or collection from PubMed into neurosynth-compose, you will need a text file containing a list of PMIDs.\nYou can obtain this by going to your collection/search and clicking the ",(0,i.kt)("strong",{parentName:"p"},"Save")," button. Set ",(0,i.kt)("strong",{parentName:"p"},"Selection")," to ",(0,i.kt)("strong",{parentName:"p"},"All results"),"\nand set ",(0,i.kt)("strong",{parentName:"p"},"Format")," to ",(0,i.kt)("strong",{parentName:"p"},"PMID"),". Click ",(0,i.kt)("strong",{parentName:"p"},"Create file")," and your text file containing the PMIDs will be generated and downloaded."),(0,i.kt)("admonition",{type:"caution"},(0,i.kt)("p",{parentName:"admonition"},"Neurosynth-Compose uses the PubMed API to import studies. As a result, the maximum number of PMIDs that can be imported at once is 1,500.\nIf your collection has more than 1,500 PMIDs, split the import into multiple files. You can select the same import name so that they are all grouped together.")),(0,i.kt)("h3",{id:"import-method-3-import-from-bibtexrisendnote"},"Import Method 3: Import from BibTex/RIS/endnote"),(0,i.kt)("p",null,"Use this option to import studies via a .bib, .RIS, or .enw file. This may be useful if you want to import from a citation manager like Zotero."),(0,i.kt)("h3",{id:"import-method-4-custom-studies"},"Import Method 4: Custom Studies"),(0,i.kt)("p",null,"If there is any record that cannot be easily imported using one of the methods listed above, you can also manually create a study. This may be necessary\nto include resources like unpublished studies."),(0,i.kt)("h3",{id:"sleuth-files"},"Sleuth files"),(0,i.kt)("p",null,"At the moment, it's not possible to add studies from a sleuth file into an ",(0,i.kt)("em",{parentName:"p"},"existing project"),". To create a new project from a sleuth file, ",(0,i.kt)("a",{parentName:"p",href:"/compose-docs/guide/glossary#studyset"},"read more here"),"."),(0,i.kt)("h3",{id:"duplicates"},"Duplicates"),(0,i.kt)("p",null,'If duplicates are detected in your import, you will be asked how to reconcile them by choosing which of the studies to keep by choosing "KEEP THIS STUDY". Matching duplicates will be automatically marked for exclusion. Note that as a user, you can override any of these selections at any time, and choose which studies to keep or exclude.'),(0,i.kt)("admonition",{type:"info"},(0,i.kt)("p",{parentName:"admonition"},(0,i.kt)("em",{parentName:"p"},"Neurosynth Compose does not delete studies"),". If a study is marked as a duplicate, it is marked as ",(0,i.kt)("strong",{parentName:"p"},"excluded")," but it is not discarded to ensure complete provenance.")),(0,i.kt)("p",null,"There are two potential ways that duplicates can occur:"),(0,i.kt)("h4",{id:"duplicates-are-detected-between-the-studies-being-imported-and-the-studies-already-in-the-project"},"Duplicates are detected between the studies being imported and the studies already in the project"),(0,i.kt)("p",null,"If any study being important has the same title, PMID, or DOI is the same as\none already in the project, you will be asked reconcile these duplicates."),(0,i.kt)("p",null,'Note that if you mark a study that is already promoted as a duplicate, it will be "demoted" back to the first column and marked as "duplicate". It is reccomended to mark as duplicate the incoming study to avoid this.'),(0,i.kt)("h4",{id:"duplicates-are-detected-within-the-file-you-are-importing"},"Duplicates are detected within the file you are importing"),(0,i.kt)("p",null,"Although rare, it is possible to have duplicates within a given import. For example, if within a RIS file there are duplicate entries. In this case, you will be asked to select which study to keep. Studies marked as duplicates will still be imported but marked as excluded."),(0,i.kt)("h2",{id:"excluding-and-promoting-studies"},"Excluding and Promoting Studies"),(0,i.kt)("p",null,"Once studies have been imported into the first column of the curation phase, they need to be reviewed for inclusion into your meta-analysis.\nAll studies must be either excluded or moved to the inclusion column in order to progress to the extraction phase."),(0,i.kt)("p",null,"To begin, either click on the button at the top of the column or click on any study in the column. This will open up a page which will show the study\nalong with the following options: ",(0,i.kt)("strong",{parentName:"p"},"PROMOTE, NEEDS REVIEW"),", and ",(0,i.kt)("strong",{parentName:"p"},"EXCLUDE"),". There is also a button to ",(0,i.kt)("strong",{parentName:"p"},"ADD TAGS")," which will assign an informational tag to the study. This informational tag is a tool that allows you to mark studies with certain information - once an informational tag is created, you can filter by those tags."),(0,i.kt)("h3",{id:"exclude"},"Exclude"),(0,i.kt)("p",null,"To exclude a study, click the ",(0,i.kt)("strong",{parentName:"p"},"EXCLUDE")," button and select the exclusion reason. You can either choose from the preset exclusion reasons or you can begin\ntyping to create a new one."),(0,i.kt)("admonition",{type:"tip"},(0,i.kt)("p",{parentName:"admonition"},"For the PRISMA workflow, the default exclusion reason wil depend on the phase you are in (identification vs screening vs eligibility), to match the PRISMA guidelines. While we do not recommend it, you can click the arrow button and start typing in the input to create a new exclusion reason.\nRevisit the ",(0,i.kt)("a",{parentName:"p",href:"./Curation#prisma-workflow"},"PRISMA workflow")," to review reccomended exclusion criteria.")),(0,i.kt)("h3",{id:"promote"},"Promote"),(0,i.kt)("p",null,"If a study meets inclusion critera (for the current phase), click ",(0,i.kt)("strong",{parentName:"p"},"PROMOTE")," to move the study forward to the next curation column. If it is moved into the right most inclusion column, then it will be included in the meta-analysis."),(0,i.kt)("admonition",{type:"tip"},(0,i.kt)("p",{parentName:"admonition"},"For the first column (especially in a PRISMA workflow) it can be tedious to promote non-duplicates to the next column. If all duplicates have been resolved, you can exit the dialog and click ",(0,i.kt)("strong",{parentName:"p"},"PROMOTE ALL UNCATEGORIZED STUDIES")," to advance all non-duplicate studies to the next column.")),(0,i.kt)("h2",{id:"downloading-included-studies"},"Downloading included studies"),(0,i.kt)("p",null,'In order to download the studies that you have included in Curation, you can utilize our download feature. Go to curation and click "Download Included as CSV". Alternatively, you can click the dropdown and download the included studies in BibTeX format instead.'),(0,i.kt)("h2",{id:"on-to-extraction"},"On to Extraction"),(0,i.kt)("p",null,"When you have categorized all imported studies by either excluding them or moving them to the inclusion column, then you have\nsuccessfully completed the curation portion of the meta-analysis."),(0,i.kt)("p",null,(0,i.kt)("em",{parentName:"p"},"Neurosynth Compose")," will detect this and reveal a new button: ",(0,i.kt)("strong",{parentName:"p"},"MOVE TO EXTRACTION PHASE"),". This will move you back to the project page and get you started on the next major component to building your meta-analysis: ",(0,i.kt)("a",{parentName:"p",href:"./Extraction"},"extraction"),"."))}p.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/a3562974.a83c1d42.js b/assets/js/a3562974.a83c1d42.js new file mode 100644 index 0000000..b3a1495 --- /dev/null +++ b/assets/js/a3562974.a83c1d42.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[9735],{3905:(e,t,o)=>{o.d(t,{Zo:()=>u,kt:()=>h});var n=o(7294);function i(e,t,o){return t in e?Object.defineProperty(e,t,{value:o,enumerable:!0,configurable:!0,writable:!0}):e[t]=o,e}function a(e,t){var o=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),o.push.apply(o,n)}return o}function r(e){for(var t=1;t=0||(i[o]=e[o]);return i}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,o)&&(i[o]=e[o])}return i}var l=n.createContext({}),d=function(e){var t=n.useContext(l),o=t;return e&&(o="function"==typeof e?e(t):r(r({},t),e)),o},u=function(e){var t=d(e.components);return n.createElement(l.Provider,{value:t},e.children)},c="mdxType",p={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},m=n.forwardRef((function(e,t){var o=e.components,i=e.mdxType,a=e.originalType,l=e.parentName,u=s(e,["components","mdxType","originalType","parentName"]),c=d(o),m=i,h=c["".concat(l,".").concat(m)]||c[m]||p[m]||a;return o?n.createElement(h,r(r({ref:t},u),{},{components:o})):n.createElement(h,r({ref:t},u))}));function h(e,t){var o=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var a=o.length,r=new Array(a);r[0]=m;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s[c]="string"==typeof e?e:i,r[1]=s;for(var d=2;d{o.r(t),o.d(t,{assets:()=>l,contentTitle:()=>r,default:()=>p,frontMatter:()=>a,metadata:()=>s,toc:()=>d});var n=o(7462),i=(o(7294),o(3905));const a={title:"Curation",sidebar_position:0},r="Curation",s={unversionedId:"guide/Project/Curation",id:"guide/Project/Curation",title:"Curation",description:"Curation is the first step in creating a meta-analysis, and begins by searching for and importing studies into the project. You will then review those studies for inclusion based on their relevancy to your research question. This involves excluding irrelevant studies, and including relevant ones.",source:"@site/docs/guide/Project/Curation.md",sourceDirName:"guide/Project",slug:"/guide/Project/Curation",permalink:"/compose-docs/guide/Project/Curation",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/guide/Project/Curation.md",tags:[],version:"current",lastUpdatedBy:"Alejandro de la Vega",lastUpdatedAt:1729891615,formattedLastUpdatedAt:"Oct 25, 2024",sidebarPosition:0,frontMatter:{title:"Curation",sidebar_position:0},sidebar:"tutorialSidebar",previous:{title:"Project",permalink:"/compose-docs/guide/Project/"},next:{title:"Extraction",permalink:"/compose-docs/guide/Project/Extraction"}},l={},d=[{value:"Getting Started",id:"getting-started",level:2},{value:"PRISMA Workflow",id:"prisma-workflow",level:3},{value:"Simple Workflow",id:"simple-workflow",level:3},{value:"Importing",id:"importing",level:2},{value:"Import Method 1: Import from Neurostore",id:"import-method-1-import-from-neurostore",level:3},{value:"Import Method 2: Import from PubMed",id:"import-method-2-import-from-pubmed",level:3},{value:"Import Method 3: Import from BibTex/RIS/endnote",id:"import-method-3-import-from-bibtexrisendnote",level:3},{value:"Import Method 4: Custom Studies",id:"import-method-4-custom-studies",level:3},{value:"Sleuth files",id:"sleuth-files",level:3},{value:"Duplicates",id:"duplicates",level:3},{value:"Duplicates are detected between the studies being imported and the studies already in the project",id:"duplicates-are-detected-between-the-studies-being-imported-and-the-studies-already-in-the-project",level:4},{value:"Duplicates are detected within the file you are importing",id:"duplicates-are-detected-within-the-file-you-are-importing",level:4},{value:"Excluding and Promoting Studies",id:"excluding-and-promoting-studies",level:2},{value:"Exclude",id:"exclude",level:3},{value:"Promote",id:"promote",level:3},{value:"Downloading included studies",id:"downloading-included-studies",level:2},{value:"On to Extraction",id:"on-to-extraction",level:2}],u={toc:d},c="wrapper";function p(e){let{components:t,...o}=e;return(0,i.kt)(c,(0,n.Z)({},u,o,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"curation"},"Curation"),(0,i.kt)("p",null,(0,i.kt)("em",{parentName:"p"},"Curation")," is the first step in creating a meta-analysis, and begins by ",(0,i.kt)("em",{parentName:"p"},"searching")," for and ",(0,i.kt)("em",{parentName:"p"},"importing")," studies into the project. You will then ",(0,i.kt)("em",{parentName:"p"},"review")," those studies for inclusion based on their relevancy to your research question. This involves ",(0,i.kt)("strong",{parentName:"p"},"excluding")," irrelevant studies, and ",(0,i.kt)("strong",{parentName:"p"},"including")," relevant ones."),(0,i.kt)("p",null,"At the end of the process, you will be ready to create a ",(0,i.kt)("a",{parentName:"p",href:"/compose-docs/guide/glossary#studyset"},(0,i.kt)("strong",{parentName:"a"},"Studyset"))," of related studies that are amenable for neuroimaging meta-analysis"),(0,i.kt)("h2",{id:"getting-started"},"Getting Started"),(0,i.kt)("p",null,"The curation interface uses columns as a way to label studies based on their current status.\nThe left most column is the starting point and all studies imported into the project will begin there.\nThe right most column is the ",(0,i.kt)("strong",{parentName:"p"},"inclusion column")," and is the place where studies will go to be included in the meta-analysis."),(0,i.kt)("p",null,'The goal is to get studies from the left most starting column, and narrow them down to a final subset of included studies in the right most column.\nIf a study is not eligible for inclusion at any point, it should be marked as "excluded" before reaching the inclusion column.'),(0,i.kt)("p",null,"The curation step is complete when all studies have been categorized, either by being included or excluded."),(0,i.kt)("p",null,"When you first begin ",(0,i.kt)("em",{parentName:"p"},"Curation"),", you will choose between different workflows, which vary in how rigorous or systematic the selection of studies will be."),(0,i.kt)("admonition",{title:"How specific to be?",type:"tip"},(0,i.kt)("p",{parentName:"admonition"},"Performing a systematic meta-analysis involves a substantial amount of effort. It is up to you, the researcher, how rigorous to be in this process. We reccomend thinking about your ",(0,i.kt)("em",{parentName:"p"},"goals")," prior to starting this process so that you can have clear inclusion guidelines. If you are looking for an exploratory analysis, we reccomend following the tutorial for ",(0,i.kt)("em",{parentName:"p"},"automated meta-analysis"),", which replaces manual curation with an automated selection of studies. Note that automated meta-analyses are not a replacement for a careful systematic meta-analysis.")),(0,i.kt)("h3",{id:"prisma-workflow"},"PRISMA Workflow"),(0,i.kt)("p",null,"PRISMA stands for the ",(0,i.kt)("strong",{parentName:"p"},"Preferred Reporting Items for Systematic Review and Meta-Analyses"),". The\n",(0,i.kt)("a",{parentName:"p",href:"http://www.prisma-statement.org/?AspxAutoDetectCookieSupport=1"},"PRISMA guidelines")," are a set of rules for reporting a\nsystematic review, and are the gold standard for producing a proper, rigorous, and transparent meta-analysis."),(0,i.kt)("p",null,"If you are trying to create a rigorous ",(0,i.kt)("a",{parentName:"p",href:"/compose-docs/tutorial/manual"},"PRISMA compliant manual meta-analysis")," you will want to select this option."),(0,i.kt)("p",null,"When you select this option, neurosynth-compose will automatically initialize the curation step with 4 distinct columns as\ndictated by PRISMA guidelines: ",(0,i.kt)("strong",{parentName:"p"},"Identification, Screening, Eligibility, Included"),"."),(0,i.kt)("p",null,"After importing studies into neurosynth, they will be placed into the identification column and studies are triaged from there."),(0,i.kt)("admonition",{title:"PRISMA Summary",type:"info"},(0,i.kt)("p",{parentName:"admonition"},"The ",(0,i.kt)("strong",{parentName:"p"},"Identification")," column is where all imported studies are deposited into initially. As alluded to by the name, the identification\ncolumn is where you identify all records yielded from your search. In this column, you wil exclude studies purely based on whether they are\nduplicates of existing studies. All other studies are promoted."),(0,i.kt)("p",{parentName:"admonition"},"The ",(0,i.kt)("strong",{parentName:"p"},"Screening")," column consists of all records that have been screened for duplicates. In this column, you want to review the titles/abstracts of studies\nand exclude purely based on whether they are irrelevant to your research question or domain. All other studies are promoted."),(0,i.kt)("p",{parentName:"admonition"},"The ",(0,i.kt)("strong",{parentName:"p"},"Eligibility")," column consists of all records that have been screened for duplicates and irrelevant content. In this column, you want to\nreview the full text of studies and exclude based on whether the study described aligns with the standards of the meta-analysis itself. Reasons\nfor exclusion may include wrong setting, wrong patient population, wrong intervention, wrong paragdigm, etc."),(0,i.kt)("p",{parentName:"admonition"},"The ",(0,i.kt)("strong",{parentName:"p"},"Included")," column consists of all records that have passed previous levels of exclusion and can be considered for the next step of the project."),(0,i.kt)("p",{parentName:"admonition"},"For more information, consult the ",(0,i.kt)("a",{parentName:"p",href:"http://www.prisma-statement.org/?AspxAutoDetectCookieSupport=1"},"PRISMA guidelines"),".")),(0,i.kt)("h3",{id:"simple-workflow"},"Simple Workflow"),(0,i.kt)("p",null,"If you want to create a semi-automated meta-analysis (i.e. perform manual review on a large-scale study search), you'll want to select this option."),(0,i.kt)("p",null,"This workflow is initalized with only two columns. As before, the left most column is where studies will be placed when they are imported. However, unlike a full PRISMA workflow, all exclusion occurs in this column. All studies not excluded are then promoted to the right most column for inclusion into the meta-analysis."),(0,i.kt)("h2",{id:"importing"},"Importing"),(0,i.kt)("p",null,"To begin importing studies into your project click the ",(0,i.kt)("strong",{parentName:"p"},"IMPORT STUDIES")," button."),(0,i.kt)("p",null,"You will be asked to choose an import method, source, name for your import, and finally address\nany potential duplicate studies."),(0,i.kt)("admonition",{type:"tip"},(0,i.kt)("p",{parentName:"admonition"},"We recommend giving each import a meaningful name. This will be useful when you come back\nand want to know where a certain study was imported from.")),(0,i.kt)("h3",{id:"import-method-1-import-from-neurostore"},"Import Method 1: Import from Neurostore"),(0,i.kt)("p",null,"Neurostore indexes a large number of neuroimaging studies which are ready for meta-analysis. Studies in Neurostore have been pre-processed, including extracting peak activation coordinates from Tables in the text, and computing semantic features from the abstract/full text. Neurostore also indexes studies which other users have annotated and made available to others for re-use."),(0,i.kt)("p",null,"Importing from Neurostore utilizes the Study search UI similar to the ",(0,i.kt)("a",{parentName:"p",href:"https://compose.neurosynth.org/studies"},"Study Page"),".\nAfter entering your search, click the bottom right button to import the searched studies into your project."),(0,i.kt)("admonition",{type:"tip"},(0,i.kt)("p",{parentName:"admonition"},"Importing from Neurostore can save you a lot of time, as these studies are much more likely to be amenable to meta-analysis, and have pre-extracted coordinates. However, note that some manual annotation may still be required to verify the coordinate extraction, and choose the relevant Analysis (i.e. contrast) for final inclusion.")),(0,i.kt)("h3",{id:"import-method-2-import-from-pubmed"},"Import Method 2: Import from PubMed"),(0,i.kt)("p",null,"Use this option to import studies directly from PubMed. To start, you need to go to the ",(0,i.kt)("a",{parentName:"p",href:"https://pubmed.ncbi.nlm.nih.gov/"},"PubMed Site"),"\nand either enter in a search or navigate to a previously created collection."),(0,i.kt)("p",null,"To import the search or collection from PubMed into neurosynth-compose, you will need a text file containing a list of PMIDs.\nYou can obtain this by going to your collection/search and clicking the ",(0,i.kt)("strong",{parentName:"p"},"Save")," button. Set ",(0,i.kt)("strong",{parentName:"p"},"Selection")," to ",(0,i.kt)("strong",{parentName:"p"},"All results"),"\nand set ",(0,i.kt)("strong",{parentName:"p"},"Format")," to ",(0,i.kt)("strong",{parentName:"p"},"PMID"),". Click ",(0,i.kt)("strong",{parentName:"p"},"Create file")," and your text file containing the PMIDs will be generated and downloaded."),(0,i.kt)("admonition",{type:"caution"},(0,i.kt)("p",{parentName:"admonition"},"Neurosynth-Compose uses the PubMed API to import studies. As a result, the maximum number of PMIDs that can be imported at once is 1,500.\nIf your collection has more than 1,500 PMIDs, split the import into multiple files. You can select the same import name so that they are all grouped together.")),(0,i.kt)("h3",{id:"import-method-3-import-from-bibtexrisendnote"},"Import Method 3: Import from BibTex/RIS/endnote"),(0,i.kt)("p",null,"Use this option to import studies via a .bib, .RIS, or .enw file. This may be useful if you want to import from a citation manager like Zotero."),(0,i.kt)("h3",{id:"import-method-4-custom-studies"},"Import Method 4: Custom Studies"),(0,i.kt)("p",null,"If there is any record that cannot be easily imported using one of the methods listed above, you can also manually create a study. This may be necessary\nto include resources like unpublished studies."),(0,i.kt)("h3",{id:"sleuth-files"},"Sleuth files"),(0,i.kt)("p",null,"At the moment, it's not possible to add studies from a sleuth file into an ",(0,i.kt)("em",{parentName:"p"},"existing project"),". To create a new project from a sleuth file, ",(0,i.kt)("a",{parentName:"p",href:"/compose-docs/guide/glossary#studyset"},"read more here"),"."),(0,i.kt)("h3",{id:"duplicates"},"Duplicates"),(0,i.kt)("p",null,'If duplicates are detected in your import, you will be asked how to reconcile them by choosing which of the studies to keep by choosing "KEEP THIS STUDY". Matching duplicates will be automatically marked for exclusion. Note that as a user, you can override any of these selections at any time, and choose which studies to keep or exclude.'),(0,i.kt)("admonition",{type:"info"},(0,i.kt)("p",{parentName:"admonition"},(0,i.kt)("em",{parentName:"p"},"Neurosynth Compose does not delete studies"),". If a study is marked as a duplicate, it is marked as ",(0,i.kt)("strong",{parentName:"p"},"excluded")," but it is not discarded to ensure complete provenance.")),(0,i.kt)("p",null,"There are two potential ways that duplicates can occur:"),(0,i.kt)("h4",{id:"duplicates-are-detected-between-the-studies-being-imported-and-the-studies-already-in-the-project"},"Duplicates are detected between the studies being imported and the studies already in the project"),(0,i.kt)("p",null,"If any study being important has the same title, PMID, or DOI is the same as\none already in the project, you will be asked reconcile these duplicates."),(0,i.kt)("p",null,'Note that if you mark a study that is already promoted as a duplicate, it will be "demoted" back to the first column and marked as "duplicate". It is reccomended to mark as duplicate the incoming study to avoid this.'),(0,i.kt)("h4",{id:"duplicates-are-detected-within-the-file-you-are-importing"},"Duplicates are detected within the file you are importing"),(0,i.kt)("p",null,"Although rare, it is possible to have duplicates within a given import. For example, if within a RIS file there are duplicate entries. In this case, you will be asked to select which study to keep. Studies marked as duplicates will still be imported but marked as excluded."),(0,i.kt)("h2",{id:"excluding-and-promoting-studies"},"Excluding and Promoting Studies"),(0,i.kt)("p",null,"Once studies have been imported into the first column of the curation phase, they need to be reviewed for inclusion into your meta-analysis.\nAll studies must be either excluded or moved to the inclusion column in order to progress to the extraction phase."),(0,i.kt)("p",null,"To begin, either click on the button at the top of the column or click on any study in the column. This will open up a page which will show the study\nalong with the following options: ",(0,i.kt)("strong",{parentName:"p"},"PROMOTE, NEEDS REVIEW"),", and ",(0,i.kt)("strong",{parentName:"p"},"EXCLUDE"),". There is also a button to ",(0,i.kt)("strong",{parentName:"p"},"ADD TAGS")," which will assign an informational tag to the study. This informational tag is a tool that allows you to mark studies with certain information - once an informational tag is created, you can filter by those tags."),(0,i.kt)("h3",{id:"exclude"},"Exclude"),(0,i.kt)("p",null,"To exclude a study, click the ",(0,i.kt)("strong",{parentName:"p"},"EXCLUDE")," button and select the exclusion reason. You can either choose from the preset exclusion reasons or you can begin\ntyping to create a new one."),(0,i.kt)("admonition",{type:"tip"},(0,i.kt)("p",{parentName:"admonition"},"For the PRISMA workflow, the default exclusion reason wil depend on the phase you are in (identification vs screening vs eligibility), to match the PRISMA guidelines. While we do not recommend it, you can click the arrow button and start typing in the input to create a new exclusion reason.\nRevisit the ",(0,i.kt)("a",{parentName:"p",href:"./Curation#prisma-workflow"},"PRISMA workflow")," to review reccomended exclusion criteria.")),(0,i.kt)("h3",{id:"promote"},"Promote"),(0,i.kt)("p",null,"If a study meets inclusion critera (for the current phase), click ",(0,i.kt)("strong",{parentName:"p"},"PROMOTE")," to move the study forward to the next curation column. If it is moved into the right most inclusion column, then it will be included in the meta-analysis."),(0,i.kt)("admonition",{type:"tip"},(0,i.kt)("p",{parentName:"admonition"},"For the first column (especially in a PRISMA workflow) it can be tedious to promote non-duplicates to the next column. If all duplicates have been resolved, you can exit the dialog and click ",(0,i.kt)("strong",{parentName:"p"},"PROMOTE ALL UNCATEGORIZED STUDIES")," to advance all non-duplicate studies to the next column.")),(0,i.kt)("h2",{id:"downloading-included-studies"},"Downloading included studies"),(0,i.kt)("p",null,'In order to download the studies that you have included in Curation, you can utilize our download feature. Go to curation and click "Download Included as CSV". Alternatively, you can click the dropdown and download the included studies in BibTeX format instead.'),(0,i.kt)("h2",{id:"on-to-extraction"},"On to Extraction"),(0,i.kt)("p",null,"When you have categorized all imported studies by either excluding them or moving them to the inclusion column, then you have\nsuccessfully completed the curation portion of the meta-analysis."),(0,i.kt)("p",null,(0,i.kt)("em",{parentName:"p"},"Neurosynth Compose")," will detect this and reveal a new button: ",(0,i.kt)("strong",{parentName:"p"},"MOVE TO EXTRACTION PHASE"),". This will move you back to the project page and get you started on the next major component to building your meta-analysis: ",(0,i.kt)("a",{parentName:"p",href:"./Extraction"},"extraction"),"."))}p.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/b0bf1abf.912af714.js b/assets/js/b0bf1abf.912af714.js new file mode 100644 index 0000000..bd3b283 --- /dev/null +++ b/assets/js/b0bf1abf.912af714.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[3078],{3905:(e,t,a)=>{a.d(t,{Zo:()=>p,kt:()=>y});var r=a(7294);function o(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function n(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,r)}return a}function s(e){for(var t=1;t=0||(o[a]=e[a]);return o}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(o[a]=e[a])}return o}var l=r.createContext({}),u=function(e){var t=r.useContext(l),a=t;return e&&(a="function"==typeof e?e(t):s(s({},t),e)),a},p=function(e){var t=u(e.components);return r.createElement(l.Provider,{value:t},e.children)},m="mdxType",c={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},d=r.forwardRef((function(e,t){var a=e.components,o=e.mdxType,n=e.originalType,l=e.parentName,p=i(e,["components","mdxType","originalType","parentName"]),m=u(a),d=o,y=m["".concat(l,".").concat(d)]||m[d]||c[d]||n;return a?r.createElement(y,s(s({ref:t},p),{},{components:a})):r.createElement(y,s({ref:t},p))}));function y(e,t){var a=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var n=a.length,s=new Array(n);s[0]=d;var i={};for(var l in t)hasOwnProperty.call(t,l)&&(i[l]=t[l]);i.originalType=e,i[m]="string"==typeof e?e:o,s[1]=i;for(var u=2;u{a.r(t),a.d(t,{assets:()=>l,contentTitle:()=>s,default:()=>c,frontMatter:()=>n,metadata:()=>i,toc:()=>u});var r=a(7462),o=(a(7294),a(3905));const n={sidebar_label:"Ecosystem",sidebar_position:4},s="Ecosystem for fMRI Meta-Analysis",i={unversionedId:"introduction/ecosystem",id:"introduction/ecosystem",title:"Ecosystem for fMRI Meta-Analysis",description:"ecosystem",source:"@site/docs/introduction/ecosystem.md",sourceDirName:"introduction",slug:"/introduction/ecosystem",permalink:"/compose-docs/introduction/ecosystem",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/introduction/ecosystem.md",tags:[],version:"current",lastUpdatedBy:"Alejandro de la Vega",lastUpdatedAt:1729891615,formattedLastUpdatedAt:"Oct 25, 2024",sidebarPosition:4,frontMatter:{sidebar_label:"Ecosystem",sidebar_position:4},sidebar:"tutorialSidebar",previous:{title:"Our Team",permalink:"/compose-docs/introduction/team"},next:{title:"User Guide",permalink:"/compose-docs/guide/"}},l={},u=[{value:"Neurosynth Compose",id:"neurosynth-compose",level:2},{value:"NeuroStore",id:"neurostore",level:2},{value:"NiMARE",id:"nimare",level:2},{value:"PyMARE",id:"pymare",level:3},{value:"NIMADS",id:"nimads",level:3},{value:"NeuroQuery",id:"neuroquery",level:2},{value:"NeuroVault",id:"neurovault",level:2}],p={toc:u},m="wrapper";function c(e){let{components:t,...n}=e;return(0,o.kt)(m,(0,r.Z)({},p,n,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"ecosystem-for-fmri-meta-analysis"},"Ecosystem for fMRI Meta-Analysis"),(0,o.kt)("p",null,(0,o.kt)("img",{alt:"ecosystem",src:a(6089).Z,title:"Neurosynth Compose Ecosystem",width:"452",height:"500"})),(0,o.kt)("p",null,(0,o.kt)("em",{parentName:"p"},"Neurosynth Compose")," is part of a broader set of tools for neuroimaging meta-analysis, with complementary roles."),(0,o.kt)("h2",{id:"neurosynth-compose"},"Neurosynth Compose"),(0,o.kt)("p",null,"Neurosynth-Compose is the evolution of the original ",(0,o.kt)("a",{parentName:"p",href:"https://neurosynth.org"},"Neurosynth")," project."),(0,o.kt)("p",null,"In ",(0,o.kt)("em",{parentName:"p"},"Neurosynth 1.0"),", we developed a web platform for users to browse a large set of pre-computed meta-analyses\nsynthesizing findings across 14,000+ fMRI studies. The philosophy was to leverage\nlarge scale meta-analysis to provide new insights into the literature, overcoming limitations of database\nwith sheer scale. With regular updates, Neurosynth was able to keep up with the growth of the literature.\nThe database was released with a permissive license, and accompanied by a Python package to manipulate and analyze it. "),(0,o.kt)("p",null,"Although this approach was surprisingly successful, there were several major limitations to Neurosynth 1.0:"),(0,o.kt)("ul",null,(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("p",{parentName:"li"},"Meta-analyses were limited by ",(0,o.kt)("strong",{parentName:"p"},"concepts that can be inferred from large scale text mining")," (i.e. frequency of terms in the text).\nAlthough these features proved to be surprisingly useful for well-powered and broad cognitive constructs (e.g. 'emotion'), Neurosynth was not able\nto capture the fine-grained details of the neuroimaging literature, or allow users to define their own grouping of studies. ")),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("p",{parentName:"li"},"The database is not curated, and therefore contains many ",(0,o.kt)("strong",{parentName:"p"},"inaccuracies and incomplete")," data at both the study and coordinate level.\nAside from obvious extraction errors, automated coordinate extraction lacks the ability to determine critical information, such as whether the activation is positive or negative.\nIn addition, it's not possible to segregate the coordinates into distinct contrast, conditions, or studies without manual curation.")),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("p",{parentName:"li"},"Coordinate-based analyses are inherently ",(0,o.kt)("strong",{parentName:"p"},"inferior to image-based")," meta-analysis, which is becoming increasingly possible with sharing of unthresholded statistical maps in repositories like ",(0,o.kt)("a",{parentName:"p",href:"https://neurovault.org/"},"NeuroVault"),"."))),(0,o.kt)("p",null,(0,o.kt)("em",{parentName:"p"},"Neurosynth Compose")," aims to address these limitations:"),(0,o.kt)("ul",null,(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("p",{parentName:"li"},"Provides a web-based platform for meta-analytic neuroimaging research, allowing users to ",(0,o.kt)("strong",{parentName:"p"},"curate studies"),", and ",(0,o.kt)("strong",{parentName:"p"},"specify meta-analytic models"),". ")),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("p",{parentName:"li"},(0,o.kt)("strong",{parentName:"p"},"Flexible and easy to use"),", allowing users to perform both large-scale ",(0,o.kt)("strong",{parentName:"p"},"exploratory")," meta-analyses, as well as ",(0,o.kt)("strong",{parentName:"p"},"targeted, hypothesis-driven")," meta-analyses that conform to stringent standards such as the ",(0,o.kt)("a",{parentName:"p",href:"https://prisma-statement.org"},"PRISMA")," statement.")),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("p",{parentName:"li"},"Allows users to perfom ",(0,o.kt)("strong",{parentName:"p"},"image-based meta-analysis")," using unthresholded images from NeuroVault (in progress).")),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("p",{parentName:"li"},"Quick, reproducible and transparent ",(0,o.kt)("strong",{parentName:"p"},"sharing of results"),".")),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("p",{parentName:"li"},"Incentivizes ",(0,o.kt)("strong",{parentName:"p"},"collaborative curation")," of neuroimaging studies in a accessible ",(0,o.kt)("strong",{parentName:"p"},"centralized repository")," (NeuroStore, see below)."))),(0,o.kt)("h2",{id:"neurostore"},"NeuroStore"),(0,o.kt)("p",null,(0,o.kt)("a",{parentName:"p",href:"https://github.com/neurostuff/neurostore"},"NeuroStore")," is the centralized repository for neuroimaging data amenable to meta-analysis, including coordinates, images, and metadata.\nNeuroStore serves as the data backend for Neurosynth Compose, but is also designed to be a standalone interoperable resource for the neuroimaging community."),(0,o.kt)("p",null,"NeuroStore ingests data from a number of sources, including NeuroVault, NeuroQuery, and Neurosynth (ACE), and provides a unified API for querying the database."),(0,o.kt)("p",null,"Importantly, data on NeuroStore can be ",(0,o.kt)("strong",{parentName:"p"},"curated")," the community, allowing users to correct errors in coordinate extraction, and add new studies and coordinates. By providing a centralized repository for curated neuroimaging data, NeuroStore aims to facilitate the development of new meta-analytic tools, and to provide a common data format for the neuroimaging community."),(0,o.kt)("h2",{id:"nimare"},"NiMARE"),(0,o.kt)("p",null,(0,o.kt)("a",{parentName:"p",href:"https://nimare.readthedocs.io/en/latest/"},"NiMARE")," (Neuroimaging Meta-Analysis Research Environment) is a Python package for performing neuroimaging meta-analysis. "),(0,o.kt)("p",null,"NiMARE is an open source, collaboratively-developed package that implements a range of meta-analytic algorithms, including coordinate- and image-based meta-analyses, automated annotation, functional decoding, and meta-analytic coactivation modeling. "),(0,o.kt)("p",null,"By consolidating meta-analytic methods under a common library and syntax, NiMARE makes it straightforward for users to employ the appropriate approach for a given analysis. "),(0,o.kt)("p",null,"NeuroSynth Compose uses NiMARE to execute meta-analyses, by exporting datasets in the common NIMADS format (see below), and specifying reproducible NiMARE workflows for common meta-analytic models."),(0,o.kt)("h3",{id:"pymare"},"PyMARE"),(0,o.kt)("p",null,(0,o.kt)("a",{parentName:"p",href:"https://pymare.readthedocs.io/en/latest/"},"PyMARE")," is a Python library for effect-size meta-analysis. NiMARE uses PyMARE for its image-based meta-analysis algorithms\n(with some light wrapping to convert image objects to arrays compatible with PyMARE functions)."),(0,o.kt)("h3",{id:"nimads"},"NIMADS"),(0,o.kt)("p",null,(0,o.kt)("a",{parentName:"p",href:"https://github.com/neurostuff/NIMADS"},"NIMADS")," is a new standard for organizing and representing meta-analytic neuroimaging data.\nNIMADS is used as a common, interoperable format by NeuroStore, pyNIMADS, and NiMARE."),(0,o.kt)("h2",{id:"neuroquery"},"NeuroQuery"),(0,o.kt)("p",null,(0,o.kt)("a",{parentName:"p",href:"https://neuroquery.org"},"NeuroQuery")," is a web service, Python library, and coordinate database built for large-scale, predictive meta-analysis.\nPredictive meta-analysis generates non-statistical brain maps from text, using a database of coordinates and associated texts."),(0,o.kt)("p",null,"The ",(0,o.kt)("a",{parentName:"p",href:"https://github.com/neuroquery/neuroquery_data"},"NeuroQuery dataset")," is accurate and maintainable than the existing Neurosynth 1.0 database,\nthis new database will effectively replace the old one within the meta-analytic ecosystem.\nNiMARE can ingest the NeuroQuery database and convert it automatically to a NiMARE Dataset object for analysis.\nAdditionally, the NeuroQuery database will feed directly into NeuroStore as a source of coordinates."),(0,o.kt)("h2",{id:"neurovault"},"NeuroVault"),(0,o.kt)("p",null,(0,o.kt)("a",{parentName:"p",href:"https://neurovault.org/"},"NeuroVault")," is a repository for unthresholded statistical maps from neuroimaging studies."),(0,o.kt)("p",null,"As of early 2023, NeuroVault contains over 8,000 collections of statistical images, with over 100,000 images in total.\nIt is the largest repository of unthresholded statistical maps in the world, and is the primary source of data for image-based meta-analyses using\nNeurosynth Compose."),(0,o.kt)("p",null,"Currently, NeuroVault supports some basic meta-analytic functionality. However, as other tools in this ecosystem are developed,\nit is planned that NeuroVault will focus exclusively on image storage and sharing, and will rely on other tools for meta-analysis."))}c.isMDXComponent=!0},6089:(e,t,a)=>{a.d(t,{Z:()=>r});const r=a.p+"assets/images/compose_ecosystem_paths-f815833d6a398e3ecc658357ab4663b5.svg"}}]); \ No newline at end of file diff --git a/assets/js/b0bf1abf.aa8f9ddc.js b/assets/js/b0bf1abf.aa8f9ddc.js deleted file mode 100644 index 7eb112d..0000000 --- a/assets/js/b0bf1abf.aa8f9ddc.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[3078],{3905:(e,t,a)=>{a.d(t,{Zo:()=>p,kt:()=>y});var r=a(7294);function o(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function n(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,r)}return a}function s(e){for(var t=1;t=0||(o[a]=e[a]);return o}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(o[a]=e[a])}return o}var l=r.createContext({}),u=function(e){var t=r.useContext(l),a=t;return e&&(a="function"==typeof e?e(t):s(s({},t),e)),a},p=function(e){var t=u(e.components);return r.createElement(l.Provider,{value:t},e.children)},m="mdxType",c={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},d=r.forwardRef((function(e,t){var a=e.components,o=e.mdxType,n=e.originalType,l=e.parentName,p=i(e,["components","mdxType","originalType","parentName"]),m=u(a),d=o,y=m["".concat(l,".").concat(d)]||m[d]||c[d]||n;return a?r.createElement(y,s(s({ref:t},p),{},{components:a})):r.createElement(y,s({ref:t},p))}));function y(e,t){var a=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var n=a.length,s=new Array(n);s[0]=d;var i={};for(var l in t)hasOwnProperty.call(t,l)&&(i[l]=t[l]);i.originalType=e,i[m]="string"==typeof e?e:o,s[1]=i;for(var u=2;u{a.r(t),a.d(t,{assets:()=>l,contentTitle:()=>s,default:()=>c,frontMatter:()=>n,metadata:()=>i,toc:()=>u});var r=a(7462),o=(a(7294),a(3905));const n={sidebar_label:"Ecosystem",sidebar_position:4},s="Ecosystem for fMRI Meta-Analysis",i={unversionedId:"introduction/ecosystem",id:"introduction/ecosystem",title:"Ecosystem for fMRI Meta-Analysis",description:"ecosystem",source:"@site/docs/introduction/ecosystem.md",sourceDirName:"introduction",slug:"/introduction/ecosystem",permalink:"/compose-docs/introduction/ecosystem",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/introduction/ecosystem.md",tags:[],version:"current",lastUpdatedBy:"James Kent",lastUpdatedAt:1727371503,formattedLastUpdatedAt:"Sep 26, 2024",sidebarPosition:4,frontMatter:{sidebar_label:"Ecosystem",sidebar_position:4},sidebar:"tutorialSidebar",previous:{title:"Our Team",permalink:"/compose-docs/introduction/team"},next:{title:"User Guide",permalink:"/compose-docs/guide/"}},l={},u=[{value:"Neurosynth Compose",id:"neurosynth-compose",level:2},{value:"NeuroStore",id:"neurostore",level:2},{value:"NiMARE",id:"nimare",level:2},{value:"PyMARE",id:"pymare",level:3},{value:"NIMADS",id:"nimads",level:3},{value:"NeuroQuery",id:"neuroquery",level:2},{value:"NeuroVault",id:"neurovault",level:2}],p={toc:u},m="wrapper";function c(e){let{components:t,...n}=e;return(0,o.kt)(m,(0,r.Z)({},p,n,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"ecosystem-for-fmri-meta-analysis"},"Ecosystem for fMRI Meta-Analysis"),(0,o.kt)("p",null,(0,o.kt)("img",{alt:"ecosystem",src:a(6089).Z,title:"Neurosynth Compose Ecosystem",width:"452",height:"500"})),(0,o.kt)("p",null,(0,o.kt)("em",{parentName:"p"},"Neurosynth Compose")," is part of a broader set of tools for neuroimaging meta-analysis, with complementary roles."),(0,o.kt)("h2",{id:"neurosynth-compose"},"Neurosynth Compose"),(0,o.kt)("p",null,"Neurosynth-Compose is the evolution of the original ",(0,o.kt)("a",{parentName:"p",href:"https://neurosynth.org"},"Neurosynth")," project."),(0,o.kt)("p",null,"In ",(0,o.kt)("em",{parentName:"p"},"Neurosynth 1.0"),", we developed a web platform for users to browse a large set of pre-computed meta-analyses\nsynthesizing findings across 14,000+ fMRI studies. The philosophy was to leverage\nlarge scale meta-analysis to provide new insights into the literature, overcoming limitations of database\nwith sheer scale. With regular updates, Neurosynth was able to keep up with the growth of the literature.\nThe database was released with a permissive license, and accompanied by a Python package to manipulate and analyze it. "),(0,o.kt)("p",null,"Although this approach was surprisingly successful, there were several major limitations to Neurosynth 1.0:"),(0,o.kt)("ul",null,(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("p",{parentName:"li"},"Meta-analyses were limited by ",(0,o.kt)("strong",{parentName:"p"},"concepts that can be inferred from large scale text mining")," (i.e. frequency of terms in the text).\nAlthough these features proved to be surprisingly useful for well-powered and broad cognitive constructs (e.g. 'emotion'), Neurosynth was not able\nto capture the fine-grained details of the neuroimaging literature, or allow users to define their own grouping of studies. ")),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("p",{parentName:"li"},"The database is not curated, and therefore contains many ",(0,o.kt)("strong",{parentName:"p"},"inaccuracies and incomplete")," data at both the study and coordinate level.\nAside from obvious extraction errors, automated coordinate extraction lacks the ability to determine critical information, such as whether the activation is positive or negative.\nIn addition, it's not possible to segregate the coordinates into distinct contrast, conditions, or studies without manual curation.")),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("p",{parentName:"li"},"Coordinate-based analyses are inherently ",(0,o.kt)("strong",{parentName:"p"},"inferior to image-based")," meta-analysis, which is becoming increasingly possible with sharing of unthresholded statistical maps in repositories like ",(0,o.kt)("a",{parentName:"p",href:"https://neurovault.org/"},"NeuroVault"),"."))),(0,o.kt)("p",null,(0,o.kt)("em",{parentName:"p"},"Neurosynth Compose")," aims to address these limitations:"),(0,o.kt)("ul",null,(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("p",{parentName:"li"},"Provides a web-based platform for meta-analytic neuroimaging research, allowing users to ",(0,o.kt)("strong",{parentName:"p"},"curate studies"),", and ",(0,o.kt)("strong",{parentName:"p"},"specify meta-analytic models"),". ")),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("p",{parentName:"li"},(0,o.kt)("strong",{parentName:"p"},"Flexible and easy to use"),", allowing users to perform both large-scale ",(0,o.kt)("strong",{parentName:"p"},"exploratory")," meta-analyses, as well as ",(0,o.kt)("strong",{parentName:"p"},"targeted, hypothesis-driven")," meta-analyses that conform to stringent standards such as the ",(0,o.kt)("a",{parentName:"p",href:"https://prisma-statement.org"},"PRISMA")," statement.")),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("p",{parentName:"li"},"Allows users to perfom ",(0,o.kt)("strong",{parentName:"p"},"image-based meta-analysis")," using unthresholded images from NeuroVault (in progress).")),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("p",{parentName:"li"},"Quick, reproducible and transparent ",(0,o.kt)("strong",{parentName:"p"},"sharing of results"),".")),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("p",{parentName:"li"},"Incentivizes ",(0,o.kt)("strong",{parentName:"p"},"collaborative curation")," of neuroimaging studies in a accessible ",(0,o.kt)("strong",{parentName:"p"},"centralized repository")," (NeuroStore, see below)."))),(0,o.kt)("h2",{id:"neurostore"},"NeuroStore"),(0,o.kt)("p",null,(0,o.kt)("a",{parentName:"p",href:"https://github.com/neurostuff/neurostore"},"NeuroStore")," is the centralized repository for neuroimaging data amenable to meta-analysis, including coordinates, images, and metadata.\nNeuroStore serves as the data backend for Neurosynth Compose, but is also designed to be a standalone interoperable resource for the neuroimaging community."),(0,o.kt)("p",null,"NeuroStore ingests data from a number of sources, including NeuroVault, NeuroQuery, and Neurosynth (ACE), and provides a unified API for querying the database."),(0,o.kt)("p",null,"Importantly, data on NeuroStore can be ",(0,o.kt)("strong",{parentName:"p"},"curated")," the community, allowing users to correct errors in coordinate extraction, and add new studies and coordinates. By providing a centralized repository for curated neuroimaging data, NeuroStore aims to facilitate the development of new meta-analytic tools, and to provide a common data format for the neuroimaging community."),(0,o.kt)("h2",{id:"nimare"},"NiMARE"),(0,o.kt)("p",null,(0,o.kt)("a",{parentName:"p",href:"https://nimare.readthedocs.io/en/latest/"},"NiMARE")," (Neuroimaging Meta-Analysis Research Environment) is a Python package for performing neuroimaging meta-analysis. "),(0,o.kt)("p",null,"NiMARE is an open source, collaboratively-developed package that implements a range of meta-analytic algorithms, including coordinate- and image-based meta-analyses, automated annotation, functional decoding, and meta-analytic coactivation modeling. "),(0,o.kt)("p",null,"By consolidating meta-analytic methods under a common library and syntax, NiMARE makes it straightforward for users to employ the appropriate approach for a given analysis. "),(0,o.kt)("p",null,"NeuroSynth Compose uses NiMARE to execute meta-analyses, by exporting datasets in the common NIMADS format (see below), and specifying reproducible NiMARE workflows for common meta-analytic models."),(0,o.kt)("h3",{id:"pymare"},"PyMARE"),(0,o.kt)("p",null,(0,o.kt)("a",{parentName:"p",href:"https://pymare.readthedocs.io/en/latest/"},"PyMARE")," is a Python library for effect-size meta-analysis. NiMARE uses PyMARE for its image-based meta-analysis algorithms\n(with some light wrapping to convert image objects to arrays compatible with PyMARE functions)."),(0,o.kt)("h3",{id:"nimads"},"NIMADS"),(0,o.kt)("p",null,(0,o.kt)("a",{parentName:"p",href:"https://github.com/neurostuff/NIMADS"},"NIMADS")," is a new standard for organizing and representing meta-analytic neuroimaging data.\nNIMADS is used as a common, interoperable format by NeuroStore, pyNIMADS, and NiMARE."),(0,o.kt)("h2",{id:"neuroquery"},"NeuroQuery"),(0,o.kt)("p",null,(0,o.kt)("a",{parentName:"p",href:"https://neuroquery.org"},"NeuroQuery")," is a web service, Python library, and coordinate database built for large-scale, predictive meta-analysis.\nPredictive meta-analysis generates non-statistical brain maps from text, using a database of coordinates and associated texts."),(0,o.kt)("p",null,"The ",(0,o.kt)("a",{parentName:"p",href:"https://github.com/neuroquery/neuroquery_data"},"NeuroQuery dataset")," is accurate and maintainable than the existing Neurosynth 1.0 database,\nthis new database will effectively replace the old one within the meta-analytic ecosystem.\nNiMARE can ingest the NeuroQuery database and convert it automatically to a NiMARE Dataset object for analysis.\nAdditionally, the NeuroQuery database will feed directly into NeuroStore as a source of coordinates."),(0,o.kt)("h2",{id:"neurovault"},"NeuroVault"),(0,o.kt)("p",null,(0,o.kt)("a",{parentName:"p",href:"https://neurovault.org/"},"NeuroVault")," is a repository for unthresholded statistical maps from neuroimaging studies."),(0,o.kt)("p",null,"As of early 2023, NeuroVault contains over 8,000 collections of statistical images, with over 100,000 images in total.\nIt is the largest repository of unthresholded statistical maps in the world, and is the primary source of data for image-based meta-analyses using\nNeurosynth Compose."),(0,o.kt)("p",null,"Currently, NeuroVault supports some basic meta-analytic functionality. However, as other tools in this ecosystem are developed,\nit is planned that NeuroVault will focus exclusively on image storage and sharing, and will rely on other tools for meta-analysis."))}c.isMDXComponent=!0},6089:(e,t,a)=>{a.d(t,{Z:()=>r});const r=a.p+"assets/images/compose_ecosystem_paths-f815833d6a398e3ecc658357ab4663b5.svg"}}]); \ No newline at end of file diff --git a/assets/js/b270851a.6ccdb5a8.js b/assets/js/b270851a.6ccdb5a8.js new file mode 100644 index 0000000..743eda8 --- /dev/null +++ b/assets/js/b270851a.6ccdb5a8.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[1854],{3905:(e,t,a)=>{a.d(t,{Zo:()=>m,kt:()=>y});var o=a(7294);function n(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function i(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,o)}return a}function r(e){for(var t=1;t=0||(n[a]=e[a]);return n}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(n[a]=e[a])}return n}var l=o.createContext({}),u=function(e){var t=o.useContext(l),a=t;return e&&(a="function"==typeof e?e(t):r(r({},t),e)),a},m=function(e){var t=u(e.components);return o.createElement(l.Provider,{value:t},e.children)},d="mdxType",c={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},p=o.forwardRef((function(e,t){var a=e.components,n=e.mdxType,i=e.originalType,l=e.parentName,m=s(e,["components","mdxType","originalType","parentName"]),d=u(a),p=n,y=d["".concat(l,".").concat(p)]||d[p]||c[p]||i;return a?o.createElement(y,r(r({ref:t},m),{},{components:a})):o.createElement(y,r({ref:t},m))}));function y(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var i=a.length,r=new Array(i);r[0]=p;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s[d]="string"==typeof e?e:n,r[1]=s;for(var u=2;u{a.r(t),a.d(t,{assets:()=>l,contentTitle:()=>r,default:()=>c,frontMatter:()=>i,metadata:()=>s,toc:()=>u});var o=a(7462),n=(a(7294),a(3905));const i={sidebar_label:"Automated Meta-Analysis",sidebar_position:2},r="Automated Meta-Analysis",s={unversionedId:"tutorial/automated",id:"tutorial/automated",title:"Automated Meta-Analysis",description:"How to create a fully automated meta-analysis",source:"@site/docs/tutorial/automated.md",sourceDirName:"tutorial",slug:"/tutorial/automated",permalink:"/compose-docs/tutorial/automated",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/tutorial/automated.md",tags:[],version:"current",lastUpdatedBy:"Alejandro de la Vega",lastUpdatedAt:1729891615,formattedLastUpdatedAt:"Oct 25, 2024",sidebarPosition:2,frontMatter:{sidebar_label:"Automated Meta-Analysis",sidebar_position:2},sidebar:"tutorialSidebar",previous:{title:"Manual Meta-Analysis",permalink:"/compose-docs/tutorial/manual"},next:{title:"Advanced tutorials",permalink:"/compose-docs/tutorial/advanced/"}},l={},u=[{value:"Why automated meta-analysis?",id:"why-automated-meta-analysis",level:2},{value:"Flexible automated meta-analysis in Neurosynth Compose",id:"flexible-automated-meta-analysis-in-neurosynth-compose",level:3},{value:"Tutorial",id:"tutorial",level:2},{value:"Search & Curate",id:"search--curate",level:3},{value:"Import from Neurostore",id:"import-from-neurostore",level:4},{value:"Promote studies",id:"promote-studies",level:4},{value:"Extraction and Annotation",id:"extraction-and-annotation",level:3},{value:"Specify Meta-Analyses",id:"specify-meta-analyses",level:3},{value:"Execute",id:"execute",level:3}],m={toc:u},d="wrapper";function c(e){let{components:t,...i}=e;return(0,n.kt)(d,(0,o.Z)({},m,i,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"automated-meta-analysis"},"Automated Meta-Analysis"),(0,n.kt)("p",null,(0,n.kt)("em",{parentName:"p"},"How to create a fully automated meta-analysis")),(0,n.kt)("admonition",{type:"caution"},(0,n.kt)("p",{parentName:"admonition"},"This tutorial, and the functionality for automated meta-analysis, is under construction.\nTo view existing automated meta-analyses, you can use ",(0,n.kt)("a",{parentName:"p",href:"https://neurosynth.org"},"Neurosynth Original"))),(0,n.kt)("h2",{id:"why-automated-meta-analysis"},"Why automated meta-analysis?"),(0,n.kt)("p",null,"The principal difference between an automated and a ",(0,n.kt)("a",{parentName:"p",href:"/compose-docs/tutorial/manual"},"manual meta-analysis")," is ",(0,n.kt)("em",{parentName:"p"},"the process used to select the final set of Studies and Analyses to include")," into your meta-analysis. "),(0,n.kt)("p",null,"In a ",(0,n.kt)("strong",{parentName:"p"},"manual meta-analysis"),", researchers cast a wide net to find a wide range of potentially relevant articles, and use their expertise (read: painstakingly review hundreds of articles) to decide which of articles are relevant to their research question. Our platform seeks streamline this process through a user-friendly interface and pre-extracted data for over 20,000 neuroimaging studies. Yet, ",(0,n.kt)("strong",{parentName:"p"},"a gold standard meta-analysis still requires a significant time investment"),", limiting their application in routine scientific practice."),(0,n.kt)("p",null,"In an ",(0,n.kt)("strong",{parentName:"p"},"automated meta-analysis"),", we instead use data-driven text mining metrics to ",(0,n.kt)("em",{parentName:"p"},"select")," articles. The original ",(0,n.kt)("em",{parentName:"p"},"Neurosynth")," pioneered this approach by developing text mining techniques to automatically extract brain coordinates and semantic text features from thousands of articles. "),(0,n.kt)("p",null,"Surprisingly, this works! For example, by meta-analyzing all studies that mention the term ",(0,n.kt)("a",{parentName:"p",href:"https://neurosynth.org/analyses/terms/emotional/"},'"emotional"')," above a certain frequency, we observe a strong association with activity in the amygdala. By and large, the sheer number of studies overcomes the inherent noisiness of automated data extraction and study selection. "),(0,n.kt)("h3",{id:"flexible-automated-meta-analysis-in-neurosynth-compose"},"Flexible automated meta-analysis in Neurosynth Compose"),(0,n.kt)("p",null,"Although automated meta-analyses have proved to be a useful tool, there are several limitations. The overall goal of ",(0,n.kt)("em",{parentName:"p"},"Neurosynth Compose")," is to give users a flexible data curation platform, to overcome these limitations using their expert knowledge. For example:"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("em",{parentName:"li"},"Flexible selection criteria.")," The original Neurosynth has a fixed number of terms and meta-analyses. With",(0,n.kt)("em",{parentName:"li"},"Neurosynth Compose")," you can flexibly search the NeuroStore database using a powerful and flexible search to precisely define your search criteria. "),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("em",{parentName:"li"},"Combine expert knowledge with automated selection.")," Automated study selection is inherently an noisy and imperfect measure. With ",(0,n.kt)("em",{parentName:"li"},"Neurosynth Compose"),", you can use automated study selection as a first pass, and later apply your own expert criteria to refine study inclusion criteria. "),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("em",{parentName:"li"},"Correct data extraction errors.")," Automated extraction can miss entire tables of coordinates (e.g. supplementary materials), duplicate coordinates, and groups distinct sets of Analyses (e.g. Contrasts) into a single group. Now, you can correct these data to make your meta-analysis more precise. ")),(0,n.kt)("h2",{id:"tutorial"},"Tutorial"),(0,n.kt)("p",null,"An automated meta-analysis in ",(0,n.kt)("em",{parentName:"p"},"Neurosynth Compose")," looks a lot like a manual one, except data curation is optional. We reccomeend following the ",(0,n.kt)("a",{parentName:"p",href:"/compose-docs/tutorial/manual"},"manual meta-analysis")," tutorial to learn in depth about our platform."),(0,n.kt)("h3",{id:"search--curate"},"Search & Curate"),(0,n.kt)("p",null,"One of the main differences between a ",(0,n.kt)("em",{parentName:"p"},"manual")," and ",(0,n.kt)("em",{parentName:"p"},"automated"),' meta-analysis, is the steps required to select studies. As such, we reccomeend selecting the "Simple" curation workflow, which only consists of a single data curation step (which is optional). '),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Simple Workflow",src:a(3594).Z,width:"2128",height:"923"}),". "),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},"Decide ahead of time if you want to perform a Coordinate or an Image based meta-analysis. Image-based Meta-Analysis (IBMA) is more precise and powerful, but there are much fewer studies available. ")),(0,n.kt)("h4",{id:"import-from-neurostore"},"Import from Neurostore"),(0,n.kt)("p",null,"Let's add studies to our curation board by clicking ",(0,n.kt)("strong",{parentName:"p"},"Import Studies"),".\nIn an automated meta-analysis, you'll want to select ",(0,n.kt)("em",{parentName:"p"},"Import via NeuroStore"),", as all indexed studies are guaranteed to contain imaging data (saving you from manual data extraction)."),(0,n.kt)("admonition",{type:"caution"},(0,n.kt)("p",{parentName:"admonition"},"Although the NeuroStore database is continuously growing, it is necessarily an incomplete snapshot of the neuroimaging literature")),(0,n.kt)("p",null,"Input any search term to narrow down studies. This will search the Title and Abstract fields. You may also add additional search filters using the ",(0,n.kt)("strong",{parentName:"p"},"+ Add Filter")," button, and ",(0,n.kt)("em",{parentName:"p"},"select the desired modality of the imaging data"),". "),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Neurostore Search",src:a(8506).Z,width:"1849",height:"1523"}),". "),(0,n.kt)("p",null,'To import your search, click "Import Studies From Neurostore" at the bottom right. Give your import a name to Tag all imported studies, and continue back to your Curation board. '),(0,n.kt)("admonition",{type:"note"},(0,n.kt)("p",{parentName:"admonition"},"You must import an entire set of search results into your curation board. If you want to exclude any specific studies, you will do so on your board. This allows the Search & Curate process to be fully reproducible.")),(0,n.kt)("h4",{id:"promote-studies"},"Promote studies"),(0,n.kt)("p",null,"Back to your Curation board, you will now see all studies from your NeuroStore search on the left most column."),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Curation board",src:a(761).Z,width:"2583",height:"1604"}),". "),(0,n.kt)("p",null,"At this point, you have two options: manually review the search results and select which studies to include, or perform a fully automated meta-analysis by including all search results. "),(0,n.kt)("p",null,"For this tutorial, we'll skip manual curation and ",(0,n.kt)("strong",{parentName:"p"},"Promote All Uncategorized Studies"),' to the right-most "Included" column. '),(0,n.kt)("p",null,"We can now click ",(0,n.kt)("em",{parentName:"p"},"Move to Extraction Phase"),"."),(0,n.kt)("h3",{id:"extraction-and-annotation"},"Extraction and Annotation"),(0,n.kt)("p",null,"At this point, you will create a StudySet containing all of your Studies. Advance through the dialog to begin ",(0,n.kt)("em",{parentName:"p"},"Extraction"),"."),(0,n.kt)("p",null,"The goal of this phase is to add or correct imaging data (e.g. Coordinates) in imported studies, and create Annotations to determine which Analyses (e.g. Contrasts), should be included in your meta-analysis."),(0,n.kt)("p",null,"Since we are performing a manual meta-analysis, we're going to skip these steps!"),(0,n.kt)("p",null,"From the main ",(0,n.kt)("em",{parentName:"p"},"Project"),' page, we can click "Mark All as Complete".'),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Skip Extraction",src:a(1599).Z,width:"1263",height:"855"}),". "),(0,n.kt)("admonition",{type:"tip"},(0,n.kt)("p",{parentName:"admonition"},"It's up to you if you want to skip this step. The validity of your meta-analysis is highly dependant on input data, so we only recommend skipping all curation for exploratory analyses.")),(0,n.kt)("h3",{id:"specify-meta-analyses"},"Specify Meta-Analyses"),(0,n.kt)("p",null,"You can now specify your meta-analysis. This step will be identical between automated and manual meta-analyses."),(0,n.kt)("p",null,'First, we select the "included" column, which by default includes ',(0,n.kt)("em",{parentName:"p"},"all")," Study Analyses as inputs."),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Inclusion column",src:a(8376).Z,width:"1368",height:"1715"}),". "),(0,n.kt)("p",null,"Next, we select a meta-analysis algorithm. This time, we'll select MKDA Chi-Squared (",(0,n.kt)("inlineCode",{parentName:"p"},"MKDAChi2"),") with ",(0,n.kt)("inlineCode",{parentName:"p"},"FDRCorrector"),". "),(0,n.kt)("p",null,"MKDA Chi-Square compares your StudySet to a reference set of studies (all the studies in NeuroStore that you did ",(0,n.kt)("em",{parentName:"p"},"not")," select), allowing you to identify areas of stronger association with your selected studies. This is the algorithm used in the original Neurosynth Platform."),(0,n.kt)("h3",{id:"execute"},"Execute"),(0,n.kt)("p",null,"Once you specify your meta-analysis, you can execute it in the cloud using Google Colab using your unique meta-analysis id. "),(0,n.kt)("p",null,(0,n.kt)("img",{alt:"Automated execute",src:a(2770).Z,width:"1551",height:"1098"}),". "),(0,n.kt)("p",null,"Congratulations, you have now run an automated meta-analysis!"),(0,n.kt)("p",null,"Remember, just because it is easy to run a meta-analysis and get results, does not mean the results are valid.\nIt is important to think about the validity of your study selection process, for both manual and automated meta-analyses."))}c.isMDXComponent=!0},761:(e,t,a)=>{a.d(t,{Z:()=>o});const o=a.p+"assets/images/automated_curation-371eefa2a58043457c9b63a79728b217.png"},2770:(e,t,a)=>{a.d(t,{Z:()=>o});const o=a.p+"assets/images/automated_execute-a020e8de9a3379dddedca4d00e04f3a6.png"},8376:(e,t,a)=>{a.d(t,{Z:()=>o});const o=a.p+"assets/images/automated_included_column-d2edd791b32654783c43877948de76f5.png"},8506:(e,t,a)=>{a.d(t,{Z:()=>o});const o=a.p+"assets/images/automated_search_neurostore-8727f551752008b51b8d58e99a652605.png"},1599:(e,t,a)=>{a.d(t,{Z:()=>o});const o=a.p+"assets/images/automated_skip_extraction-a686288de267f089b546b703f315f5f0.png"},3594:(e,t,a)=>{a.d(t,{Z:()=>o});const o=a.p+"assets/images/automated_workflow-8bea486d4904648bcafa7ea0aa3ccf05.png"}}]); \ No newline at end of file diff --git a/assets/js/b270851a.7f76da10.js b/assets/js/b270851a.7f76da10.js deleted file mode 100644 index 1ed7660..0000000 --- a/assets/js/b270851a.7f76da10.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[1854],{3905:(e,t,a)=>{a.d(t,{Zo:()=>m,kt:()=>y});var n=a(7294);function o(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function i(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,n)}return a}function r(e){for(var t=1;t=0||(o[a]=e[a]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(o[a]=e[a])}return o}var l=n.createContext({}),u=function(e){var t=n.useContext(l),a=t;return e&&(a="function"==typeof e?e(t):r(r({},t),e)),a},m=function(e){var t=u(e.components);return n.createElement(l.Provider,{value:t},e.children)},d="mdxType",c={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},p=n.forwardRef((function(e,t){var a=e.components,o=e.mdxType,i=e.originalType,l=e.parentName,m=s(e,["components","mdxType","originalType","parentName"]),d=u(a),p=o,y=d["".concat(l,".").concat(p)]||d[p]||c[p]||i;return a?n.createElement(y,r(r({ref:t},m),{},{components:a})):n.createElement(y,r({ref:t},m))}));function y(e,t){var a=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var i=a.length,r=new Array(i);r[0]=p;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s[d]="string"==typeof e?e:o,r[1]=s;for(var u=2;u{a.r(t),a.d(t,{assets:()=>l,contentTitle:()=>r,default:()=>c,frontMatter:()=>i,metadata:()=>s,toc:()=>u});var n=a(7462),o=(a(7294),a(3905));const i={sidebar_label:"Automated Meta-Analysis",sidebar_position:2},r="Automated Meta-Analysis",s={unversionedId:"tutorial/automated",id:"tutorial/automated",title:"Automated Meta-Analysis",description:"How to create a fully automated meta-analysis",source:"@site/docs/tutorial/automated.md",sourceDirName:"tutorial",slug:"/tutorial/automated",permalink:"/compose-docs/tutorial/automated",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/tutorial/automated.md",tags:[],version:"current",lastUpdatedBy:"James Kent",lastUpdatedAt:1727371503,formattedLastUpdatedAt:"Sep 26, 2024",sidebarPosition:2,frontMatter:{sidebar_label:"Automated Meta-Analysis",sidebar_position:2},sidebar:"tutorialSidebar",previous:{title:"Manual Meta-Analysis",permalink:"/compose-docs/tutorial/manual"},next:{title:"Advanced tutorials",permalink:"/compose-docs/tutorial/advanced/"}},l={},u=[{value:"Why automated meta-analysis?",id:"why-automated-meta-analysis",level:2},{value:"Flexible automated meta-analysis in Neurosynth Compose",id:"flexible-automated-meta-analysis-in-neurosynth-compose",level:3},{value:"Tutorial",id:"tutorial",level:2},{value:"Search & Curate",id:"search--curate",level:3},{value:"Import from Neurostore",id:"import-from-neurostore",level:4},{value:"Promote studies",id:"promote-studies",level:4},{value:"Extraction and Annotation",id:"extraction-and-annotation",level:3},{value:"Specify Meta-Analyses",id:"specify-meta-analyses",level:3},{value:"Execute",id:"execute",level:3}],m={toc:u},d="wrapper";function c(e){let{components:t,...i}=e;return(0,o.kt)(d,(0,n.Z)({},m,i,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"automated-meta-analysis"},"Automated Meta-Analysis"),(0,o.kt)("p",null,(0,o.kt)("em",{parentName:"p"},"How to create a fully automated meta-analysis")),(0,o.kt)("admonition",{type:"caution"},(0,o.kt)("p",{parentName:"admonition"},"This tutorial, and the functionality for automated meta-analysis, is under construction.\nTo view existing automated meta-analyses, you can use ",(0,o.kt)("a",{parentName:"p",href:"https://neurosynth.org"},"Neurosynth Original"))),(0,o.kt)("h2",{id:"why-automated-meta-analysis"},"Why automated meta-analysis?"),(0,o.kt)("p",null,"The principal difference between an automated and a ",(0,o.kt)("a",{parentName:"p",href:"/compose-docs/tutorial/manual"},"manual meta-analysis")," is ",(0,o.kt)("em",{parentName:"p"},"the process used to select the final set of Studies and Analyses to include")," into your meta-analysis. "),(0,o.kt)("p",null,"In a ",(0,o.kt)("strong",{parentName:"p"},"manual meta-analysis"),", researchers cast a wide net to find a wide range of potentially relevant articles, and use their expertise (read: painstakingly review hundreds of articles) to decide which of articles are relevant to their research question. Our platform seeks streamline this process through a user-friendly interface and pre-extracted data for over 20,000 neuroimaging studies. Yet, ",(0,o.kt)("strong",{parentName:"p"},"a gold standard meta-analysis still requires a significant time investment"),", limiting their application in routine scientific practice."),(0,o.kt)("p",null,"In an ",(0,o.kt)("strong",{parentName:"p"},"automated meta-analysis"),", we instead use data-driven text mining metrics to ",(0,o.kt)("em",{parentName:"p"},"select")," articles. The original ",(0,o.kt)("em",{parentName:"p"},"Neurosynth")," pioneered this approach by developing text mining techniques to automatically extract brain coordinates and semantic text features from thousands of articles. "),(0,o.kt)("p",null,"Surprisingly, this works! For example, by meta-analyzing all studies that mention the term ",(0,o.kt)("a",{parentName:"p",href:"https://neurosynth.org/analyses/terms/emotional/"},'"emotional"')," above a certain frequency, we observe a strong association with activity in the amygdala. By and large, the sheer number of studies overcomes the inherent noisiness of automated data extraction and study selection. "),(0,o.kt)("h3",{id:"flexible-automated-meta-analysis-in-neurosynth-compose"},"Flexible automated meta-analysis in Neurosynth Compose"),(0,o.kt)("p",null,"Although automated meta-analyses have proved to be a useful tool, there are several limitations. The overall goal of ",(0,o.kt)("em",{parentName:"p"},"Neurosynth Compose")," is to give users a flexible data curation platform, to overcome these limitations using their expert knowledge. For example:"),(0,o.kt)("ul",null,(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("em",{parentName:"li"},"Flexible selection criteria.")," The original Neurosynth has a fixed number of terms and meta-analyses. With",(0,o.kt)("em",{parentName:"li"},"Neurosynth Compose")," you can flexibly search the NeuroStore database using a powerful and flexible search to precisely define your search criteria. "),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("em",{parentName:"li"},"Combine expert knowledge with automated selection.")," Automated study selection is inherently an noisy and imperfect measure. With ",(0,o.kt)("em",{parentName:"li"},"Neurosynth Compose"),", you can use automated study selection as a first pass, and later apply your own expert criteria to refine study inclusion criteria. "),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("em",{parentName:"li"},"Correct data extraction errors.")," Automated extraction can miss entire tables of coordinates (e.g. supplementary materials), duplicate coordinates, and groups distinct sets of Analyses (e.g. Contrasts) into a single group. Now, you can correct these data to make your meta-analysis more precise. ")),(0,o.kt)("h2",{id:"tutorial"},"Tutorial"),(0,o.kt)("p",null,"An automated meta-analysis in ",(0,o.kt)("em",{parentName:"p"},"Neurosynth Compose")," looks a lot like a manual one, except data curation is optional. We reccomeend following the ",(0,o.kt)("a",{parentName:"p",href:"/compose-docs/tutorial/manual"},"manual meta-analysis")," tutorial to learn in depth about our platform."),(0,o.kt)("h3",{id:"search--curate"},"Search & Curate"),(0,o.kt)("p",null,"One of the main differences between a ",(0,o.kt)("em",{parentName:"p"},"manual")," and ",(0,o.kt)("em",{parentName:"p"},"automated"),' meta-analysis, is the steps required to select studies. As such, we reccomeend selecting the "Simple" curation workflow, which only consists of a single data curation step (which is optional). '),(0,o.kt)("p",null,(0,o.kt)("img",{alt:"Simple Workflow",src:a(3594).Z,width:"2128",height:"923"}),". "),(0,o.kt)("admonition",{type:"tip"},(0,o.kt)("p",{parentName:"admonition"},"Decide ahead of time if you want to perform a Coordinate or an Image based meta-analysis. Image-based Meta-Analysis (IBMA) is more precise and powerful, but there are much fewer studies available. ")),(0,o.kt)("h4",{id:"import-from-neurostore"},"Import from Neurostore"),(0,o.kt)("p",null,"Let's add studies to our curation board by clicking ",(0,o.kt)("strong",{parentName:"p"},"Import Studies"),".\nIn an automated meta-analysis, you'll want to select ",(0,o.kt)("em",{parentName:"p"},"Import via NeuroStore"),", as all indexed studies are guaranteed to contain imaging data (saving you from manual data extraction)."),(0,o.kt)("admonition",{type:"caution"},(0,o.kt)("p",{parentName:"admonition"},"Although the NeuroStore database is continuously growing, it is necessarily an incomplete snapshot of the neuroimaging literature")),(0,o.kt)("p",null,"Input any search term to narrow down studies. This will search the Title and Abstract fields. You may also add additional search filters using the ",(0,o.kt)("strong",{parentName:"p"},"+ Add Filter")," button, and ",(0,o.kt)("em",{parentName:"p"},"select the desired modality of the imaging data"),". "),(0,o.kt)("p",null,(0,o.kt)("img",{alt:"Neurostore Search",src:a(8506).Z,width:"1849",height:"1523"}),". "),(0,o.kt)("p",null,'To import your search, click "Import Studies From Neurostore" at the bottom right. Give your import a name to Tag all imported studies, and continue back to your Curation board. '),(0,o.kt)("admonition",{type:"note"},(0,o.kt)("p",{parentName:"admonition"},"You must import an entire set of search results into your curation board. If you want to exclude any specific studies, you will do so on your board. This allows the Search & Curate process to be fully reproducible.")),(0,o.kt)("h4",{id:"promote-studies"},"Promote studies"),(0,o.kt)("p",null,"Back to your Curation board, you will now see all studies from your NeuroStore search on the left most column."),(0,o.kt)("p",null,(0,o.kt)("img",{alt:"Curation board",src:a(761).Z,width:"2583",height:"1604"}),". "),(0,o.kt)("p",null,"At this point, you have two options: manually review the search results and select which studies to include, or perform a fully automated meta-analysis by including all search results. "),(0,o.kt)("p",null,"For this tutorial, we'll skip manual curation and ",(0,o.kt)("strong",{parentName:"p"},"Promote All Uncategorized Studies"),' to the right-most "Included" column. '),(0,o.kt)("p",null,"We can now click ",(0,o.kt)("em",{parentName:"p"},"Move to Extraction Phase"),"."),(0,o.kt)("h3",{id:"extraction-and-annotation"},"Extraction and Annotation"),(0,o.kt)("p",null,"At this point, you will create a StudySet containing all of your Studies. Advance through the dialog to begin ",(0,o.kt)("em",{parentName:"p"},"Extraction"),"."),(0,o.kt)("p",null,"The goal of this phase is to add or correct imaging data (e.g. Coordinates) in imported studies, and create Annotations to determine which Analyses (e.g. Contrasts), should be included in your meta-analysis."),(0,o.kt)("p",null,"Since we are performing a manual meta-analysis, we're going to skip these steps!"),(0,o.kt)("p",null,"From the main ",(0,o.kt)("em",{parentName:"p"},"Project"),' page, we can click "Mark All as Complete".'),(0,o.kt)("p",null,(0,o.kt)("img",{alt:"Skip Extraction",src:a(1599).Z,width:"1263",height:"855"}),". "),(0,o.kt)("admonition",{type:"tip"},(0,o.kt)("p",{parentName:"admonition"},"It's up to you if you want to skip this step. The validity of your meta-analysis is highly dependant on input data, so we only recommend skipping all curation for exploratory analyses.")),(0,o.kt)("h3",{id:"specify-meta-analyses"},"Specify Meta-Analyses"),(0,o.kt)("p",null,"You can now specify your meta-analysis. This step will be identical between automated and manual meta-analyses."),(0,o.kt)("p",null,'First, we select the "included" column, which by default includes ',(0,o.kt)("em",{parentName:"p"},"all")," Study Analyses as inputs."),(0,o.kt)("p",null,(0,o.kt)("img",{alt:"Inclusion column",src:a(8376).Z,width:"1368",height:"1715"}),". "),(0,o.kt)("p",null,"Next, we select a meta-analysis algorithm. This time, we'll select MKDA Chi-Squared (",(0,o.kt)("inlineCode",{parentName:"p"},"MKDAChi2"),") with ",(0,o.kt)("inlineCode",{parentName:"p"},"FDRCorrector"),". "),(0,o.kt)("p",null,"MKDA Chi-Square compares your StudySet to a reference set of studies (all the studies in NeuroStore that you did ",(0,o.kt)("em",{parentName:"p"},"not")," select), allowing you to identify areas of stronger association with your selected studies. This is the algorithm used in the original Neurosynth Platform."),(0,o.kt)("h3",{id:"execute"},"Execute"),(0,o.kt)("p",null,"Once you specify your meta-analysis, you can execute it in the cloud using Google Colab using your unique meta-analysis id. "),(0,o.kt)("p",null,(0,o.kt)("img",{alt:"Automated execute",src:a(2770).Z,width:"1551",height:"1098"}),". "),(0,o.kt)("p",null,"Congratulations, you have now run an automated meta-analysis!"),(0,o.kt)("p",null,"Remember, just because it is easy to run a meta-analysis and get results, does not mean the results are valid.\nIt is important to think about the validity of your study selection process, for both manual and automated meta-analyses."))}c.isMDXComponent=!0},761:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/automated_curation-371eefa2a58043457c9b63a79728b217.png"},2770:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/automated_execute-a020e8de9a3379dddedca4d00e04f3a6.png"},8376:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/automated_included_column-d2edd791b32654783c43877948de76f5.png"},8506:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/automated_search_neurostore-8727f551752008b51b8d58e99a652605.png"},1599:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/automated_skip_extraction-a686288de267f089b546b703f315f5f0.png"},3594:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/automated_workflow-8bea486d4904648bcafa7ea0aa3ccf05.png"}}]); \ No newline at end of file diff --git a/assets/js/c2abd45e.a756d662.js b/assets/js/c2abd45e.a756d662.js deleted file mode 100644 index bf70082..0000000 --- a/assets/js/c2abd45e.a756d662.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[2309],{2991:(t,e,r)=>{r.d(e,{Z:()=>h});var a=r(7294),o=r(6010),n=r(2802),i=r(9960),l=r(3919),s=r(5999);const c={cardContainer:"cardContainer_fWXF",cardTitle:"cardTitle_rnsV",cardDescription:"cardDescription_PWke"};function u(t){let{href:e,children:r}=t;return a.createElement(i.Z,{href:e,className:(0,o.Z)("card padding--lg",c.cardContainer)},r)}function d(t){let{href:e,icon:r,title:n,description:i}=t;return a.createElement(u,{href:e},a.createElement("h2",{className:(0,o.Z)("text--truncate",c.cardTitle),title:n},r," ",n),i&&a.createElement("p",{className:(0,o.Z)("text--truncate",c.cardDescription),title:i},i))}function m(t){let{item:e}=t;const r=(0,n.Wl)(e);return r?a.createElement(d,{href:r,icon:"\ud83d\uddc3\ufe0f",title:e.label,description:(0,s.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:e.items.length})}):null}function p(t){let{item:e}=t;const r=(0,l.Z)(e.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",o=(0,n.xz)(e.docId??void 0);return a.createElement(d,{href:e.href,icon:r,title:e.label,description:o?.description})}function y(t){let{item:e}=t;switch(e.type){case"link":return a.createElement(p,{item:e});case"category":return a.createElement(m,{item:e});default:throw new Error(`unknown item type ${JSON.stringify(e)}`)}}function k(t){let{className:e}=t;const r=(0,n.jA)();return a.createElement(h,{items:r.items,className:e})}function h(t){const{items:e,className:r}=t;if(!e)return a.createElement(k,t);const i=(0,n.MN)(e);return a.createElement("section",{className:(0,o.Z)("row",r)},i.map(((t,e)=>a.createElement("article",{key:e,className:"col col--6 margin-bottom--lg"},a.createElement(y,{item:t})))))}},473:(t,e,r)=>{r.r(e),r.d(e,{assets:()=>m,contentTitle:()=>u,default:()=>h,frontMatter:()=>c,metadata:()=>d,toc:()=>p});var a=r(7462),o=(r(7294),r(3905)),n=r(9937),i=r(4267),l=r(8862),s=r(3727);r(2991);const c={},u="Tutorials",d={unversionedId:"tutorial/index",id:"tutorial/index",title:"Tutorials",description:"Quickstart",source:"@site/docs/tutorial/index.mdx",sourceDirName:"tutorial",slug:"/tutorial/",permalink:"/compose-docs/tutorial/",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/tutorial/index.mdx",tags:[],version:"current",lastUpdatedBy:"James Kent",lastUpdatedAt:1727371503,formattedLastUpdatedAt:"Sep 26, 2024",frontMatter:{},sidebar:"tutorialSidebar",previous:{title:"Glossary",permalink:"/compose-docs/guide/glossary"},next:{title:"Manual Meta-Analysis",permalink:"/compose-docs/tutorial/manual"}},m={},p=[{value:"Quickstart",id:"quickstart",level:3},{value:"Advanced tutorials",id:"advanced-tutorials",level:3}],y={toc:p},k="wrapper";function h(t){let{components:e,...r}=t;return(0,o.kt)(k,(0,a.Z)({},y,r,{components:e,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"tutorials"},"Tutorials"),(0,o.kt)("h3",{id:"quickstart"},"Quickstart"),(0,o.kt)("p",null,"Neurosynth Compose supports a range of workflows,\nfrom exploratory large-scale automated analyses to highly rigorous manual analyses."),(0,o.kt)("p",null,"The choice of workflow depends on your research question and resources available for manual curation.\nWe reccomend starting with the ",(0,o.kt)("strong",{parentName:"p"},"manual meta-analysis")," tutorial if you are new."),(0,o.kt)("div",{style:{display:"flex"}},(0,o.kt)(s.rU,{to:"tutorial/manual",style:{textDecoration:"none"},style:{width:"100%",display:"flex",marginRight:"30px",cursor:"pointer"},mdxType:"Link"},(0,o.kt)(n.Z,{style:{borderRadius:"8px"},mdxType:"Card"},(0,o.kt)(i.Z,{mdxType:"CardContent"},(0,o.kt)(l.Z,{variant:"h5",component:"h2",gutterBottom:!0,mdxType:"Typography"},"Manual"),(0,o.kt)(l.Z,{variant:"body1",gutterBottom:!0,mdxType:"Typography"},(0,o.kt)("em",null,"Most stringent and rigorous."),(0,o.kt)("br",null),(0,o.kt)("br",null),(0,o.kt)("ul",null,(0,o.kt)("li",null,"Search across multiple sources, such as: PubMed, Web of Science, NeuroStore"),(0,o.kt)("li",null,"Careful curation for inclusion/exclusion criteria"),(0,o.kt)("li",null,"Extract coordinates from studies not already indexed"),(0,o.kt)("li",null,"Meets PRISMA guidelines")))))),(0,o.kt)(s.rU,{to:"tutorial/automated",style:{textDecoration:"none"},style:{width:"100%",display:"flex",marginRight:"30px",cursor:"pointer"},mdxType:"Link"},(0,o.kt)(n.Z,{style:{borderRadius:"8px"},mdxType:"Card"},(0,o.kt)(i.Z,{mdxType:"CardContent"},(0,o.kt)(l.Z,{variant:"h5",component:"h2",gutterBottom:!0,mdxType:"Typography"},"Automated"),(0,o.kt)(l.Z,{variant:"body1",gutterBottom:!0,mdxType:"Typography"},(0,o.kt)("em",null,"Fast exploratory analysis."),(0,o.kt)("br",null),(0,o.kt)("br",null),(0,o.kt)("ul",null,(0,o.kt)("li",null,"Query studies at scale"),(0,o.kt)("li",null,"Search using terms, topics or activation coordinates"),(0,o.kt)("li",null,"Replicate results from original Neurosynth"),(0,o.kt)("li",null,"Immediate results, ideal for a exploratory analysis"))))))),(0,o.kt)("h3",{id:"advanced-tutorials"},"Advanced tutorials"),(0,o.kt)("p",null,"After you've completed the core tutorials above, you can continue your learning journey with ",(0,o.kt)("a",{parentName:"p",href:"./tutorial/advanced"},"advanced tutorials"),"."))}h.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/c2abd45e.ba71a24b.js b/assets/js/c2abd45e.ba71a24b.js new file mode 100644 index 0000000..c6e13fb --- /dev/null +++ b/assets/js/c2abd45e.ba71a24b.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[2309],{2991:(t,e,a)=>{a.d(e,{Z:()=>h});var r=a(7294),o=a(6010),n=a(2802),i=a(9960),l=a(3919),s=a(5999);const c={cardContainer:"cardContainer_fWXF",cardTitle:"cardTitle_rnsV",cardDescription:"cardDescription_PWke"};function u(t){let{href:e,children:a}=t;return r.createElement(i.Z,{href:e,className:(0,o.Z)("card padding--lg",c.cardContainer)},a)}function d(t){let{href:e,icon:a,title:n,description:i}=t;return r.createElement(u,{href:e},r.createElement("h2",{className:(0,o.Z)("text--truncate",c.cardTitle),title:n},a," ",n),i&&r.createElement("p",{className:(0,o.Z)("text--truncate",c.cardDescription),title:i},i))}function m(t){let{item:e}=t;const a=(0,n.Wl)(e);return a?r.createElement(d,{href:a,icon:"\ud83d\uddc3\ufe0f",title:e.label,description:(0,s.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:e.items.length})}):null}function p(t){let{item:e}=t;const a=(0,l.Z)(e.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",o=(0,n.xz)(e.docId??void 0);return r.createElement(d,{href:e.href,icon:a,title:e.label,description:o?.description})}function y(t){let{item:e}=t;switch(e.type){case"link":return r.createElement(p,{item:e});case"category":return r.createElement(m,{item:e});default:throw new Error(`unknown item type ${JSON.stringify(e)}`)}}function k(t){let{className:e}=t;const a=(0,n.jA)();return r.createElement(h,{items:a.items,className:e})}function h(t){const{items:e,className:a}=t;if(!e)return r.createElement(k,t);const i=(0,n.MN)(e);return r.createElement("section",{className:(0,o.Z)("row",a)},i.map(((t,e)=>r.createElement("article",{key:e,className:"col col--6 margin-bottom--lg"},r.createElement(y,{item:t})))))}},473:(t,e,a)=>{a.r(e),a.d(e,{assets:()=>m,contentTitle:()=>u,default:()=>h,frontMatter:()=>c,metadata:()=>d,toc:()=>p});var r=a(7462),o=(a(7294),a(3905)),n=a(9937),i=a(4267),l=a(8862),s=a(3727);a(2991);const c={},u="Tutorials",d={unversionedId:"tutorial/index",id:"tutorial/index",title:"Tutorials",description:"Quickstart",source:"@site/docs/tutorial/index.mdx",sourceDirName:"tutorial",slug:"/tutorial/",permalink:"/compose-docs/tutorial/",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/tutorial/index.mdx",tags:[],version:"current",lastUpdatedBy:"Alejandro de la Vega",lastUpdatedAt:1729891615,formattedLastUpdatedAt:"Oct 25, 2024",frontMatter:{},sidebar:"tutorialSidebar",previous:{title:"Glossary",permalink:"/compose-docs/guide/glossary"},next:{title:"Manual Meta-Analysis",permalink:"/compose-docs/tutorial/manual"}},m={},p=[{value:"Quickstart",id:"quickstart",level:3},{value:"Advanced tutorials",id:"advanced-tutorials",level:3}],y={toc:p},k="wrapper";function h(t){let{components:e,...a}=t;return(0,o.kt)(k,(0,r.Z)({},y,a,{components:e,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"tutorials"},"Tutorials"),(0,o.kt)("h3",{id:"quickstart"},"Quickstart"),(0,o.kt)("p",null,"Neurosynth Compose supports a range of workflows,\nfrom exploratory large-scale automated analyses to highly rigorous manual analyses."),(0,o.kt)("p",null,"The choice of workflow depends on your research question and resources available for manual curation.\nWe reccomend starting with the ",(0,o.kt)("strong",{parentName:"p"},"manual meta-analysis")," tutorial if you are new."),(0,o.kt)("div",{style:{display:"flex"}},(0,o.kt)(s.rU,{to:"tutorial/manual",style:{textDecoration:"none"},style:{width:"100%",display:"flex",marginRight:"30px",cursor:"pointer"},mdxType:"Link"},(0,o.kt)(n.Z,{style:{borderRadius:"8px"},mdxType:"Card"},(0,o.kt)(i.Z,{mdxType:"CardContent"},(0,o.kt)(l.Z,{variant:"h5",component:"h2",gutterBottom:!0,mdxType:"Typography"},"Manual"),(0,o.kt)(l.Z,{variant:"body1",gutterBottom:!0,mdxType:"Typography"},(0,o.kt)("em",null,"Most stringent and rigorous."),(0,o.kt)("br",null),(0,o.kt)("br",null),(0,o.kt)("ul",null,(0,o.kt)("li",null,"Search across multiple sources, such as: PubMed, Web of Science, NeuroStore"),(0,o.kt)("li",null,"Careful curation for inclusion/exclusion criteria"),(0,o.kt)("li",null,"Extract coordinates from studies not already indexed"),(0,o.kt)("li",null,"Meets PRISMA guidelines")))))),(0,o.kt)(s.rU,{to:"tutorial/automated",style:{textDecoration:"none"},style:{width:"100%",display:"flex",marginRight:"30px",cursor:"pointer"},mdxType:"Link"},(0,o.kt)(n.Z,{style:{borderRadius:"8px"},mdxType:"Card"},(0,o.kt)(i.Z,{mdxType:"CardContent"},(0,o.kt)(l.Z,{variant:"h5",component:"h2",gutterBottom:!0,mdxType:"Typography"},"Automated"),(0,o.kt)(l.Z,{variant:"body1",gutterBottom:!0,mdxType:"Typography"},(0,o.kt)("em",null,"Fast exploratory analysis."),(0,o.kt)("br",null),(0,o.kt)("br",null),(0,o.kt)("ul",null,(0,o.kt)("li",null,"Query studies at scale"),(0,o.kt)("li",null,"Search using terms, topics or activation coordinates"),(0,o.kt)("li",null,"Replicate results from original Neurosynth"),(0,o.kt)("li",null,"Immediate results, ideal for a exploratory analysis"))))))),(0,o.kt)("h3",{id:"advanced-tutorials"},"Advanced tutorials"),(0,o.kt)("p",null,"After you've completed the core tutorials above, you can continue your learning journey with ",(0,o.kt)("a",{parentName:"p",href:"./tutorial/advanced"},"advanced tutorials"),"."))}h.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/c4a0799b.5abcfa32.js b/assets/js/c4a0799b.51083267.js similarity index 85% rename from assets/js/c4a0799b.5abcfa32.js rename to assets/js/c4a0799b.51083267.js index fc3faf7..1ddd0f2 100644 --- a/assets/js/c4a0799b.5abcfa32.js +++ b/assets/js/c4a0799b.51083267.js @@ -1 +1 @@ -"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[1010],{3905:(e,t,r)=>{r.d(t,{Zo:()=>d,kt:()=>f});var n=r(7294);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function c(e){for(var t=1;t=0||(o[r]=e[r]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(o[r]=e[r])}return o}var s=n.createContext({}),l=function(e){var t=n.useContext(s),r=t;return e&&(r="function"==typeof e?e(t):c(c({},t),e)),r},d=function(e){var t=l(e.components);return n.createElement(s.Provider,{value:t},e.children)},u="mdxType",m={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},p=n.forwardRef((function(e,t){var r=e.components,o=e.mdxType,i=e.originalType,s=e.parentName,d=a(e,["components","mdxType","originalType","parentName"]),u=l(r),p=o,f=u["".concat(s,".").concat(p)]||u[p]||m[p]||i;return r?n.createElement(f,c(c({ref:t},d),{},{components:r})):n.createElement(f,c({ref:t},d))}));function f(e,t){var r=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var i=r.length,c=new Array(i);c[0]=p;var a={};for(var s in t)hasOwnProperty.call(t,s)&&(a[s]=t[s]);a.originalType=e,a[u]="string"==typeof e?e:o,c[1]=a;for(var l=2;l{r.d(t,{Z:()=>g});var n=r(7294),o=r(6010),i=r(2802),c=r(9960),a=r(3919),s=r(5999);const l={cardContainer:"cardContainer_fWXF",cardTitle:"cardTitle_rnsV",cardDescription:"cardDescription_PWke"};function d(e){let{href:t,children:r}=e;return n.createElement(c.Z,{href:t,className:(0,o.Z)("card padding--lg",l.cardContainer)},r)}function u(e){let{href:t,icon:r,title:i,description:c}=e;return n.createElement(d,{href:t},n.createElement("h2",{className:(0,o.Z)("text--truncate",l.cardTitle),title:i},r," ",i),c&&n.createElement("p",{className:(0,o.Z)("text--truncate",l.cardDescription),title:c},c))}function m(e){let{item:t}=e;const r=(0,i.Wl)(t);return r?n.createElement(u,{href:r,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:(0,s.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function p(e){let{item:t}=e;const r=(0,a.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",o=(0,i.xz)(t.docId??void 0);return n.createElement(u,{href:t.href,icon:r,title:t.label,description:o?.description})}function f(e){let{item:t}=e;switch(t.type){case"link":return n.createElement(p,{item:t});case"category":return n.createElement(m,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function y(e){let{className:t}=e;const r=(0,i.jA)();return n.createElement(g,{items:r.items,className:t})}function g(e){const{items:t,className:r}=e;if(!t)return n.createElement(y,e);const c=(0,i.MN)(t);return n.createElement("section",{className:(0,o.Z)("row",r)},c.map(((e,t)=>n.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},n.createElement(f,{item:e})))))}},9126:(e,t,r)=>{r.r(t),r.d(t,{assets:()=>l,contentTitle:()=>a,default:()=>p,frontMatter:()=>c,metadata:()=>s,toc:()=>d});var n=r(7462),o=(r(7294),r(3905)),i=r(2991);const c={},a="User Guide",s={unversionedId:"guide/index",id:"guide/index",title:"User Guide",description:"Overview",source:"@site/docs/guide/index.mdx",sourceDirName:"guide",slug:"/guide/",permalink:"/compose-docs/guide/",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/guide/index.mdx",tags:[],version:"current",lastUpdatedBy:"James Kent",lastUpdatedAt:1727371503,formattedLastUpdatedAt:"Sep 26, 2024",frontMatter:{},sidebar:"tutorialSidebar",previous:{title:"Ecosystem",permalink:"/compose-docs/introduction/ecosystem"},next:{title:"Project",permalink:"/compose-docs/guide/Project/"}},l={},d=[{value:"Overview",id:"overview",level:3}],u={toc:d},m="wrapper";function p(e){let{components:t,...r}=e;return(0,o.kt)(m,(0,n.Z)({},u,r,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"user-guide"},"User Guide"),(0,o.kt)("h3",{id:"overview"},"Overview"),(0,o.kt)("p",null,"The user guide contains a comprehensive overview of the platform and definitions of keywords related to neurosynth-compose."),(0,o.kt)(i.Z,{mdxType:"DocCardList"}))}p.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[1010],{3905:(e,t,r)=>{r.d(t,{Zo:()=>d,kt:()=>f});var n=r(7294);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function c(e){for(var t=1;t=0||(o[r]=e[r]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(o[r]=e[r])}return o}var s=n.createContext({}),l=function(e){var t=n.useContext(s),r=t;return e&&(r="function"==typeof e?e(t):c(c({},t),e)),r},d=function(e){var t=l(e.components);return n.createElement(s.Provider,{value:t},e.children)},u="mdxType",m={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},p=n.forwardRef((function(e,t){var r=e.components,o=e.mdxType,i=e.originalType,s=e.parentName,d=a(e,["components","mdxType","originalType","parentName"]),u=l(r),p=o,f=u["".concat(s,".").concat(p)]||u[p]||m[p]||i;return r?n.createElement(f,c(c({ref:t},d),{},{components:r})):n.createElement(f,c({ref:t},d))}));function f(e,t){var r=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var i=r.length,c=new Array(i);c[0]=p;var a={};for(var s in t)hasOwnProperty.call(t,s)&&(a[s]=t[s]);a.originalType=e,a[u]="string"==typeof e?e:o,c[1]=a;for(var l=2;l{r.d(t,{Z:()=>g});var n=r(7294),o=r(6010),i=r(2802),c=r(9960),a=r(3919),s=r(5999);const l={cardContainer:"cardContainer_fWXF",cardTitle:"cardTitle_rnsV",cardDescription:"cardDescription_PWke"};function d(e){let{href:t,children:r}=e;return n.createElement(c.Z,{href:t,className:(0,o.Z)("card padding--lg",l.cardContainer)},r)}function u(e){let{href:t,icon:r,title:i,description:c}=e;return n.createElement(d,{href:t},n.createElement("h2",{className:(0,o.Z)("text--truncate",l.cardTitle),title:i},r," ",i),c&&n.createElement("p",{className:(0,o.Z)("text--truncate",l.cardDescription),title:c},c))}function m(e){let{item:t}=e;const r=(0,i.Wl)(t);return r?n.createElement(u,{href:r,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:(0,s.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function p(e){let{item:t}=e;const r=(0,a.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",o=(0,i.xz)(t.docId??void 0);return n.createElement(u,{href:t.href,icon:r,title:t.label,description:o?.description})}function f(e){let{item:t}=e;switch(t.type){case"link":return n.createElement(p,{item:t});case"category":return n.createElement(m,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function y(e){let{className:t}=e;const r=(0,i.jA)();return n.createElement(g,{items:r.items,className:t})}function g(e){const{items:t,className:r}=e;if(!t)return n.createElement(y,e);const c=(0,i.MN)(t);return n.createElement("section",{className:(0,o.Z)("row",r)},c.map(((e,t)=>n.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},n.createElement(f,{item:e})))))}},9126:(e,t,r)=>{r.r(t),r.d(t,{assets:()=>l,contentTitle:()=>a,default:()=>p,frontMatter:()=>c,metadata:()=>s,toc:()=>d});var n=r(7462),o=(r(7294),r(3905)),i=r(2991);const c={},a="User Guide",s={unversionedId:"guide/index",id:"guide/index",title:"User Guide",description:"Overview",source:"@site/docs/guide/index.mdx",sourceDirName:"guide",slug:"/guide/",permalink:"/compose-docs/guide/",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/guide/index.mdx",tags:[],version:"current",lastUpdatedBy:"Alejandro de la Vega",lastUpdatedAt:1729891615,formattedLastUpdatedAt:"Oct 25, 2024",frontMatter:{},sidebar:"tutorialSidebar",previous:{title:"Ecosystem",permalink:"/compose-docs/introduction/ecosystem"},next:{title:"Project",permalink:"/compose-docs/guide/Project/"}},l={},d=[{value:"Overview",id:"overview",level:3}],u={toc:d},m="wrapper";function p(e){let{components:t,...r}=e;return(0,o.kt)(m,(0,n.Z)({},u,r,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"user-guide"},"User Guide"),(0,o.kt)("h3",{id:"overview"},"Overview"),(0,o.kt)("p",null,"The user guide contains a comprehensive overview of the platform and definitions of keywords related to neurosynth-compose."),(0,o.kt)(i.Z,{mdxType:"DocCardList"}))}p.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/c4e6ab22.2459ab27.js b/assets/js/c4e6ab22.d25c897e.js similarity index 57% rename from assets/js/c4e6ab22.2459ab27.js rename to assets/js/c4e6ab22.d25c897e.js index d96e14f..4909768 100644 --- a/assets/js/c4e6ab22.2459ab27.js +++ b/assets/js/c4e6ab22.d25c897e.js @@ -1 +1 @@ -"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[6626],{3905:(e,t,n)=>{n.d(t,{Zo:()=>d,kt:()=>y});var r=n(7294);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function a(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function i(e){for(var t=1;t=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var l=r.createContext({}),p=function(e){var t=r.useContext(l),n=t;return e&&(n="function"==typeof e?e(t):i(i({},t),e)),n},d=function(e){var t=p(e.components);return r.createElement(l.Provider,{value:t},e.children)},u="mdxType",c={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var n=e.components,o=e.mdxType,a=e.originalType,l=e.parentName,d=s(e,["components","mdxType","originalType","parentName"]),u=p(n),m=o,y=u["".concat(l,".").concat(m)]||u[m]||c[m]||a;return n?r.createElement(y,i(i({ref:t},d),{},{components:n})):r.createElement(y,i({ref:t},d))}));function y(e,t){var n=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var a=n.length,i=new Array(a);i[0]=m;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s[u]="string"==typeof e?e:o,i[1]=s;for(var p=2;p{n.r(t),n.d(t,{assets:()=>l,contentTitle:()=>i,default:()=>c,frontMatter:()=>a,metadata:()=>s,toc:()=>p});var r=n(7462),o=(n(7294),n(3905));const a={title:"Explore",sidebar_position:1},i="Explore",s={unversionedId:"guide/Explore/index",id:"guide/Explore/index",title:"Explore",description:"Here, you can browse and search existing public Studies, StudySets and Meta-Analyses created on the platform.",source:"@site/docs/guide/Explore/index.mdx",sourceDirName:"guide/Explore",slug:"/guide/Explore/",permalink:"/compose-docs/guide/Explore/",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/guide/Explore/index.mdx",tags:[],version:"current",lastUpdatedBy:"James Kent",lastUpdatedAt:1727371503,formattedLastUpdatedAt:"Sep 26, 2024",sidebarPosition:1,frontMatter:{title:"Explore",sidebar_position:1},sidebar:"tutorialSidebar",previous:{title:"Running Analyses",permalink:"/compose-docs/guide/Project/Running"},next:{title:"Searching",permalink:"/compose-docs/guide/Explore/Searching"}},l={},p=[{value:"Studies",id:"studies",level:2},{value:"StudySets and Meta-Analyses",id:"studysets-and-meta-analyses",level:2}],d={toc:p},u="wrapper";function c(e){let{components:t,...n}=e;return(0,o.kt)(u,(0,r.Z)({},d,n,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"explore"},"Explore"),(0,o.kt)("p",null,"Here, you can browse and search existing public ",(0,o.kt)("inlineCode",{parentName:"p"},"Studies"),", ",(0,o.kt)("inlineCode",{parentName:"p"},"StudySets")," and ",(0,o.kt)("inlineCode",{parentName:"p"},"Meta-Analyses")," created on the platform. "),(0,o.kt)("h2",{id:"studies"},"Studies"),(0,o.kt)("p",null,"The ",(0,o.kt)("inlineCode",{parentName:"p"},"Studies")," page lets you browse and search all studies that exist on the NeuroStore server. This interface is similar to what you'll see when importing studies into your ",(0,o.kt)("inlineCode",{parentName:"p"},"Project"),". However, here it's simply provided for your browsing pleasure. "),(0,o.kt)("p",null,"For more information on how advanced search functionally, see ",(0,o.kt)("a",{parentName:"p",href:"./Explore/Searching"},"Searching Studies")),(0,o.kt)("h2",{id:"studysets-and-meta-analyses"},"StudySets and Meta-Analyses"),(0,o.kt)("p",null,"For ",(0,o.kt)("inlineCode",{parentName:"p"},"StudySets")," and ",(0,o.kt)("inlineCode",{parentName:"p"},"Meta-Analyses"),", you can browse and search any user-contributed items, including those from other users. "),(0,o.kt)("p",null,"Note that although you see all publically available items, you cannot edit somebody else's content. "),(0,o.kt)("admonition",{type:"note"},(0,o.kt)("p",{parentName:"admonition"},"We are currently working on a way to allow users to fork other users' ",(0,o.kt)("inlineCode",{parentName:"p"},"StudySets")," and ",(0,o.kt)("inlineCode",{parentName:"p"},"Meta-Analyses")," to create their own versions.\nStay tuned!\n::::")))}c.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[6626],{3905:(e,t,n)=>{n.d(t,{Zo:()=>d,kt:()=>y});var r=n(7294);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function a(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function i(e){for(var t=1;t=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var l=r.createContext({}),p=function(e){var t=r.useContext(l),n=t;return e&&(n="function"==typeof e?e(t):i(i({},t),e)),n},d=function(e){var t=p(e.components);return r.createElement(l.Provider,{value:t},e.children)},u="mdxType",c={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var n=e.components,o=e.mdxType,a=e.originalType,l=e.parentName,d=s(e,["components","mdxType","originalType","parentName"]),u=p(n),m=o,y=u["".concat(l,".").concat(m)]||u[m]||c[m]||a;return n?r.createElement(y,i(i({ref:t},d),{},{components:n})):r.createElement(y,i({ref:t},d))}));function y(e,t){var n=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var a=n.length,i=new Array(a);i[0]=m;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s[u]="string"==typeof e?e:o,i[1]=s;for(var p=2;p{n.r(t),n.d(t,{assets:()=>l,contentTitle:()=>i,default:()=>c,frontMatter:()=>a,metadata:()=>s,toc:()=>p});var r=n(7462),o=(n(7294),n(3905));const a={title:"Explore",sidebar_position:1},i="Explore",s={unversionedId:"guide/Explore/index",id:"guide/Explore/index",title:"Explore",description:"Here, you can browse and search existing public Studies, StudySets and Meta-Analyses created on the platform.",source:"@site/docs/guide/Explore/index.mdx",sourceDirName:"guide/Explore",slug:"/guide/Explore/",permalink:"/compose-docs/guide/Explore/",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/guide/Explore/index.mdx",tags:[],version:"current",lastUpdatedBy:"Alejandro de la Vega",lastUpdatedAt:1729891615,formattedLastUpdatedAt:"Oct 25, 2024",sidebarPosition:1,frontMatter:{title:"Explore",sidebar_position:1},sidebar:"tutorialSidebar",previous:{title:"Running Analyses",permalink:"/compose-docs/guide/Project/Running"},next:{title:"Searching",permalink:"/compose-docs/guide/Explore/Searching"}},l={},p=[{value:"Studies",id:"studies",level:2},{value:"StudySets and Meta-Analyses",id:"studysets-and-meta-analyses",level:2}],d={toc:p},u="wrapper";function c(e){let{components:t,...n}=e;return(0,o.kt)(u,(0,r.Z)({},d,n,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"explore"},"Explore"),(0,o.kt)("p",null,"Here, you can browse and search existing public ",(0,o.kt)("inlineCode",{parentName:"p"},"Studies"),", ",(0,o.kt)("inlineCode",{parentName:"p"},"StudySets")," and ",(0,o.kt)("inlineCode",{parentName:"p"},"Meta-Analyses")," created on the platform. "),(0,o.kt)("h2",{id:"studies"},"Studies"),(0,o.kt)("p",null,"The ",(0,o.kt)("inlineCode",{parentName:"p"},"Studies")," page lets you browse and search all studies that exist on the NeuroStore server. This interface is similar to what you'll see when importing studies into your ",(0,o.kt)("inlineCode",{parentName:"p"},"Project"),". However, here it's simply provided for your browsing pleasure. "),(0,o.kt)("p",null,"For more information on how advanced search functionally, see ",(0,o.kt)("a",{parentName:"p",href:"./Explore/Searching"},"Searching Studies")),(0,o.kt)("h2",{id:"studysets-and-meta-analyses"},"StudySets and Meta-Analyses"),(0,o.kt)("p",null,"For ",(0,o.kt)("inlineCode",{parentName:"p"},"StudySets")," and ",(0,o.kt)("inlineCode",{parentName:"p"},"Meta-Analyses"),", you can browse and search any user-contributed items, including those from other users. "),(0,o.kt)("p",null,"Note that although you see all publically available items, you cannot edit somebody else's content. "),(0,o.kt)("admonition",{type:"note"},(0,o.kt)("p",{parentName:"admonition"},"We are currently working on a way to allow users to fork other users' ",(0,o.kt)("inlineCode",{parentName:"p"},"StudySets")," and ",(0,o.kt)("inlineCode",{parentName:"p"},"Meta-Analyses")," to create their own versions.\nStay tuned!\n::::")))}c.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/f72e48a3.7f2b8760.js b/assets/js/f72e48a3.9c7c8817.js similarity index 84% rename from assets/js/f72e48a3.7f2b8760.js rename to assets/js/f72e48a3.9c7c8817.js index 176c80f..d2c4040 100644 --- a/assets/js/f72e48a3.7f2b8760.js +++ b/assets/js/f72e48a3.9c7c8817.js @@ -1 +1 @@ -"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[5326],{3905:(e,t,r)=>{r.d(t,{Zo:()=>d,kt:()=>f});var n=r(7294);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function c(e){for(var t=1;t=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var l=n.createContext({}),s=function(e){var t=n.useContext(l),r=t;return e&&(r="function"==typeof e?e(t):c(c({},t),e)),r},d=function(e){var t=s(e.components);return n.createElement(l.Provider,{value:t},e.children)},u="mdxType",m={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},p=n.forwardRef((function(e,t){var r=e.components,a=e.mdxType,o=e.originalType,l=e.parentName,d=i(e,["components","mdxType","originalType","parentName"]),u=s(r),p=a,f=u["".concat(l,".").concat(p)]||u[p]||m[p]||o;return r?n.createElement(f,c(c({ref:t},d),{},{components:r})):n.createElement(f,c({ref:t},d))}));function f(e,t){var r=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=r.length,c=new Array(o);c[0]=p;var i={};for(var l in t)hasOwnProperty.call(t,l)&&(i[l]=t[l]);i.originalType=e,i[u]="string"==typeof e?e:a,c[1]=i;for(var s=2;s{r.d(t,{Z:()=>v});var n=r(7294),a=r(6010),o=r(2802),c=r(9960),i=r(3919),l=r(5999);const s={cardContainer:"cardContainer_fWXF",cardTitle:"cardTitle_rnsV",cardDescription:"cardDescription_PWke"};function d(e){let{href:t,children:r}=e;return n.createElement(c.Z,{href:t,className:(0,a.Z)("card padding--lg",s.cardContainer)},r)}function u(e){let{href:t,icon:r,title:o,description:c}=e;return n.createElement(d,{href:t},n.createElement("h2",{className:(0,a.Z)("text--truncate",s.cardTitle),title:o},r," ",o),c&&n.createElement("p",{className:(0,a.Z)("text--truncate",s.cardDescription),title:c},c))}function m(e){let{item:t}=e;const r=(0,o.Wl)(t);return r?n.createElement(u,{href:r,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:(0,l.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function p(e){let{item:t}=e;const r=(0,i.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",a=(0,o.xz)(t.docId??void 0);return n.createElement(u,{href:t.href,icon:r,title:t.label,description:a?.description})}function f(e){let{item:t}=e;switch(t.type){case"link":return n.createElement(p,{item:t});case"category":return n.createElement(m,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function y(e){let{className:t}=e;const r=(0,o.jA)();return n.createElement(v,{items:r.items,className:t})}function v(e){const{items:t,className:r}=e;if(!t)return n.createElement(y,e);const c=(0,o.MN)(t);return n.createElement("section",{className:(0,a.Z)("row",r)},c.map(((e,t)=>n.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},n.createElement(f,{item:e})))))}},3065:(e,t,r)=>{r.r(t),r.d(t,{assets:()=>s,contentTitle:()=>i,default:()=>p,frontMatter:()=>c,metadata:()=>l,toc:()=>d});var n=r(7462),a=(r(7294),r(3905)),o=r(2991);const c={title:"Advanced tutorials",sidebar_position:3},i="Advanced tutorials",l={unversionedId:"tutorial/advanced/index",id:"tutorial/advanced/index",title:"Advanced tutorials",description:"After you've completed the core Manual and Advanced tutorials, you can continue your learning journey with these advanced tutorials.",source:"@site/docs/tutorial/advanced/index.mdx",sourceDirName:"tutorial/advanced",slug:"/tutorial/advanced/",permalink:"/compose-docs/tutorial/advanced/",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/tutorial/advanced/index.mdx",tags:[],version:"current",lastUpdatedBy:"James Kent",lastUpdatedAt:1727371503,formattedLastUpdatedAt:"Sep 26, 2024",sidebarPosition:3,frontMatter:{title:"Advanced tutorials",sidebar_position:3},sidebar:"tutorialSidebar",previous:{title:"Automated Meta-Analysis",permalink:"/compose-docs/tutorial/automated"},next:{title:"MKDA Chi-Squared Association",permalink:"/compose-docs/tutorial/advanced/mkda_association"}},s={},d=[],u={toc:d},m="wrapper";function p(e){let{components:t,...r}=e;return(0,a.kt)(m,(0,n.Z)({},u,r,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"advanced-tutorials"},"Advanced tutorials"),(0,a.kt)("p",null,"After you've completed the core Manual and Advanced tutorials, you can continue your learning journey with these advanced tutorials."),(0,a.kt)(o.Z,{mdxType:"DocCardList"}))}p.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[5326],{3905:(e,t,r)=>{r.d(t,{Zo:()=>d,kt:()=>f});var n=r(7294);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function c(e){for(var t=1;t=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var l=n.createContext({}),s=function(e){var t=n.useContext(l),r=t;return e&&(r="function"==typeof e?e(t):c(c({},t),e)),r},d=function(e){var t=s(e.components);return n.createElement(l.Provider,{value:t},e.children)},u="mdxType",m={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},p=n.forwardRef((function(e,t){var r=e.components,a=e.mdxType,o=e.originalType,l=e.parentName,d=i(e,["components","mdxType","originalType","parentName"]),u=s(r),p=a,f=u["".concat(l,".").concat(p)]||u[p]||m[p]||o;return r?n.createElement(f,c(c({ref:t},d),{},{components:r})):n.createElement(f,c({ref:t},d))}));function f(e,t){var r=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=r.length,c=new Array(o);c[0]=p;var i={};for(var l in t)hasOwnProperty.call(t,l)&&(i[l]=t[l]);i.originalType=e,i[u]="string"==typeof e?e:a,c[1]=i;for(var s=2;s{r.d(t,{Z:()=>v});var n=r(7294),a=r(6010),o=r(2802),c=r(9960),i=r(3919),l=r(5999);const s={cardContainer:"cardContainer_fWXF",cardTitle:"cardTitle_rnsV",cardDescription:"cardDescription_PWke"};function d(e){let{href:t,children:r}=e;return n.createElement(c.Z,{href:t,className:(0,a.Z)("card padding--lg",s.cardContainer)},r)}function u(e){let{href:t,icon:r,title:o,description:c}=e;return n.createElement(d,{href:t},n.createElement("h2",{className:(0,a.Z)("text--truncate",s.cardTitle),title:o},r," ",o),c&&n.createElement("p",{className:(0,a.Z)("text--truncate",s.cardDescription),title:c},c))}function m(e){let{item:t}=e;const r=(0,o.Wl)(t);return r?n.createElement(u,{href:r,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:(0,l.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function p(e){let{item:t}=e;const r=(0,i.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",a=(0,o.xz)(t.docId??void 0);return n.createElement(u,{href:t.href,icon:r,title:t.label,description:a?.description})}function f(e){let{item:t}=e;switch(t.type){case"link":return n.createElement(p,{item:t});case"category":return n.createElement(m,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function y(e){let{className:t}=e;const r=(0,o.jA)();return n.createElement(v,{items:r.items,className:t})}function v(e){const{items:t,className:r}=e;if(!t)return n.createElement(y,e);const c=(0,o.MN)(t);return n.createElement("section",{className:(0,a.Z)("row",r)},c.map(((e,t)=>n.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},n.createElement(f,{item:e})))))}},3065:(e,t,r)=>{r.r(t),r.d(t,{assets:()=>s,contentTitle:()=>i,default:()=>p,frontMatter:()=>c,metadata:()=>l,toc:()=>d});var n=r(7462),a=(r(7294),r(3905)),o=r(2991);const c={title:"Advanced tutorials",sidebar_position:3},i="Advanced tutorials",l={unversionedId:"tutorial/advanced/index",id:"tutorial/advanced/index",title:"Advanced tutorials",description:"After you've completed the core Manual and Advanced tutorials, you can continue your learning journey with these advanced tutorials.",source:"@site/docs/tutorial/advanced/index.mdx",sourceDirName:"tutorial/advanced",slug:"/tutorial/advanced/",permalink:"/compose-docs/tutorial/advanced/",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/tutorial/advanced/index.mdx",tags:[],version:"current",lastUpdatedBy:"Alejandro de la Vega",lastUpdatedAt:1729891615,formattedLastUpdatedAt:"Oct 25, 2024",sidebarPosition:3,frontMatter:{title:"Advanced tutorials",sidebar_position:3},sidebar:"tutorialSidebar",previous:{title:"Automated Meta-Analysis",permalink:"/compose-docs/tutorial/automated"},next:{title:"MKDA Chi-Squared Association",permalink:"/compose-docs/tutorial/advanced/mkda_association"}},s={},d=[],u={toc:d},m="wrapper";function p(e){let{components:t,...r}=e;return(0,a.kt)(m,(0,n.Z)({},u,r,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"advanced-tutorials"},"Advanced tutorials"),(0,a.kt)("p",null,"After you've completed the core Manual and Advanced tutorials, you can continue your learning journey with these advanced tutorials."),(0,a.kt)(o.Z,{mdxType:"DocCardList"}))}p.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/f8f8f85a.46bd4f0c.js b/assets/js/f8f8f85a.46bd4f0c.js new file mode 100644 index 0000000..e0ee4b1 --- /dev/null +++ b/assets/js/f8f8f85a.46bd4f0c.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[519],{3905:(e,t,a)=>{a.d(t,{Zo:()=>l,kt:()=>m});var n=a(7294);function i(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function o(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,n)}return a}function r(e){for(var t=1;t=0||(i[a]=e[a]);return i}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(i[a]=e[a])}return i}var c=n.createContext({}),d=function(e){var t=n.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):r(r({},t),e)),a},l=function(e){var t=d(e.components);return n.createElement(c.Provider,{value:t},e.children)},u="mdxType",p={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},h=n.forwardRef((function(e,t){var a=e.components,i=e.mdxType,o=e.originalType,c=e.parentName,l=s(e,["components","mdxType","originalType","parentName"]),u=d(a),h=i,m=u["".concat(c,".").concat(h)]||u[h]||p[h]||o;return a?n.createElement(m,r(r({ref:t},l),{},{components:a})):n.createElement(m,r({ref:t},l))}));function m(e,t){var a=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var o=a.length,r=new Array(o);r[0]=h;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s[u]="string"==typeof e?e:i,r[1]=s;for(var d=2;d{a.r(t),a.d(t,{assets:()=>c,contentTitle:()=>r,default:()=>p,frontMatter:()=>o,metadata:()=>s,toc:()=>d});var n=a(7462),i=(a(7294),a(3905));const o={title:"Extraction",sidebar_position:1},r="Extraction",s={unversionedId:"guide/Project/Extraction",id:"guide/Project/Extraction",title:"Extraction",description:"Extraction is the second step in creating a meta-analysis. It involves using the",source:"@site/docs/guide/Project/Extraction.md",sourceDirName:"guide/Project",slug:"/guide/Project/Extraction",permalink:"/compose-docs/guide/Project/Extraction",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/guide/Project/Extraction.md",tags:[],version:"current",lastUpdatedBy:"Alejandro de la Vega",lastUpdatedAt:1729891615,formattedLastUpdatedAt:"Oct 25, 2024",sidebarPosition:1,frontMatter:{title:"Extraction",sidebar_position:1},sidebar:"tutorialSidebar",previous:{title:"Curation",permalink:"/compose-docs/guide/Project/Curation"},next:{title:"Specification",permalink:"/compose-docs/guide/Project/Specification"}},c={},d=[{value:"Getting Started",id:"getting-started",level:2},{value:"Ingestion",id:"ingestion",level:2},{value:"Extraction Table",id:"extraction-table",level:2},{value:"Annotations",id:"annotations",level:2},{value:"Study Editing",id:"study-editing",level:2},{value:"Syncing Between Curation and Extraction",id:"syncing-between-curation-and-extraction",level:2},{value:"Completion",id:"completion",level:2}],l={toc:d},u="wrapper";function p(e){let{components:t,...o}=e;return(0,i.kt)(u,(0,n.Z)({},l,o,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"extraction"},"Extraction"),(0,i.kt)("p",null,"Extraction is the second step in creating a meta-analysis. It involves using the\n",(0,i.kt)("a",{parentName:"p",href:"/compose-docs/guide/glossary#studyset"},(0,i.kt)("strong",{parentName:"a"},"Studyset"))," created during the curation step to extract relevant information from studies, such as ",(0,i.kt)("a",{parentName:"p",href:"/compose-docs/guide/glossary#annotation"},(0,i.kt)("strong",{parentName:"a"},"annotations")),", and peak activation coordinates, or ",(0,i.kt)("a",{parentName:"p",href:"/compose-docs/guide/glossary#point"},(0,i.kt)("strong",{parentName:"a"},"points")),"."),(0,i.kt)("h2",{id:"getting-started"},"Getting Started"),(0,i.kt)("p",null,"Once curation is complete, the user is redirected to the extraction phase."),(0,i.kt)("p",null,"This phase begins with a wizard that guides the user through initializing the extraction process. In addition to creating initial ",(0,i.kt)("a",{parentName:"p",href:"./Extraction#annotations"},(0,i.kt)("strong",{parentName:"a"},"annotation columns")),", the wizard assists the user with the ",(0,i.kt)("a",{parentName:"p",href:"./Extraction#ingestion"},(0,i.kt)("strong",{parentName:"a"},"ingestion")," ")," of curated studies to generate a new ",(0,i.kt)("a",{parentName:"p",href:"../glossary#studyset"},(0,i.kt)("strong",{parentName:"a"},"studyset")),"."),(0,i.kt)("h2",{id:"ingestion"},"Ingestion"),(0,i.kt)("p",null,"Ingestion is the process of importing studies from the curation phase into the database."),(0,i.kt)("p",null,"For each study, Neurosynth-Compose searches the Neurostore database for matches. If a study is not already in the database, a new entry is created, requiring the user to extract relevant information from the corresponding paper (e.g., activation coordinates). "),(0,i.kt)("p",null,"If multiple matches are found, the most recently updated one is selected, though the user can switch to a different version if desired. Existing versions may have been automatically extracted by the database or contributed by other users."),(0,i.kt)("admonition",{title:"Why Ingestion? ",type:"info"},(0,i.kt)("p",{parentName:"admonition"},"During curation, studies are not yet inserted into the database. Many studies imported during curation are excluded from the final set. Inserting all studies at this stage would clutter the database with entries that lack coordinates or may never be used. By waiting until the final subset is selected, we reduce the number of empty or irrelevant entries in the database. ")),(0,i.kt)("h2",{id:"extraction-table"},"Extraction Table"),(0,i.kt)("p",null,(0,i.kt)("img",{alt:"Extraction Table",src:a(218).Z,width:"1340",height:"571"})),(0,i.kt)("p",null,"Once ingestion is complete, the user is shown a table listing the studies within the studyset. The extraction step involves iteratively reviewing each study to make sure they contain information suitable for meta-analysis.\nStudies in the extraction phase are filtered and categorized to better organize and streamine the process. Initially, all studies\nare marked as ",(0,i.kt)("strong",{parentName:"p"},"Unreviewed"),", and the user can decide to mark them as ",(0,i.kt)("strong",{parentName:"p"},"Save For Later")," if they want to revisit the study, or ",(0,i.kt)("strong",{parentName:"p"},"Completed")," when they are finished."),(0,i.kt)("p",null,"If a study does not have any extracted coordinates, the user must manually locate the original paper and find the coordinates to add to the study."),(0,i.kt)("p",null,"If the study has automatically extracted coordinates, the user needs only to verify that these coordinates are satisfactory."),(0,i.kt)("p",null,"The table provides functionality for filtering amongst various columns as well as sorting. To start editing a study, click on one of the table rows."),(0,i.kt)("h2",{id:"annotations"},"Annotations"),(0,i.kt)("p",null,(0,i.kt)("img",{alt:"Annotations Table",src:a(7949).Z,width:"767",height:"752"})),(0,i.kt)("p",null,(0,i.kt)("a",{parentName:"p",href:"../glossary#annotation"},"Annotations")," are a way to assign data to each ",(0,i.kt)("a",{parentName:"p",href:"../glossary#analysis"},(0,i.kt)("strong",{parentName:"a"},"analysis"))," within the studyset. Annotation values can be later used to filter out analyses to include within a meta-analysis."),(0,i.kt)("p",null,'In the extraction page, click the "Annotations" button on the top right. Annotations are represented with a spreadsheet like interface, where the row headers are the respective studies and their analyses, and the column headers are the properties for\neach of those study analyses. Each cell in the spreadsheet repreesnts the value for a given property of a study\'s analysis.'),(0,i.kt)("p",null,"By default, all annotations will include a column labeled included, which is initially set to true. This column can be modified if needed."),(0,i.kt)("h2",{id:"study-editing"},"Study Editing"),(0,i.kt)("p",null,(0,i.kt)("img",{alt:"Study Editing",src:a(6484).Z,width:"796",height:"778"})),(0,i.kt)("p",null,"Clicking on a study in the extraction table leads to the study editing page. Here, users can edit study coordinates, add new analyses to the study, and modify details such as the study's name, authors, PMID, DOI, etc. If you wish to update annotation values for a specific study, you can do so using the study's annotations table."),(0,i.kt)("h2",{id:"syncing-between-curation-and-extraction"},"Syncing Between Curation and Extraction"),(0,i.kt)("p",null,(0,i.kt)("img",{alt:"Out of Sync",src:a(7075).Z,width:"1514",height:"157"})),(0,i.kt)("p",null,"Ideally, once the curation phase is complete, no further changes are made. However, in practice, this is not always possible."),(0,i.kt)("p",null,"If changes are made during the curation phase (for example, if a previously included study is excluded or an excluded study is included), the extraction phase will no longer align with the output of the curation phase. In such cases, the extraction phase needs to be resynchronized with the updates from the curation phase. When Neurosynth-Compose detects a mismatch between the two phases, a banner will appear prompting the user to resynchronize the extraction phase with the updated curation phase."),(0,i.kt)("h2",{id:"completion"},"Completion"),(0,i.kt)("p",null,"The extraction phase is considered complete once all studies have been marked as Completed. At this point, the user is prompted to proceed to the meta-analysis configuration step. Once all studies are marked as complete, a button will appear, allowing the user to continue with the meta-analysis process."),(0,i.kt)("admonition",{type:"info"},(0,i.kt)("p",{parentName:"admonition"},'If you would like to skip the extraction step, you can return to the project page and click the "Mark all as complete" button under the extraction section.'),(0,i.kt)("p",{parentName:"admonition"},(0,i.kt)("img",{alt:"Mark all as complete",src:a(5486).Z,width:"1472",height:"376"}))))}p.isMDXComponent=!0},7949:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/annotation_spreadsheet-702edda846ed9996eaec518b0f5f0e0b.png"},218:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/extraction_table-e3acf47614004f05e0ee5b8980f1ffed.png"},5486:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/mark_all_as_complete-76f700aad1d42edc7c2cbc37311f391f.png"},7075:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/out_of_sync-3f705ddb5b4dade3d39a664b090ded8e.png"},6484:(e,t,a)=>{a.d(t,{Z:()=>n});const n=a.p+"assets/images/study_edit-4385731df101f12c4815b30dbefb6de7.png"}}]); \ No newline at end of file diff --git a/assets/js/f8f8f85a.bb0ee6a6.js b/assets/js/f8f8f85a.bb0ee6a6.js deleted file mode 100644 index ee9ca0a..0000000 --- a/assets/js/f8f8f85a.bb0ee6a6.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[519],{3905:(e,t,n)=>{n.d(t,{Zo:()=>l,kt:()=>m});var a=n(7294);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function s(e){for(var t=1;t=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var c=a.createContext({}),d=function(e){var t=a.useContext(c),n=t;return e&&(n="function"==typeof e?e(t):s(s({},t),e)),n},l=function(e){var t=d(e.components);return a.createElement(c.Provider,{value:t},e.children)},u="mdxType",p={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},h=a.forwardRef((function(e,t){var n=e.components,o=e.mdxType,i=e.originalType,c=e.parentName,l=r(e,["components","mdxType","originalType","parentName"]),u=d(n),h=o,m=u["".concat(c,".").concat(h)]||u[h]||p[h]||i;return n?a.createElement(m,s(s({ref:t},l),{},{components:n})):a.createElement(m,s({ref:t},l))}));function m(e,t){var n=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var i=n.length,s=new Array(i);s[0]=h;var r={};for(var c in t)hasOwnProperty.call(t,c)&&(r[c]=t[c]);r.originalType=e,r[u]="string"==typeof e?e:o,s[1]=r;for(var d=2;d{n.r(t),n.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>p,frontMatter:()=>i,metadata:()=>r,toc:()=>d});var a=n(7462),o=(n(7294),n(3905));const i={title:"Extraction",sidebar_position:1},s="Extraction",r={unversionedId:"guide/Project/Extraction",id:"guide/Project/Extraction",title:"Extraction",description:"Extraction is the second step in creating a meta-analysis. It involves taking the",source:"@site/docs/guide/Project/Extraction.md",sourceDirName:"guide/Project",slug:"/guide/Project/Extraction",permalink:"/compose-docs/guide/Project/Extraction",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/guide/Project/Extraction.md",tags:[],version:"current",lastUpdatedBy:"James Kent",lastUpdatedAt:1727371503,formattedLastUpdatedAt:"Sep 26, 2024",sidebarPosition:1,frontMatter:{title:"Extraction",sidebar_position:1},sidebar:"tutorialSidebar",previous:{title:"Curation",permalink:"/compose-docs/guide/Project/Curation"},next:{title:"Specification",permalink:"/compose-docs/guide/Project/Specification"}},c={},d=[{value:"Getting Started",id:"getting-started",level:2},{value:"Ingestion",id:"ingestion",level:2},{value:"Extraction Table",id:"extraction-table",level:2},{value:"Annotations",id:"annotations",level:2},{value:"Study Editing",id:"study-editing",level:2},{value:"Syncing Between Curation and Extraction",id:"syncing-between-curation-and-extraction",level:2},{value:"Completion",id:"completion",level:2}],l={toc:d},u="wrapper";function p(e){let{components:t,...i}=e;return(0,o.kt)(u,(0,a.Z)({},l,i,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"extraction"},"Extraction"),(0,o.kt)("p",null,"Extraction is the second step in creating a meta-analysis. It involves taking the\nnew ",(0,o.kt)("a",{parentName:"p",href:"/compose-docs/guide/glossary#studyset"},(0,o.kt)("strong",{parentName:"a"},"Studyset"))," creates in the curation step and extracting relevant information from studies, such as ",(0,o.kt)("a",{parentName:"p",href:"/compose-docs/guide/glossary#annotation"},(0,o.kt)("strong",{parentName:"a"},"annotations")),",\nand peak activation coordinates, or ",(0,o.kt)("a",{parentName:"p",href:"/compose-docs/guide/glossary#point"},(0,o.kt)("strong",{parentName:"a"},"points")),"."),(0,o.kt)("h2",{id:"getting-started"},"Getting Started"),(0,o.kt)("p",null,"After the curation phase is complete, the user is redirected to the extraction phase. You can also access the Extraction phase through the main project page."),(0,o.kt)("p",null,"Here, the extraction phase starts when\na wizard that pops up and guides the user through the process of initializing the extraction phase. On top of creating the\ninitial ",(0,o.kt)("a",{parentName:"p",href:"./Extraction#annotations"},(0,o.kt)("strong",{parentName:"a"},"annotation columns")),", this wizard also guides the user through the\nprocess of ",(0,o.kt)("a",{parentName:"p",href:"./Extraction#ingestion"},(0,o.kt)("strong",{parentName:"a"},"ingestion")," ")," of the curated studies to create a new ",(0,o.kt)("a",{parentName:"p",href:"../glossary#studyset"},(0,o.kt)("strong",{parentName:"a"},"studyset")),"."),(0,o.kt)("h2",{id:"ingestion"},"Ingestion"),(0,o.kt)("p",null,"Ingestion describes the process of taking the studies from the curation phase and inserting them into the database one by one."),(0,o.kt)("p",null,"For each study, neurosynth-compose searches the neurostore database and checks to see if a matching study exists. If a match\ndoes not exist, then a new study is created and the user must go to the paper to fill out the relevant details.\nIf one or more matches are found, neurosynth-compose will choose the most recently updated one by default. The user can later go in and switch to a different version if the one selected is not the ony they wanted."),(0,o.kt)("admonition",{title:"Why ingestion?",type:"info"},(0,o.kt)("p",{parentName:"admonition"},"During the curation phase, studies are actually not inserted into the database. A vast majority of the studies that\nare imported into the curation phase are excluded during the curation process. Inserting these studies into the database would clutter\nit and create a lot of empty entries which don't have coordinates and might not even be used. By waiting until we have our finalized\nincluded subset of studies, we reduce the number of empty, useless studies in the database.")),(0,o.kt)("h2",{id:"extraction-table"},"Extraction Table"),(0,o.kt)("p",null,(0,o.kt)("img",{alt:"Extraction Table",src:n(218).Z,width:"1340",height:"571"})),(0,o.kt)("p",null,"Once ingestion is complete, the user is shown a table listing the studies within the studyset. The extraction step involves iteratively reviewing each study to make sure they contain information amenable to a meta-analysis.\nStudies in the extraction phase are filtered and categorized to help better organize and facilitate the process. Initially, all studies\nstart as ",(0,o.kt)("strong",{parentName:"p"},"Unreviewed"),". The user can then decide to mark them as ",(0,o.kt)("strong",{parentName:"p"},"Save For Later")," if they want to revisit the study, or ",(0,o.kt)("strong",{parentName:"p"},"Completed"),"."),(0,o.kt)("p",null,"If the study does not have any already extracted coordinates, then the user should go and find the original paper and manually search for the coordinates to add to the study."),(0,o.kt)("p",null,"If the study has automatically extracted coordinates, then the user only has to validate that these coordinates are satisfactory."),(0,o.kt)("p",null,"The table provides functionality for filtering amongst various columns as well as sorting. To start editing a study, click on one of the table rows."),(0,o.kt)("h2",{id:"annotations"},"Annotations"),(0,o.kt)("p",null,(0,o.kt)("img",{alt:"Annotations Table",src:n(7949).Z,width:"767",height:"752"})),(0,o.kt)("p",null,(0,o.kt)("a",{parentName:"p",href:"../glossary#annotation"},"Annotations")," are a way to assign data to each ",(0,o.kt)("a",{parentName:"p",href:"../glossary#analysis"},(0,o.kt)("strong",{parentName:"a"},"analysis"))," within the studyset. Annotation values can be later used to filter out analyses to include within a meta-analysis."),(0,o.kt)("p",null,'In the extraction page, click the "Annotations" button on the top right. Annotations are represented with a spreadsheet like interface, where the row headers are the respective studies and their analyses, and the column headers are the properties for\neach of those study analyses. Each cell in the spreadsheet repreesnts the value for a given property of a study\'s analysis.'),(0,o.kt)("p",null,"By default, all annotations will start with a column ",(0,o.kt)("strong",{parentName:"p"},"included")," which will be set to true. This column can be modified if needed."),(0,o.kt)("h2",{id:"study-editing"},"Study Editing"),(0,o.kt)("p",null,(0,o.kt)("img",{alt:"Study Editing",src:n(6484).Z,width:"796",height:"778"})),(0,o.kt)("p",null,"Clicking on a study in the extraction table will lead you to the study editing page. This page allows you to edit study coordinates, add new analyses to the study, as well as modify the study name, authors, PMID, DOI, etc.\nIf you would like to update the annotation values just for the given study, you can do so utilizing the study annotations table."),(0,o.kt)("h2",{id:"syncing-between-curation-and-extraction"},"Syncing Between Curation and Extraction"),(0,o.kt)("p",null,(0,o.kt)("img",{alt:"Out of Sync",src:n(7075).Z,width:"1514",height:"157"})),(0,o.kt)("p",null,"In an ideal meta-analysis process, once the curation phase is completed then it is not touched again. However, this is not always possible in the real world."),(0,o.kt)("p",null,'If the curation phase is modified (for example if a study previously marked as "included" was excluded, or an additional study that was previously excluded was changed to "included") then the extraction phase\nno longer represents the output of the curation phase. In a situation like this, we need to resynchronize these two so that the extraction phase is aligned again. When neurosynth-compose encounters a mismatch\nbetween the two phases, a banner will pop up prompting the user to synchronize the extraction phase with the new curation phase updates.'),(0,o.kt)("p",null,"Successfully resynchronizing the two phases will cause the banner to go away."),(0,o.kt)("h2",{id:"completion"},"Completion"),(0,o.kt)("p",null,"The extraction phase is considered complete and the user is prompted to move on when all studies have been marked as complete. Once this step is complete, it is then time to specify the configurations for your meta-analysis.\nWhen all studies are marked as completed, a button should appear prompting the user to continue the meta-analysis process."),(0,o.kt)("admonition",{type:"info"},(0,o.kt)("p",{parentName:"admonition"},'If you would like to skip the extraction step, then you can go back to the project page and click the button: "Mark all as complete" underneath the extraction section.'),(0,o.kt)("p",{parentName:"admonition"},(0,o.kt)("img",{alt:"Mark all as complete",src:n(5486).Z,width:"1472",height:"376"}))))}p.isMDXComponent=!0},7949:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/annotation_spreadsheet-702edda846ed9996eaec518b0f5f0e0b.png"},218:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/extraction_table-e3acf47614004f05e0ee5b8980f1ffed.png"},5486:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/mark_all_as_complete-76f700aad1d42edc7c2cbc37311f391f.png"},7075:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/out_of_sync-3f705ddb5b4dade3d39a664b090ded8e.png"},6484:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/study_edit-4385731df101f12c4815b30dbefb6de7.png"}}]); \ No newline at end of file diff --git a/assets/js/fb8c922a.4a7cb5fa.js b/assets/js/fb8c922a.4a7cb5fa.js new file mode 100644 index 0000000..349152e --- /dev/null +++ b/assets/js/fb8c922a.4a7cb5fa.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[9687],{3905:(e,t,r)=>{r.d(t,{Zo:()=>d,kt:()=>m});var n=r(7294);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function i(e){for(var t=1;t=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var s=n.createContext({}),c=function(e){var t=n.useContext(s),r=t;return e&&(r="function"==typeof e?e(t):i(i({},t),e)),r},d=function(e){var t=c(e.components);return n.createElement(s.Provider,{value:t},e.children)},p="mdxType",u={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},h=n.forwardRef((function(e,t){var r=e.components,a=e.mdxType,o=e.originalType,s=e.parentName,d=l(e,["components","mdxType","originalType","parentName"]),p=c(r),h=a,m=p["".concat(s,".").concat(h)]||p[h]||u[h]||o;return r?n.createElement(m,i(i({ref:t},d),{},{components:r})):n.createElement(m,i({ref:t},d))}));function m(e,t){var r=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=r.length,i=new Array(o);i[0]=h;var l={};for(var s in t)hasOwnProperty.call(t,s)&&(l[s]=t[s]);l.originalType=e,l[p]="string"==typeof e?e:a,i[1]=l;for(var c=2;c{r.r(t),r.d(t,{assets:()=>s,contentTitle:()=>i,default:()=>u,frontMatter:()=>o,metadata:()=>l,toc:()=>c});var n=r(7462),a=(r(7294),r(3905));const o={title:"Project",sidebar_position:0},i="Project",l={unversionedId:"guide/Project/index",id:"guide/Project/index",title:"Project",description:"Overview",source:"@site/docs/guide/Project/index.mdx",sourceDirName:"guide/Project",slug:"/guide/Project/",permalink:"/compose-docs/guide/Project/",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/guide/Project/index.mdx",tags:[],version:"current",lastUpdatedBy:"Alejandro de la Vega",lastUpdatedAt:1729891615,formattedLastUpdatedAt:"Oct 25, 2024",sidebarPosition:0,frontMatter:{title:"Project",sidebar_position:0},sidebar:"tutorialSidebar",previous:{title:"User Guide",permalink:"/compose-docs/guide/"},next:{title:"Curation",permalink:"/compose-docs/guide/Project/Curation"}},s={},c=[{value:"Overview",id:"overview",level:2},{value:"Create a project",id:"create-a-project",level:2},{value:"Create a blank project",id:"create-a-blank-project",level:3},{value:"Create a project from a sleuth file",id:"create-a-project-from-a-sleuth-file",level:3},{value:"Sleuth file format requirements",id:"sleuth-file-format-requirements",level:4},{value:"1. File Reference.",id:"1-file-reference",level:5},{value:"2. Identifier (DOI or PubMed Id)",id:"2-identifier-doi-or-pubmed-id",level:5},{value:"3. Author, year & experiment name",id:"3-author-year--experiment-name",level:5},{value:"4.Subjects",id:"4subjects",level:5},{value:"5. Coordinates",id:"5-coordinates",level:5},{value:"Common Import errors",id:"common-import-errors",level:4},{value:"Opening a project",id:"opening-a-project",level:2}],d={toc:c},p="wrapper";function u(e){let{components:t,...r}=e;return(0,a.kt)(p,(0,n.Z)({},d,r,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"project"},"Project"),(0,a.kt)("h2",{id:"overview"},"Overview"),(0,a.kt)("p",null,"A project organizes the the various steps needed to create a meta-analysis from start to finish."),(0,a.kt)("p",null,"Within a project you will be able to:"),(0,a.kt)("ol",null,(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("strong",{parentName:"li"},(0,a.kt)("a",{parentName:"strong",href:"./Project/Curation"},"Curate"))," studies of interest and select the ones to be included in the meta-analysis"),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("strong",{parentName:"li"},(0,a.kt)("a",{parentName:"strong",href:"./Project/Extraction"},"Extract"))," the relevant data such as activation coordinates and other meta-data"),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("strong",{parentName:"li"},(0,a.kt)("a",{parentName:"strong",href:"./Project/Specification"},"Specify"))," the algorithm and corrector you would like to use")),(0,a.kt)("p",null,"In each project, you can define a single studyset (i.e. a collection of related studies defined and used in the extraction phase), and one or more meta-analysis specifications."),(0,a.kt)("h2",{id:"create-a-project"},"Create a project"),(0,a.kt)("p",null,"There are two ways to create a project and do your meta-analysis."),(0,a.kt)("h3",{id:"create-a-blank-project"},"Create a blank project"),(0,a.kt)("p",null,'The first method is to click on the "NEW PROJECT" button in the top navigation menu. This will create a new blank project. You will then be asked to get started on the ',(0,a.kt)("a",{parentName:"p",href:"/compose-docs/guide/Project/Curation"},"curation phase")," in order to progress."),(0,a.kt)("h3",{id:"create-a-project-from-a-sleuth-file"},"Create a project from a sleuth file"),(0,a.kt)("p",null,'The second method of creating a project is to click on the dropdown button on the right of "NEW PROJECT". This will show an option: "Create project from sleuth file". Click on that option and you will be brought to a new page to begin creating a new project from your sleuth file.'),(0,a.kt)("p",null,"Please note that neurosynth-compose requires a specific format in order to proceed with the import. We require that each experiment within the sleuth file ",(0,a.kt)("em",{parentName:"p"},"references either a PubMed ID or a DOI"),". The exact requirements are specified below:"),(0,a.kt)("h4",{id:"sleuth-file-format-requirements"},"Sleuth file format requirements"),(0,a.kt)("h5",{id:"1-file-reference"},"1. File Reference."),(0,a.kt)("p",null,"This reference specifies the coordinate space and must appear at the top of the file. Do not omit the first two forward slashes.",(0,a.kt)("br",null)),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre"},"// Reference=MNI\n")),(0,a.kt)("h5",{id:"2-identifier-doi-or-pubmed-id"},"2. Identifier (DOI or PubMed Id)"),(0,a.kt)("p",null,"The next lines of the file represents an experiment. We expect an identifier: ",(0,a.kt)("em",{parentName:"p"},"this can either be a DOI, a PubMedId, or both"),". Do not omit the first two forward slashes.",(0,a.kt)("br",null)),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre"},"// DOI=10.1038/nmeth.1635\nor\n// PubMedId=21706013\nor\n// DOI=10.1038/nmeth.1635\n// PubMedId=21706013\n")),(0,a.kt)("h5",{id:"3-author-year--experiment-name"},"3. Author, year & experiment name"),(0,a.kt)("p",null,"We expect a line containing the authors, year, and experiment name. The authors + year should be separated from the experiment name by a colon. There can be 1 or more lines representing multiple authors + year and experiment name. Do not omit the first two forward slashes."),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre"},"// Smith et al., 1996: 1 Back vs 0 Back\nor\n// Smith et al., 1996: 1 Back vs 0 Back\n// Graeff et al., 1995: 2 Back vs 1 Back\n// Edwards et al., 2017: 2 Back vs 0 Back\n")),(0,a.kt)("h5",{id:"4subjects"},"4.Subjects"),(0,a.kt)("p",null,"After the lines representing one or more authors + year and experiment name, add a line for the number of subjects in the experiment."),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre"},"// Subjects=23\n")),(0,a.kt)("h5",{id:"5-coordinates"},"5. Coordinates"),(0,a.kt)("p",null,"Add the X, Y, and Z coordinates. Do not add the two forward slashes. The coordinates should be ",(0,a.kt)("strong",{parentName:"p"},"delimited by tabs"),"."),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre"},"-27 34 72\n-7 -8 -9\n10 -12 -62\n")),(0,a.kt)("p",null,"Your sleuth file should look something like this:"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre"},"// Reference=MNI\n// DOI=10.1016/1234567\n// PubMedId=67123237\n// Smith et al., 2019: Working Memory vs Baseline\n// Subjects=23\n-2 8 9\n10 -12 -62\n21 -14 -2\n0 -9 16\n\n// DOI=10.217/1234568\n// PubMedId=23782389\n// Roberts et al., 1995: 2 Back vs 1 Back\n// Graeff et al., 2000: 1 Back vs 0 Back\n// Edwards et al., 2017: 2 Back vs 0 Back\n// Subjects=62\n82 12 0\n-27 34 72\n-7 -8 -9\n10 -12 -62\n")),(0,a.kt)("h4",{id:"common-import-errors"},"Common Import errors"),(0,a.kt)("p",null,(0,a.kt)("inlineCode",{parentName:"p"},"Either DOI or PMID is required. (Hint: is it in the right format?) Encountered error at <...>"),(0,a.kt)("br",null),"\nThis error indicates that neither a DOI nor PMID was found at the given line. Please check that the DOI or PubMedId given was correctly formulated."),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre"},"// DOI=10.1038/nmeth.1635\n// PubMedId=21706013\n")),(0,a.kt)("p",null,(0,a.kt)("inlineCode",{parentName:"p"},"Unexpected format. (Hint: Did you omit a colon or use a semi colon instead of a colon?) Encountered error at: <...>"),(0,a.kt)("br",null),"\nThis error indicates that neurosynth-compose expected to find a valid author + year and experiment name separated by a colon. Instead, it found a string that it did not recognize (or no experiment name was provided at all). Check that the line of the file indicated in the error message contains a correctly formulated author + year and experiment pairing like:"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre"},"// Roberts et al., 1995: 2 Back vs 1 Back\n")),(0,a.kt)("p",null,"or multiple"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre"},"// Roberts et al., 1995: 2 Back vs 1 Back\n// Graeff et al., 2000: 1 Back vs 0 Back\n// Edwards et al., 2017: 2 Back vs 0 Back\n")),(0,a.kt)("p",null,(0,a.kt)("inlineCode",{parentName:"p"},"Expected valid DOI but did not find one. Encountered error at: <...>")," ",(0,a.kt)("br",null),"\nThis error indicates that the format of the file did not adhere to the expected requirements due to an invalid DOI. Check that the line of the file indicated in the error message contains a correctly formulated DOI like: ",(0,a.kt)("inlineCode",{parentName:"p"},"// DOI=10.1038/nmeth.1635")),(0,a.kt)("p",null,(0,a.kt)("inlineCode",{parentName:"p"},"At least one experiment name is required. Encountered error at: <...>"),(0,a.kt)("br",null),"\nThis error indicates that no experiments were found at the line given by the error message. Please check that the sleuth file has at least one author + year and experiment name, or that the format is correctly formatted like: ",(0,a.kt)("inlineCode",{parentName:"p"},"// Smith et al., 2019: Working Memory vs Baseline")),(0,a.kt)("p",null,(0,a.kt)("inlineCode",{parentName:"p"},"Expected valid PMID but did not find one. Encountered error at: <...>"),(0,a.kt)("br",null),"\nThis error indicates that the format of the file did not adhere to the expected requirements due to an invalid PubMedId. Check that the line of the file indicated in the error message contains a correctly formulated PubMedId like: ",(0,a.kt)("inlineCode",{parentName:"p"},"// PubMedId=21706013")),(0,a.kt)("p",null,(0,a.kt)("inlineCode",{parentName:"p"},"Encountered multiple DOIs: <...>"),(0,a.kt)("br",null),"\nThis error indicates that multiple DOIs were discovered for the same experiment while parsing the file. Check that the line of the file indicated is part of an experiment that only has one DOI."),(0,a.kt)("p",null,(0,a.kt)("inlineCode",{parentName:"p"},"Encountered multiple PubMed IDs: <...>"),(0,a.kt)("br",null),"\nThis error indicates that multiple PubMedIds were discovered for the same experiment while parsing the file. Check that the line of the file indicated is part of an experiment that only has one PubMedId."),(0,a.kt)("p",null,(0,a.kt)("inlineCode",{parentName:"p"},"Expected number of subjects. Encountered error at: <...>"),(0,a.kt)("br",null),"\nThis error indicates that the format of the file did not adhere to the expected requirements due to an invalid Subjects field. Check that the line of the file indicated in the error message contains a correctly formulated Subjects field like: ",(0,a.kt)("inlineCode",{parentName:"p"},"// Subjects=23"),". Make sure that it is not separated by a new line."),(0,a.kt)("p",null,(0,a.kt)("inlineCode",{parentName:"p"},"Invalid coordinates: <...>"),(0,a.kt)("br",null),"\nThe coordinates given were not in a valid format. Check that the line of the file indicated in the error message contains correctly formulated, tab separated coordinates. They should look like:"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre"},"82 12 0\n-27 34 72\n-7 -8 -9\n10 -12 -62\n10 -12 -62\n21 -14 -2\n0 -9 16\n")),(0,a.kt)("p",null,(0,a.kt)("inlineCode",{parentName:"p"},"Unexpected format. Encountered error at: <...>"),(0,a.kt)("br",null),"\nThis error indicates that neurosynth-compose tried to extract the author data from the file but was unable to do so either because the author was not provided or the string was formed in such a way that was not recognized. Check that the line of the file indicated in the error message contains a correctly formulated string like: ",(0,a.kt)("inlineCode",{parentName:"p"},"// Roberts et al., 1995: 2 Back vs 1 Back")),(0,a.kt)("h2",{id:"opening-a-project"},"Opening a project"),(0,a.kt)("p",null,"You can open a specific project by logging in, navigating to the\n",(0,a.kt)("a",{parentName:"p",href:"https://compose.neurosynth.org/projects"},"My Projects")," page, and selecting a project you've created."),(0,a.kt)("p",null,'When you view a project for the first time, you\'ll notice that you\'ll default to the "Project" tab. Another tab, "Meta-Analyses", will become visible when you have completed both the curation and extraction phases.'))}u.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/fb8c922a.ea7c56c6.js b/assets/js/fb8c922a.ea7c56c6.js deleted file mode 100644 index 6a3c787..0000000 --- a/assets/js/fb8c922a.ea7c56c6.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkns_compose_docs=self.webpackChunkns_compose_docs||[]).push([[9687],{3905:(e,t,r)=>{r.d(t,{Zo:()=>d,kt:()=>m});var n=r(7294);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function i(e){for(var t=1;t=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var s=n.createContext({}),c=function(e){var t=n.useContext(s),r=t;return e&&(r="function"==typeof e?e(t):i(i({},t),e)),r},d=function(e){var t=c(e.components);return n.createElement(s.Provider,{value:t},e.children)},p="mdxType",u={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},h=n.forwardRef((function(e,t){var r=e.components,a=e.mdxType,o=e.originalType,s=e.parentName,d=l(e,["components","mdxType","originalType","parentName"]),p=c(r),h=a,m=p["".concat(s,".").concat(h)]||p[h]||u[h]||o;return r?n.createElement(m,i(i({ref:t},d),{},{components:r})):n.createElement(m,i({ref:t},d))}));function m(e,t){var r=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=r.length,i=new Array(o);i[0]=h;var l={};for(var s in t)hasOwnProperty.call(t,s)&&(l[s]=t[s]);l.originalType=e,l[p]="string"==typeof e?e:a,i[1]=l;for(var c=2;c{r.r(t),r.d(t,{assets:()=>s,contentTitle:()=>i,default:()=>u,frontMatter:()=>o,metadata:()=>l,toc:()=>c});var n=r(7462),a=(r(7294),r(3905));const o={title:"Project",sidebar_position:0},i="Project",l={unversionedId:"guide/Project/index",id:"guide/Project/index",title:"Project",description:"Overview",source:"@site/docs/guide/Project/index.mdx",sourceDirName:"guide/Project",slug:"/guide/Project/",permalink:"/compose-docs/guide/Project/",draft:!1,editUrl:"https://github.com/neurostuff/compose-docs/edit/master/docs/guide/Project/index.mdx",tags:[],version:"current",lastUpdatedBy:"James Kent",lastUpdatedAt:1727371503,formattedLastUpdatedAt:"Sep 26, 2024",sidebarPosition:0,frontMatter:{title:"Project",sidebar_position:0},sidebar:"tutorialSidebar",previous:{title:"User Guide",permalink:"/compose-docs/guide/"},next:{title:"Curation",permalink:"/compose-docs/guide/Project/Curation"}},s={},c=[{value:"Overview",id:"overview",level:2},{value:"Create a project",id:"create-a-project",level:2},{value:"Create a blank project",id:"create-a-blank-project",level:3},{value:"Create a project from a sleuth file",id:"create-a-project-from-a-sleuth-file",level:3},{value:"Sleuth file format requirements",id:"sleuth-file-format-requirements",level:4},{value:"1. File Reference.",id:"1-file-reference",level:5},{value:"2. Identifier (DOI or PubMed Id)",id:"2-identifier-doi-or-pubmed-id",level:5},{value:"3. Author, year & experiment name",id:"3-author-year--experiment-name",level:5},{value:"4.Subjects",id:"4subjects",level:5},{value:"5. Coordinates",id:"5-coordinates",level:5},{value:"Common Import errors",id:"common-import-errors",level:4},{value:"Opening a project",id:"opening-a-project",level:2}],d={toc:c},p="wrapper";function u(e){let{components:t,...r}=e;return(0,a.kt)(p,(0,n.Z)({},d,r,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"project"},"Project"),(0,a.kt)("h2",{id:"overview"},"Overview"),(0,a.kt)("p",null,"A project organizes the the various steps needed to create a meta-analysis from start to finish."),(0,a.kt)("p",null,"Within a project you will be able to:"),(0,a.kt)("ol",null,(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("strong",{parentName:"li"},(0,a.kt)("a",{parentName:"strong",href:"./Project/Curation"},"Curate"))," studies of interest and select the ones to be included in the meta-analysis"),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("strong",{parentName:"li"},(0,a.kt)("a",{parentName:"strong",href:"./Project/Extraction"},"Extract"))," the relevant data such as activation coordinates and other meta-data"),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("strong",{parentName:"li"},(0,a.kt)("a",{parentName:"strong",href:"./Project/Specification"},"Specify"))," the algorithm and corrector you would like to use")),(0,a.kt)("p",null,"In each project, you can define a single studyset (i.e. a collection of related studies defined and used in the extraction phase), and one or more meta-analysis specifications."),(0,a.kt)("h2",{id:"create-a-project"},"Create a project"),(0,a.kt)("p",null,"There are two ways to create a project and do your meta-analysis."),(0,a.kt)("h3",{id:"create-a-blank-project"},"Create a blank project"),(0,a.kt)("p",null,'The first method is to click on the "NEW PROJECT" button in the top navigation menu. This will create a new blank project. You will then be asked to get started on the ',(0,a.kt)("a",{parentName:"p",href:"/compose-docs/guide/Project/Curation"},"curation phase")," in order to progress."),(0,a.kt)("h3",{id:"create-a-project-from-a-sleuth-file"},"Create a project from a sleuth file"),(0,a.kt)("p",null,'The second method of creating a project is to click on the dropdown button on the right of "NEW PROJECT". This will show an option: "Create project from sleuth file". Click on that option and you will be brought to a new page to begin creating a new project from your sleuth file.'),(0,a.kt)("p",null,"Please note that neurosynth-compose requires a specific format in order to proceed with the import. We require that each experiment within the sleuth file ",(0,a.kt)("em",{parentName:"p"},"references either a PubMed ID or a DOI"),". The exact requirements are specified below:"),(0,a.kt)("h4",{id:"sleuth-file-format-requirements"},"Sleuth file format requirements"),(0,a.kt)("h5",{id:"1-file-reference"},"1. File Reference."),(0,a.kt)("p",null,"This reference specifies the coordinate space and must appear at the top of the file. Do not omit the first two forward slashes.",(0,a.kt)("br",null)),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre"},"// Reference=MNI\n")),(0,a.kt)("h5",{id:"2-identifier-doi-or-pubmed-id"},"2. Identifier (DOI or PubMed Id)"),(0,a.kt)("p",null,"The next lines of the file represents an experiment. We expect an identifier: ",(0,a.kt)("em",{parentName:"p"},"this can either be a DOI, a PubMedId, or both"),". Do not omit the first two forward slashes.",(0,a.kt)("br",null)),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre"},"// DOI=10.1038/nmeth.1635\nor\n// PubMedId=21706013\nor\n// DOI=10.1038/nmeth.1635\n// PubMedId=21706013\n")),(0,a.kt)("h5",{id:"3-author-year--experiment-name"},"3. Author, year & experiment name"),(0,a.kt)("p",null,"We expect a line containing the authors, year, and experiment name. The authors + year should be separated from the experiment name by a colon. There can be 1 or more lines representing multiple authors + year and experiment name. Do not omit the first two forward slashes."),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre"},"// Smith et al., 1996: 1 Back vs 0 Back\nor\n// Smith et al., 1996: 1 Back vs 0 Back\n// Graeff et al., 1995: 2 Back vs 1 Back\n// Edwards et al., 2017: 2 Back vs 0 Back\n")),(0,a.kt)("h5",{id:"4subjects"},"4.Subjects"),(0,a.kt)("p",null,"After the lines representing one or more authors + year and experiment name, add a line for the number of subjects in the experiment."),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre"},"// Subjects=23\n")),(0,a.kt)("h5",{id:"5-coordinates"},"5. Coordinates"),(0,a.kt)("p",null,"Add the X, Y, and Z coordinates. Do not add the two forward slashes. The coordinates should be ",(0,a.kt)("strong",{parentName:"p"},"delimited by tabs"),"."),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre"},"-27 34 72\n-7 -8 -9\n10 -12 -62\n")),(0,a.kt)("p",null,"Your sleuth file should look something like this:"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre"},"// Reference=MNI\n// DOI=10.1016/1234567\n// PubMedId=67123237\n// Smith et al., 2019: Working Memory vs Baseline\n// Subjects=23\n-2 8 9\n10 -12 -62\n21 -14 -2\n0 -9 16\n\n// DOI=10.217/1234568\n// PubMedId=23782389\n// Roberts et al., 1995: 2 Back vs 1 Back\n// Graeff et al., 2000: 1 Back vs 0 Back\n// Edwards et al., 2017: 2 Back vs 0 Back\n// Subjects=62\n82 12 0\n-27 34 72\n-7 -8 -9\n10 -12 -62\n")),(0,a.kt)("h4",{id:"common-import-errors"},"Common Import errors"),(0,a.kt)("p",null,(0,a.kt)("inlineCode",{parentName:"p"},"Either DOI or PMID is required. (Hint: is it in the right format?) Encountered error at <...>"),(0,a.kt)("br",null),"\nThis error indicates that neither a DOI nor PMID was found at the given line. Please check that the DOI or PubMedId given was correctly formulated."),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre"},"// DOI=10.1038/nmeth.1635\n// PubMedId=21706013\n")),(0,a.kt)("p",null,(0,a.kt)("inlineCode",{parentName:"p"},"Unexpected format. (Hint: Did you omit a colon or use a semi colon instead of a colon?) Encountered error at: <...>"),(0,a.kt)("br",null),"\nThis error indicates that neurosynth-compose expected to find a valid author + year and experiment name separated by a colon. Instead, it found a string that it did not recognize (or no experiment name was provided at all). Check that the line of the file indicated in the error message contains a correctly formulated author + year and experiment pairing like:"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre"},"// Roberts et al., 1995: 2 Back vs 1 Back\n")),(0,a.kt)("p",null,"or multiple"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre"},"// Roberts et al., 1995: 2 Back vs 1 Back\n// Graeff et al., 2000: 1 Back vs 0 Back\n// Edwards et al., 2017: 2 Back vs 0 Back\n")),(0,a.kt)("p",null,(0,a.kt)("inlineCode",{parentName:"p"},"Expected valid DOI but did not find one. Encountered error at: <...>")," ",(0,a.kt)("br",null),"\nThis error indicates that the format of the file did not adhere to the expected requirements due to an invalid DOI. Check that the line of the file indicated in the error message contains a correctly formulated DOI like: ",(0,a.kt)("inlineCode",{parentName:"p"},"// DOI=10.1038/nmeth.1635")),(0,a.kt)("p",null,(0,a.kt)("inlineCode",{parentName:"p"},"At least one experiment name is required. Encountered error at: <...>"),(0,a.kt)("br",null),"\nThis error indicates that no experiments were found at the line given by the error message. Please check that the sleuth file has at least one author + year and experiment name, or that the format is correctly formatted like: ",(0,a.kt)("inlineCode",{parentName:"p"},"// Smith et al., 2019: Working Memory vs Baseline")),(0,a.kt)("p",null,(0,a.kt)("inlineCode",{parentName:"p"},"Expected valid PMID but did not find one. Encountered error at: <...>"),(0,a.kt)("br",null),"\nThis error indicates that the format of the file did not adhere to the expected requirements due to an invalid PubMedId. Check that the line of the file indicated in the error message contains a correctly formulated PubMedId like: ",(0,a.kt)("inlineCode",{parentName:"p"},"// PubMedId=21706013")),(0,a.kt)("p",null,(0,a.kt)("inlineCode",{parentName:"p"},"Encountered multiple DOIs: <...>"),(0,a.kt)("br",null),"\nThis error indicates that multiple DOIs were discovered for the same experiment while parsing the file. Check that the line of the file indicated is part of an experiment that only has one DOI."),(0,a.kt)("p",null,(0,a.kt)("inlineCode",{parentName:"p"},"Encountered multiple PubMed IDs: <...>"),(0,a.kt)("br",null),"\nThis error indicates that multiple PubMedIds were discovered for the same experiment while parsing the file. Check that the line of the file indicated is part of an experiment that only has one PubMedId."),(0,a.kt)("p",null,(0,a.kt)("inlineCode",{parentName:"p"},"Expected number of subjects. Encountered error at: <...>"),(0,a.kt)("br",null),"\nThis error indicates that the format of the file did not adhere to the expected requirements due to an invalid Subjects field. Check that the line of the file indicated in the error message contains a correctly formulated Subjects field like: ",(0,a.kt)("inlineCode",{parentName:"p"},"// Subjects=23"),". Make sure that it is not separated by a new line."),(0,a.kt)("p",null,(0,a.kt)("inlineCode",{parentName:"p"},"Invalid coordinates: <...>"),(0,a.kt)("br",null),"\nThe coordinates given were not in a valid format. Check that the line of the file indicated in the error message contains correctly formulated, tab separated coordinates. They should look like:"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre"},"82 12 0\n-27 34 72\n-7 -8 -9\n10 -12 -62\n10 -12 -62\n21 -14 -2\n0 -9 16\n")),(0,a.kt)("p",null,(0,a.kt)("inlineCode",{parentName:"p"},"Unexpected format. Encountered error at: <...>"),(0,a.kt)("br",null),"\nThis error indicates that neurosynth-compose tried to extract the author data from the file but was unable to do so either because the author was not provided or the string was formed in such a way that was not recognized. Check that the line of the file indicated in the error message contains a correctly formulated string like: ",(0,a.kt)("inlineCode",{parentName:"p"},"// Roberts et al., 1995: 2 Back vs 1 Back")),(0,a.kt)("h2",{id:"opening-a-project"},"Opening a project"),(0,a.kt)("p",null,"You can open a specific project by logging in, navigating to the\n",(0,a.kt)("a",{parentName:"p",href:"https://compose.neurosynth.org/projects"},"My Projects")," page, and selecting a project you've created."),(0,a.kt)("p",null,'When you view a project for the first time, you\'ll notice that you\'ll default to the "Project" tab. Another tab, "Meta-Analyses", will become visible when you have completed both the curation and extraction phases.'))}u.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/runtime~main.7bc5701a.js b/assets/js/runtime~main.7bc5701a.js new file mode 100644 index 0000000..42dc457 --- /dev/null +++ b/assets/js/runtime~main.7bc5701a.js @@ -0,0 +1 @@ +(()=>{"use strict";var e,a,c,t,r,f={},o={};function b(e){var a=o[e];if(void 0!==a)return a.exports;var c=o[e]={id:e,loaded:!1,exports:{}};return f[e].call(c.exports,c,c.exports,b),c.loaded=!0,c.exports}b.m=f,b.c=o,e=[],b.O=(a,c,t,r)=>{if(!c){var f=1/0;for(i=0;i=r)&&Object.keys(b.O).every((e=>b.O[e](c[d])))?c.splice(d--,1):(o=!1,r0&&e[i-1][2]>r;i--)e[i]=e[i-1];e[i]=[c,t,r]},b.n=e=>{var a=e&&e.__esModule?()=>e.default:()=>e;return b.d(a,{a:a}),a},c=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,b.t=function(e,t){if(1&t&&(e=this(e)),8&t)return e;if("object"==typeof e&&e){if(4&t&&e.__esModule)return e;if(16&t&&"function"==typeof e.then)return e}var r=Object.create(null);b.r(r);var f={};a=a||[null,c({}),c([]),c(c)];for(var o=2&t&&e;"object"==typeof o&&!~a.indexOf(o);o=c(o))Object.getOwnPropertyNames(o).forEach((a=>f[a]=()=>e[a]));return f.default=()=>e,b.d(r,f),r},b.d=(e,a)=>{for(var c in a)b.o(a,c)&&!b.o(e,c)&&Object.defineProperty(e,c,{enumerable:!0,get:a[c]})},b.f={},b.e=e=>Promise.all(Object.keys(b.f).reduce(((a,c)=>(b.f[c](e,a),a)),[])),b.u=e=>"assets/js/"+({53:"935f2afb",519:"f8f8f85a",606:"8cd595a7",687:"07712b78",724:"545fdba5",1010:"c4a0799b",1397:"708a3a2f",1854:"b270851a",2309:"c2abd45e",2535:"814f3328",2544:"73114bfe",2550:"74a1c914",3078:"b0bf1abf",3085:"1f391b9e",3089:"a6aa9e1f",3544:"d4ab88d4",3555:"ffb62be8",3608:"9e4087bc",3730:"4c0219fe",3793:"b652e2a8",3840:"a58a4ef5",4013:"01a85c17",4330:"f08627b1",4530:"a1b719ab",4602:"bbe80a6e",4755:"0e33d78a",5326:"f72e48a3",5868:"2a3ffa35",6103:"ccc49370",6626:"c4e6ab22",6808:"5d9fd5dd",6965:"6f393b9a",7068:"2367c334",7081:"06e91050",7414:"393be207",7681:"181c334a",7918:"17896441",7929:"6b032824",7999:"4d19d8bc",8610:"6875c492",8755:"1f366607",8878:"0d692ce2",9514:"1be78505",9687:"fb8c922a",9735:"a3562974"}[e]||e)+"."+{53:"bbbf707d",114:"740d3fdc",210:"21bed4ea",519:"46bd4f0c",606:"b868e5b5",687:"9c3d9cde",724:"4c3b45ea",1010:"51083267",1397:"b9393d91",1854:"6ccdb5a8",2309:"ba71a24b",2529:"55a47439",2535:"81516515",2544:"062dc4ee",2550:"aed62cf2",3078:"912af714",3085:"b39c80e0",3089:"99b96258",3544:"571c950f",3555:"ed78e4c3",3608:"3ca3246f",3730:"0186eafc",3793:"10a2bcc1",3840:"f55b22c2",4013:"626b6758",4330:"50efd4f1",4530:"3cfefc71",4602:"47210a36",4755:"590735b7",4972:"a007b754",5326:"9c7c8817",5388:"3ec8351a",5868:"db45eff1",6103:"d5e9862c",6464:"01d52c80",6626:"d25c897e",6808:"469881d2",6965:"2ce685f8",7068:"cf6418de",7081:"8497bbdb",7414:"6feae840",7681:"4a7bb6b6",7918:"73b94cb8",7929:"de846d10",7999:"d631161d",8610:"de49da7a",8755:"ca48932c",8878:"67e319ff",9348:"d48f86f9",9514:"7f955038",9687:"4a7cb5fa",9735:"a83c1d42"}[e]+".js",b.miniCssF=e=>{},b.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),b.o=(e,a)=>Object.prototype.hasOwnProperty.call(e,a),t={},r="ns-compose-docs:",b.l=(e,a,c,f)=>{if(t[e])t[e].push(a);else{var o,d;if(void 0!==c)for(var n=document.getElementsByTagName("script"),i=0;i{o.onerror=o.onload=null,clearTimeout(l);var r=t[e];if(delete t[e],o.parentNode&&o.parentNode.removeChild(o),r&&r.forEach((e=>e(c))),a)return a(c)},l=setTimeout(u.bind(null,void 0,{type:"timeout",target:o}),12e4);o.onerror=u.bind(null,o.onerror),o.onload=u.bind(null,o.onload),d&&document.head.appendChild(o)}},b.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},b.p="/compose-docs/",b.gca=function(e){return e={17896441:"7918","935f2afb":"53",f8f8f85a:"519","8cd595a7":"606","07712b78":"687","545fdba5":"724",c4a0799b:"1010","708a3a2f":"1397",b270851a:"1854",c2abd45e:"2309","814f3328":"2535","73114bfe":"2544","74a1c914":"2550",b0bf1abf:"3078","1f391b9e":"3085",a6aa9e1f:"3089",d4ab88d4:"3544",ffb62be8:"3555","9e4087bc":"3608","4c0219fe":"3730",b652e2a8:"3793",a58a4ef5:"3840","01a85c17":"4013",f08627b1:"4330",a1b719ab:"4530",bbe80a6e:"4602","0e33d78a":"4755",f72e48a3:"5326","2a3ffa35":"5868",ccc49370:"6103",c4e6ab22:"6626","5d9fd5dd":"6808","6f393b9a":"6965","2367c334":"7068","06e91050":"7081","393be207":"7414","181c334a":"7681","6b032824":"7929","4d19d8bc":"7999","6875c492":"8610","1f366607":"8755","0d692ce2":"8878","1be78505":"9514",fb8c922a:"9687",a3562974:"9735"}[e]||e,b.p+b.u(e)},(()=>{var e={1303:0,532:0};b.f.j=(a,c)=>{var t=b.o(e,a)?e[a]:void 0;if(0!==t)if(t)c.push(t[2]);else if(/^(1303|532)$/.test(a))e[a]=0;else{var r=new Promise(((c,r)=>t=e[a]=[c,r]));c.push(t[2]=r);var f=b.p+b.u(a),o=new Error;b.l(f,(c=>{if(b.o(e,a)&&(0!==(t=e[a])&&(e[a]=void 0),t)){var r=c&&("load"===c.type?"missing":c.type),f=c&&c.target&&c.target.src;o.message="Loading chunk "+a+" failed.\n("+r+": "+f+")",o.name="ChunkLoadError",o.type=r,o.request=f,t[1](o)}}),"chunk-"+a,a)}},b.O.j=a=>0===e[a];var a=(a,c)=>{var t,r,f=c[0],o=c[1],d=c[2],n=0;if(f.some((a=>0!==e[a]))){for(t in o)b.o(o,t)&&(b.m[t]=o[t]);if(d)var i=d(b)}for(a&&a(c);n{"use strict";var e,a,t,r,c,f={},o={};function b(e){var a=o[e];if(void 0!==a)return a.exports;var t=o[e]={id:e,loaded:!1,exports:{}};return f[e].call(t.exports,t,t.exports,b),t.loaded=!0,t.exports}b.m=f,b.c=o,e=[],b.O=(a,t,r,c)=>{if(!t){var f=1/0;for(i=0;i=c)&&Object.keys(b.O).every((e=>b.O[e](t[d])))?t.splice(d--,1):(o=!1,c0&&e[i-1][2]>c;i--)e[i]=e[i-1];e[i]=[t,r,c]},b.n=e=>{var a=e&&e.__esModule?()=>e.default:()=>e;return b.d(a,{a:a}),a},t=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,b.t=function(e,r){if(1&r&&(e=this(e)),8&r)return e;if("object"==typeof e&&e){if(4&r&&e.__esModule)return e;if(16&r&&"function"==typeof e.then)return e}var c=Object.create(null);b.r(c);var f={};a=a||[null,t({}),t([]),t(t)];for(var o=2&r&&e;"object"==typeof o&&!~a.indexOf(o);o=t(o))Object.getOwnPropertyNames(o).forEach((a=>f[a]=()=>e[a]));return f.default=()=>e,b.d(c,f),c},b.d=(e,a)=>{for(var t in a)b.o(a,t)&&!b.o(e,t)&&Object.defineProperty(e,t,{enumerable:!0,get:a[t]})},b.f={},b.e=e=>Promise.all(Object.keys(b.f).reduce(((a,t)=>(b.f[t](e,a),a)),[])),b.u=e=>"assets/js/"+({53:"935f2afb",519:"f8f8f85a",606:"8cd595a7",687:"07712b78",724:"545fdba5",1010:"c4a0799b",1397:"708a3a2f",1854:"b270851a",2309:"c2abd45e",2535:"814f3328",2544:"73114bfe",2550:"74a1c914",3078:"b0bf1abf",3085:"1f391b9e",3089:"a6aa9e1f",3544:"d4ab88d4",3555:"ffb62be8",3608:"9e4087bc",3730:"4c0219fe",3793:"b652e2a8",3840:"a58a4ef5",4013:"01a85c17",4330:"f08627b1",4530:"a1b719ab",4602:"bbe80a6e",4755:"0e33d78a",5326:"f72e48a3",5868:"2a3ffa35",6103:"ccc49370",6626:"c4e6ab22",6808:"5d9fd5dd",6965:"6f393b9a",7068:"2367c334",7081:"06e91050",7414:"393be207",7681:"181c334a",7918:"17896441",7929:"6b032824",7999:"4d19d8bc",8610:"6875c492",8755:"1f366607",8878:"0d692ce2",9514:"1be78505",9687:"fb8c922a",9735:"a3562974"}[e]||e)+"."+{53:"4a27909c",114:"740d3fdc",210:"21bed4ea",519:"bb0ee6a6",606:"ab2ea4e7",687:"9c3d9cde",724:"4c3b45ea",1010:"5abcfa32",1397:"f677cb89",1854:"7f76da10",2309:"a756d662",2529:"55a47439",2535:"81516515",2544:"062dc4ee",2550:"aed62cf2",3078:"aa8f9ddc",3085:"b39c80e0",3089:"99b96258",3544:"571c950f",3555:"ed78e4c3",3608:"3ca3246f",3730:"6628a1fc",3793:"10a2bcc1",3840:"f55b22c2",4013:"626b6758",4330:"50efd4f1",4530:"3f1f88dd",4602:"47210a36",4755:"d8af7f03",4972:"a007b754",5326:"7f2b8760",5388:"3ec8351a",5868:"db45eff1",6103:"d5e9862c",6464:"01d52c80",6626:"2459ab27",6808:"3810dfdd",6965:"2ce685f8",7068:"9757426a",7081:"8497bbdb",7414:"6feae840",7681:"4a7bb6b6",7918:"73b94cb8",7929:"de846d10",7999:"7ba67632",8610:"de49da7a",8755:"e0018d80",8878:"67e319ff",9348:"d48f86f9",9514:"7f955038",9687:"ea7c56c6",9735:"4d0710a1"}[e]+".js",b.miniCssF=e=>{},b.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),b.o=(e,a)=>Object.prototype.hasOwnProperty.call(e,a),r={},c="ns-compose-docs:",b.l=(e,a,t,f)=>{if(r[e])r[e].push(a);else{var o,d;if(void 0!==t)for(var n=document.getElementsByTagName("script"),i=0;i{o.onerror=o.onload=null,clearTimeout(l);var c=r[e];if(delete r[e],o.parentNode&&o.parentNode.removeChild(o),c&&c.forEach((e=>e(t))),a)return a(t)},l=setTimeout(u.bind(null,void 0,{type:"timeout",target:o}),12e4);o.onerror=u.bind(null,o.onerror),o.onload=u.bind(null,o.onload),d&&document.head.appendChild(o)}},b.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},b.p="/compose-docs/",b.gca=function(e){return e={17896441:"7918","935f2afb":"53",f8f8f85a:"519","8cd595a7":"606","07712b78":"687","545fdba5":"724",c4a0799b:"1010","708a3a2f":"1397",b270851a:"1854",c2abd45e:"2309","814f3328":"2535","73114bfe":"2544","74a1c914":"2550",b0bf1abf:"3078","1f391b9e":"3085",a6aa9e1f:"3089",d4ab88d4:"3544",ffb62be8:"3555","9e4087bc":"3608","4c0219fe":"3730",b652e2a8:"3793",a58a4ef5:"3840","01a85c17":"4013",f08627b1:"4330",a1b719ab:"4530",bbe80a6e:"4602","0e33d78a":"4755",f72e48a3:"5326","2a3ffa35":"5868",ccc49370:"6103",c4e6ab22:"6626","5d9fd5dd":"6808","6f393b9a":"6965","2367c334":"7068","06e91050":"7081","393be207":"7414","181c334a":"7681","6b032824":"7929","4d19d8bc":"7999","6875c492":"8610","1f366607":"8755","0d692ce2":"8878","1be78505":"9514",fb8c922a:"9687",a3562974:"9735"}[e]||e,b.p+b.u(e)},(()=>{var e={1303:0,532:0};b.f.j=(a,t)=>{var r=b.o(e,a)?e[a]:void 0;if(0!==r)if(r)t.push(r[2]);else if(/^(1303|532)$/.test(a))e[a]=0;else{var c=new Promise(((t,c)=>r=e[a]=[t,c]));t.push(r[2]=c);var f=b.p+b.u(a),o=new Error;b.l(f,(t=>{if(b.o(e,a)&&(0!==(r=e[a])&&(e[a]=void 0),r)){var c=t&&("load"===t.type?"missing":t.type),f=t&&t.target&&t.target.src;o.message="Loading chunk "+a+" failed.\n("+c+": "+f+")",o.name="ChunkLoadError",o.type=c,o.request=f,r[1](o)}}),"chunk-"+a,a)}},b.O.j=a=>0===e[a];var a=(a,t)=>{var r,c,f=t[0],o=t[1],d=t[2],n=0;if(f.some((a=>0!==e[a]))){for(r in o)b.o(o,r)&&(b.m[r]=o[r]);if(d)var i=d(b)}for(a&&a(t);n Blog | Neurosynth Compose Docs - + @@ -14,7 +14,7 @@ and streamline user interfaces. Automated meta-analyses are ideal for generating exploratory results rapidly, enabling meta-analysis as part of routine scientific practice.

We've also made many small but important updates to our platform, including significant performance updates and improvements to the user interface. Neurosynth Compose is now more intuitive and easier to use. Give it a try by following our manual meta-analysis tutorial.

We also have some exciting new features in the pipeline that we'll release in early 2024 including:

  • Image-based Meta-Analysis (IBMA). Soon, you will be able to use NeuroVault data as inputs for IBMA-- a more powerful and sensitive alternative to Coordinate Based Meta-Analysis.
  • Advanced data extraction using Large Language Models (GPT). Early protypes to extract detailed information (such as participant demographics) from neuroimaging articles using LLMs have shown promise. We are working on incorporating these workflows into Neurosynth Compose, making it even easier to identify relevant studies for meta-analysis.

We look forward to your feedback!

-Alejandro

· 3 min read
Alejandro de la Vega

Dear Neurosynth Community,

My name is Alejandro, and I am the current project leader of the Neurosynth project.

I am very excited to announce to you that the Neurosynth project lives on, and we are officially announcing the (beta) release of the latest member of the ecosystem: Neurosynth Compose.

Neurosynth Compose enables users to easily perform custom neuroimaging meta-analyses using a web-based platform, with no programming experience required. This project addresses one of the most commonly request features, which is the ability to customize large-scale meta-analyses using you own expert knowledge.

Neurosynth Compose is free to use and helps users:

  • 🔎 Search across over 20,000 studies in the Neurosynth database, or import from external databses such as PubMed.
  • 🗃️ Curate your StudySet using systematic review tools conforming to the PRISMA guidelines.
  • 📝 Extract coordinates and metadata for each study, leveraging thousands of pre-extracted studies to minimize effort.
  • 📊 Analyze by specifying a reproducible NiMARE workflow, and execute it locally or in the cloud.
  • 🔗 Share with the community with complete provenance and reproducibility.

The goal of Neurosynth Compose is to enable researchers to go beyond the finite set of automatically generated meta-analyses from the original platform and overcome limitations from automated coordinate and semantic extraction. The end result is a gold standard meta-analysis, in much less time than a manual workflow, and with much greater reproducible.

Currently, Neurosynth Compose is in beta, and under active development. We welcome feedback to ensure our platform meets the needs of the community. Please leave us feedback using the button on the bottom right corner of the screen!

We are working on several upcoming features that will make the platform even better. Many of these features are already available in our Python meta-analysis library, NiMARE, and we are actively working on the user facing online interfaces.

  • Image-based Meta-Analysis (IBMA). We have developed algorithms in NiMARE for using whole-brain statistical maps as inputs to meta-analysis. This is more powerful and sensitive technique compared to Coordinate-base Meta-Analysis. Soon, you will be able to use NeuroVault data as inputs for your meta-analyses.
  • MKDA Chi-squared / Association test. A hallmark feature of Neurosynth is the ability to relate meta-analytic findings to the rest of the literature, to determine the strength and specificity of an association (this was previously called "reverse inference"). This will soon be possible on your custom meta-analyses.
  • A wide range of improvements to the user experience. We are in the process of re-working parts of the online interface to decrease friction when creating a StudySet, making study utilization, and editing more intuitive.

I would like to thank everyone involved in this highly-collaborative project, but especially James Kent, a postdoctoral fellow, and Nick Lee, a software engineer, who did the lion's share of the work.

We are excited for you to try it and let us know what you think.

-Alejandro

- + \ No newline at end of file diff --git a/blog/2024/1/31/new-year.html b/blog/2024/1/31/new-year.html index a22f0c2..1b2b5c6 100644 --- a/blog/2024/1/31/new-year.html +++ b/blog/2024/1/31/new-year.html @@ -5,13 +5,13 @@ New Year, New Features | Neurosynth Compose Docs - +

New Year, New Features

· 2 min read
Alejandro de la Vega

Hello Neurosynth Users,

2023 was a very exciting year for Neurosynth, having launched our Compose platform to the public and announced it on social media. In the December we’ve saw over 500 new user visits, with 200 users signing up for an account! 🚀

Help us keep this growth going by sharing our announcement with your colleagues. 🧑‍🔬

🌟 What’s New 🌟

We’ve also continued to introduce new features and improve the user experience. Here’s some highlights:

Large-scale association tests​

A key feature that set Neurosynth aside were large-scale association maps (previously known as “reverse inference”).

Whereas a typical meta-analysis tells you if activity is consistently reported in a target set of studies, an association test tells you if activation occurs more consistently in this set of studies versus a large and diverse reference sample.

That's important, because this allows you to control for base rate differences between regions. Certain regions, such as the insula or lateral PFC for instance, play a very broad role in cognition, and hence are consistently activated for many different tasks and cognitive states. Using MKDA Chi-Squared, you can test if brain activity in a region (such as the insula) is specifically associated with the studies in your meta-analysis.

Previously association tests were available for the automatically generated maps on neurosynth.org. Now you can perform large-scale association tests for your custom meta-analyses in Neurosynth Compose.

We have created a full primer and tutorial on MKDA Chi-Squared, including an example from a recent meta-analysis on social processing. Check it out!

MKDA Chi-Squared Tutorial 🧑‍🎓

UX Enhancements ✨​

Based on your valuable feedback, we've made numerous bug fixes and improvements:

  • Simplified Curation: The review import page has been removed, and summary information is now added directly to the tag step.

  • Searching UI: We've replaced the dropdown with a selection gallery, making it easier to choose your preferred search method, and we now auto-generate search import names. In addition, resolving duplicates is skipped if none are present.

  • Improved Editing Workflow: The editing interface has been improved, streamlining the extraction process.

  • Various UX Improvements and Fixes: We fixed many papercuts, especially in the Extraction phase.

We hope you enjoy these changes.

Email us any feedback, or ask a question on NeuroStars if you have issues.

Cheers,

The Neurosynth Team 🧠

- + \ No newline at end of file diff --git a/blog/announcing-ns-compose.html b/blog/announcing-ns-compose.html index f557752..11e60ff 100644 --- a/blog/announcing-ns-compose.html +++ b/blog/announcing-ns-compose.html @@ -5,13 +5,13 @@ Announcing Neurosynth Compose! | Neurosynth Compose Docs - +

Announcing Neurosynth Compose!

· 3 min read
Alejandro de la Vega

Dear Neurosynth Community,

My name is Alejandro, and I am the current project leader of the Neurosynth project.

I am very excited to announce to you that the Neurosynth project lives on, and we are officially announcing the (beta) release of the latest member of the ecosystem: Neurosynth Compose.

Neurosynth Compose enables users to easily perform custom neuroimaging meta-analyses using a web-based platform, with no programming experience required. This project addresses one of the most commonly request features, which is the ability to customize large-scale meta-analyses using you own expert knowledge.

Neurosynth Compose is free to use and helps users:

  • 🔎 Search across over 20,000 studies in the Neurosynth database, or import from external databses such as PubMed.
  • 🗃️ Curate your StudySet using systematic review tools conforming to the PRISMA guidelines.
  • 📝 Extract coordinates and metadata for each study, leveraging thousands of pre-extracted studies to minimize effort.
  • 📊 Analyze by specifying a reproducible NiMARE workflow, and execute it locally or in the cloud.
  • 🔗 Share with the community with complete provenance and reproducibility.

The goal of Neurosynth Compose is to enable researchers to go beyond the finite set of automatically generated meta-analyses from the original platform and overcome limitations from automated coordinate and semantic extraction. The end result is a gold standard meta-analysis, in much less time than a manual workflow, and with much greater reproducible.

Currently, Neurosynth Compose is in beta, and under active development. We welcome feedback to ensure our platform meets the needs of the community. Please leave us feedback using the button on the bottom right corner of the screen!

We are working on several upcoming features that will make the platform even better. Many of these features are already available in our Python meta-analysis library, NiMARE, and we are actively working on the user facing online interfaces.

  • Image-based Meta-Analysis (IBMA). We have developed algorithms in NiMARE for using whole-brain statistical maps as inputs to meta-analysis. This is more powerful and sensitive technique compared to Coordinate-base Meta-Analysis. Soon, you will be able to use NeuroVault data as inputs for your meta-analyses.
  • MKDA Chi-squared / Association test. A hallmark feature of Neurosynth is the ability to relate meta-analytic findings to the rest of the literature, to determine the strength and specificity of an association (this was previously called "reverse inference"). This will soon be possible on your custom meta-analyses.
  • A wide range of improvements to the user experience. We are in the process of re-working parts of the online interface to decrease friction when creating a StudySet, making study utilization, and editing more intuitive.

I would like to thank everyone involved in this highly-collaborative project, but especially James Kent, a postdoctoral fellow, and Nick Lee, a software engineer, who did the lion's share of the work.

We are excited for you to try it and let us know what you think.

-Alejandro

- + \ No newline at end of file diff --git a/blog/archive.html b/blog/archive.html index a072b79..a30c454 100644 --- a/blog/archive.html +++ b/blog/archive.html @@ -5,13 +5,13 @@ Archive | Neurosynth Compose Docs - +
- + \ No newline at end of file diff --git a/blog/tags.html b/blog/tags.html index a78f2b1..c41c1b5 100644 --- a/blog/tags.html +++ b/blog/tags.html @@ -5,13 +5,13 @@ Tags | Neurosynth Compose Docs - +
- + \ No newline at end of file diff --git a/blog/tags/hello.html b/blog/tags/hello.html index 1003cac..f8c0f8e 100644 --- a/blog/tags/hello.html +++ b/blog/tags/hello.html @@ -5,7 +5,7 @@ 2 posts tagged with "hello" | Neurosynth Compose Docs - + @@ -14,7 +14,7 @@ and streamline user interfaces. Automated meta-analyses are ideal for generating exploratory results rapidly, enabling meta-analysis as part of routine scientific practice.

We've also made many small but important updates to our platform, including significant performance updates and improvements to the user interface. Neurosynth Compose is now more intuitive and easier to use. Give it a try by following our manual meta-analysis tutorial.

We also have some exciting new features in the pipeline that we'll release in early 2024 including:

  • Image-based Meta-Analysis (IBMA). Soon, you will be able to use NeuroVault data as inputs for IBMA-- a more powerful and sensitive alternative to Coordinate Based Meta-Analysis.
  • Advanced data extraction using Large Language Models (GPT). Early protypes to extract detailed information (such as participant demographics) from neuroimaging articles using LLMs have shown promise. We are working on incorporating these workflows into Neurosynth Compose, making it even easier to identify relevant studies for meta-analysis.

We look forward to your feedback!

-Alejandro

· 3 min read
Alejandro de la Vega

Dear Neurosynth Community,

My name is Alejandro, and I am the current project leader of the Neurosynth project.

I am very excited to announce to you that the Neurosynth project lives on, and we are officially announcing the (beta) release of the latest member of the ecosystem: Neurosynth Compose.

Neurosynth Compose enables users to easily perform custom neuroimaging meta-analyses using a web-based platform, with no programming experience required. This project addresses one of the most commonly request features, which is the ability to customize large-scale meta-analyses using you own expert knowledge.

Neurosynth Compose is free to use and helps users:

  • 🔎 Search across over 20,000 studies in the Neurosynth database, or import from external databses such as PubMed.
  • 🗃️ Curate your StudySet using systematic review tools conforming to the PRISMA guidelines.
  • 📝 Extract coordinates and metadata for each study, leveraging thousands of pre-extracted studies to minimize effort.
  • 📊 Analyze by specifying a reproducible NiMARE workflow, and execute it locally or in the cloud.
  • 🔗 Share with the community with complete provenance and reproducibility.

The goal of Neurosynth Compose is to enable researchers to go beyond the finite set of automatically generated meta-analyses from the original platform and overcome limitations from automated coordinate and semantic extraction. The end result is a gold standard meta-analysis, in much less time than a manual workflow, and with much greater reproducible.

Currently, Neurosynth Compose is in beta, and under active development. We welcome feedback to ensure our platform meets the needs of the community. Please leave us feedback using the button on the bottom right corner of the screen!

We are working on several upcoming features that will make the platform even better. Many of these features are already available in our Python meta-analysis library, NiMARE, and we are actively working on the user facing online interfaces.

  • Image-based Meta-Analysis (IBMA). We have developed algorithms in NiMARE for using whole-brain statistical maps as inputs to meta-analysis. This is more powerful and sensitive technique compared to Coordinate-base Meta-Analysis. Soon, you will be able to use NeuroVault data as inputs for your meta-analyses.
  • MKDA Chi-squared / Association test. A hallmark feature of Neurosynth is the ability to relate meta-analytic findings to the rest of the literature, to determine the strength and specificity of an association (this was previously called "reverse inference"). This will soon be possible on your custom meta-analyses.
  • A wide range of improvements to the user experience. We are in the process of re-working parts of the online interface to decrease friction when creating a StudySet, making study utilization, and editing more intuitive.

I would like to thank everyone involved in this highly-collaborative project, but especially James Kent, a postdoctoral fellow, and Nick Lee, a software engineer, who did the lion's share of the work.

We are excited for you to try it and let us know what you think.

-Alejandro

- + \ No newline at end of file diff --git a/blog/tags/neurosynth.html b/blog/tags/neurosynth.html index 281c322..311cfb8 100644 --- a/blog/tags/neurosynth.html +++ b/blog/tags/neurosynth.html @@ -5,7 +5,7 @@ 3 posts tagged with "neurosynth" | Neurosynth Compose Docs - + @@ -14,7 +14,7 @@ and streamline user interfaces. Automated meta-analyses are ideal for generating exploratory results rapidly, enabling meta-analysis as part of routine scientific practice.

We've also made many small but important updates to our platform, including significant performance updates and improvements to the user interface. Neurosynth Compose is now more intuitive and easier to use. Give it a try by following our manual meta-analysis tutorial.

We also have some exciting new features in the pipeline that we'll release in early 2024 including:

  • Image-based Meta-Analysis (IBMA). Soon, you will be able to use NeuroVault data as inputs for IBMA-- a more powerful and sensitive alternative to Coordinate Based Meta-Analysis.
  • Advanced data extraction using Large Language Models (GPT). Early protypes to extract detailed information (such as participant demographics) from neuroimaging articles using LLMs have shown promise. We are working on incorporating these workflows into Neurosynth Compose, making it even easier to identify relevant studies for meta-analysis.

We look forward to your feedback!

-Alejandro

· 3 min read
Alejandro de la Vega

Dear Neurosynth Community,

My name is Alejandro, and I am the current project leader of the Neurosynth project.

I am very excited to announce to you that the Neurosynth project lives on, and we are officially announcing the (beta) release of the latest member of the ecosystem: Neurosynth Compose.

Neurosynth Compose enables users to easily perform custom neuroimaging meta-analyses using a web-based platform, with no programming experience required. This project addresses one of the most commonly request features, which is the ability to customize large-scale meta-analyses using you own expert knowledge.

Neurosynth Compose is free to use and helps users:

  • 🔎 Search across over 20,000 studies in the Neurosynth database, or import from external databses such as PubMed.
  • 🗃️ Curate your StudySet using systematic review tools conforming to the PRISMA guidelines.
  • 📝 Extract coordinates and metadata for each study, leveraging thousands of pre-extracted studies to minimize effort.
  • 📊 Analyze by specifying a reproducible NiMARE workflow, and execute it locally or in the cloud.
  • 🔗 Share with the community with complete provenance and reproducibility.

The goal of Neurosynth Compose is to enable researchers to go beyond the finite set of automatically generated meta-analyses from the original platform and overcome limitations from automated coordinate and semantic extraction. The end result is a gold standard meta-analysis, in much less time than a manual workflow, and with much greater reproducible.

Currently, Neurosynth Compose is in beta, and under active development. We welcome feedback to ensure our platform meets the needs of the community. Please leave us feedback using the button on the bottom right corner of the screen!

We are working on several upcoming features that will make the platform even better. Many of these features are already available in our Python meta-analysis library, NiMARE, and we are actively working on the user facing online interfaces.

  • Image-based Meta-Analysis (IBMA). We have developed algorithms in NiMARE for using whole-brain statistical maps as inputs to meta-analysis. This is more powerful and sensitive technique compared to Coordinate-base Meta-Analysis. Soon, you will be able to use NeuroVault data as inputs for your meta-analyses.
  • MKDA Chi-squared / Association test. A hallmark feature of Neurosynth is the ability to relate meta-analytic findings to the rest of the literature, to determine the strength and specificity of an association (this was previously called "reverse inference"). This will soon be possible on your custom meta-analyses.
  • A wide range of improvements to the user experience. We are in the process of re-working parts of the online interface to decrease friction when creating a StudySet, making study utilization, and editing more intuitive.

I would like to thank everyone involved in this highly-collaborative project, but especially James Kent, a postdoctoral fellow, and Nick Lee, a software engineer, who did the lion's share of the work.

We are excited for you to try it and let us know what you think.

-Alejandro

- + \ No newline at end of file diff --git a/blog/tutorials-updates.html b/blog/tutorials-updates.html index bd19a71..c8e20ef 100644 --- a/blog/tutorials-updates.html +++ b/blog/tutorials-updates.html @@ -5,7 +5,7 @@ New tutorials and updates | Neurosynth Compose Docs - + @@ -14,7 +14,7 @@ and streamline user interfaces. Automated meta-analyses are ideal for generating exploratory results rapidly, enabling meta-analysis as part of routine scientific practice.

We've also made many small but important updates to our platform, including significant performance updates and improvements to the user interface. Neurosynth Compose is now more intuitive and easier to use. Give it a try by following our manual meta-analysis tutorial.

We also have some exciting new features in the pipeline that we'll release in early 2024 including:

  • Image-based Meta-Analysis (IBMA). Soon, you will be able to use NeuroVault data as inputs for IBMA-- a more powerful and sensitive alternative to Coordinate Based Meta-Analysis.
  • Advanced data extraction using Large Language Models (GPT). Early protypes to extract detailed information (such as participant demographics) from neuroimaging articles using LLMs have shown promise. We are working on incorporating these workflows into Neurosynth Compose, making it even easier to identify relevant studies for meta-analysis.

We look forward to your feedback!

-Alejandro

- + \ No newline at end of file diff --git a/guide.html b/guide.html index 33302a9..36b2730 100644 --- a/guide.html +++ b/guide.html @@ -5,13 +5,13 @@ User Guide | Neurosynth Compose Docs - +
-
- +
+ \ No newline at end of file diff --git a/guide/Explore.html b/guide/Explore.html index e39aa8b..3b80de5 100644 --- a/guide/Explore.html +++ b/guide/Explore.html @@ -5,15 +5,15 @@ Explore | Neurosynth Compose Docs - +

Explore

Here, you can browse and search existing public Studies, StudySets and Meta-Analyses created on the platform.

Studies​

The Studies page lets you browse and search all studies that exist on the NeuroStore server. This interface is similar to what you'll see when importing studies into your Project. However, here it's simply provided for your browsing pleasure.

For more information on how advanced search functionally, see Searching Studies

StudySets and Meta-Analyses​

For StudySets and Meta-Analyses, you can browse and search any user-contributed items, including those from other users.

Note that although you see all publically available items, you cannot edit somebody else's content.

note

We are currently working on a way to allow users to fork other users' StudySets and Meta-Analyses to create their own versions. Stay tuned! -::::

- +::::

+ \ No newline at end of file diff --git a/guide/Explore/Searching.html b/guide/Explore/Searching.html index 5a1761f..544bd89 100644 --- a/guide/Explore/Searching.html +++ b/guide/Explore/Searching.html @@ -5,7 +5,7 @@ Searching | Neurosynth Compose Docs - + @@ -15,8 +15,8 @@ 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​

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.

- +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/guide/Project.html b/guide/Project.html index 7448870..ae55f83 100644 --- a/guide/Project.html +++ b/guide/Project.html @@ -5,7 +5,7 @@ Project | Neurosynth Compose Docs - + @@ -21,8 +21,8 @@ This error indicates that the format of the file did not adhere to the expected requirements due to an invalid Subjects field. Check that the line of the file indicated in the error message contains a correctly formulated Subjects field like: // Subjects=23. Make sure that it is not separated by a new line.

Invalid coordinates: <...>
The coordinates given were not in a valid format. Check that the line of the file indicated in the error message contains correctly formulated, tab separated coordinates. They should look like:

82  12  0
-27 34  72
-7  -8  -9
10  -12 -62
10  -12 -62
21  -14 -2
0   -9  16

Unexpected format. Encountered error at: <...>
This error indicates that neurosynth-compose tried to extract the author data from the file but was unable to do so either because the author was not provided or the string was formed in such a way that was not recognized. Check that the line of the file indicated in the error message contains a correctly formulated string like: // Roberts et al., 1995: 2 Back vs 1 Back

Opening a project​

You can open a specific project by logging in, navigating to the -My Projects page, and selecting a project you've created.

When you view a project for the first time, you'll notice that you'll default to the "Project" tab. Another tab, "Meta-Analyses", will become visible when you have completed both the curation and extraction phases.

- +My Projects page, and selecting a project you've created.

When you view a project for the first time, you'll notice that you'll default to the "Project" tab. Another tab, "Meta-Analyses", will become visible when you have completed both the curation and extraction phases.

+ \ No newline at end of file diff --git a/guide/Project/Curation.html b/guide/Project/Curation.html index b9f7a7d..04a1625 100644 --- a/guide/Project/Curation.html +++ b/guide/Project/Curation.html @@ -5,7 +5,7 @@ Curation | Neurosynth Compose Docs - + @@ -35,8 +35,8 @@ along with the following options: PROMOTE, NEEDS REVIEW, and EXCLUDE. There is also a button to ADD TAGS which will assign an informational tag to the study. This informational tag is a tool that allows you to mark studies with certain information - once an informational tag is created, you can filter by those tags.

Exclude​

To exclude a study, click the EXCLUDE button and select the exclusion reason. You can either choose from the preset exclusion reasons or you can begin typing to create a new one.

tip

For the PRISMA workflow, the default exclusion reason wil depend on the phase you are in (identification vs screening vs eligibility), to match the PRISMA guidelines. While we do not recommend it, you can click the arrow button and start typing in the input to create a new exclusion reason. Revisit the PRISMA workflow to review reccomended exclusion criteria.

Promote​

If a study meets inclusion critera (for the current phase), click PROMOTE to move the study forward to the next curation column. If it is moved into the right most inclusion column, then it will be included in the meta-analysis.

tip

For the first column (especially in a PRISMA workflow) it can be tedious to promote non-duplicates to the next column. If all duplicates have been resolved, you can exit the dialog and click PROMOTE ALL UNCATEGORIZED STUDIES to advance all non-duplicate studies to the next column.

Downloading included studies​

In order to download the studies that you have included in Curation, you can utilize our download feature. Go to curation and click "Download Included as CSV". Alternatively, you can click the dropdown and download the included studies in BibTeX format instead.

On to Extraction​

When you have categorized all imported studies by either excluding them or moving them to the inclusion column, then you have -successfully completed the curation portion of the meta-analysis.

Neurosynth Compose will detect this and reveal a new button: MOVE TO EXTRACTION PHASE. This will move you back to the project page and get you started on the next major component to building your meta-analysis: extraction.

- +successfully completed the curation portion of the meta-analysis.

Neurosynth Compose will detect this and reveal a new button: MOVE TO EXTRACTION PHASE. This will move you back to the project page and get you started on the next major component to building your meta-analysis: extraction.

+ \ No newline at end of file diff --git a/guide/Project/Extraction.html b/guide/Project/Extraction.html index d138710..2da51e7 100644 --- a/guide/Project/Extraction.html +++ b/guide/Project/Extraction.html @@ -3,32 +3,19 @@ -Extraction | Neurosynth Compose Docs +Extraction | Neurosynth Compose Docs - +
-

Extraction

Extraction is the second step in creating a meta-analysis. It involves taking the -new Studyset creates in the curation step and extracting relevant information from studies, such as annotations, -and peak activation coordinates, or points.

Getting Started​

After the curation phase is complete, the user is redirected to the extraction phase. You can also access the Extraction phase through the main project page.

Here, the extraction phase starts when -a wizard that pops up and guides the user through the process of initializing the extraction phase. On top of creating the -initial annotation columns, this wizard also guides the user through the -process of ingestion of the curated studies to create a new studyset.

Ingestion​

Ingestion describes the process of taking the studies from the curation phase and inserting them into the database one by one.

For each study, neurosynth-compose searches the neurostore database and checks to see if a matching study exists. If a match -does not exist, then a new study is created and the user must go to the paper to fill out the relevant details. -If one or more matches are found, neurosynth-compose will choose the most recently updated one by default. The user can later go in and switch to a different version if the one selected is not the ony they wanted.

Why ingestion?

During the curation phase, studies are actually not inserted into the database. A vast majority of the studies that -are imported into the curation phase are excluded during the curation process. Inserting these studies into the database would clutter -it and create a lot of empty entries which don't have coordinates and might not even be used. By waiting until we have our finalized -included subset of studies, we reduce the number of empty, useless studies in the database.

Extraction Table​

Extraction Table

Once ingestion is complete, the user is shown a table listing the studies within the studyset. The extraction step involves iteratively reviewing each study to make sure they contain information amenable to a meta-analysis. -Studies in the extraction phase are filtered and categorized to help better organize and facilitate the process. Initially, all studies -start as Unreviewed. The user can then decide to mark them as Save For Later if they want to revisit the study, or Completed.

If the study does not have any already extracted coordinates, then the user should go and find the original paper and manually search for the coordinates to add to the study.

If the study has automatically extracted coordinates, then the user only has to validate that these coordinates are satisfactory.

The table provides functionality for filtering amongst various columns as well as sorting. To start editing a study, click on one of the table rows.

Annotations​

Annotations Table

Annotations are a way to assign data to each analysis within the studyset. Annotation values can be later used to filter out analyses to include within a meta-analysis.

In the extraction page, click the "Annotations" button on the top right. Annotations are represented with a spreadsheet like interface, where the row headers are the respective studies and their analyses, and the column headers are the properties for -each of those study analyses. Each cell in the spreadsheet repreesnts the value for a given property of a study's analysis.

By default, all annotations will start with a column included which will be set to true. This column can be modified if needed.

Study Editing​

Study Editing

Clicking on a study in the extraction table will lead you to the study editing page. This page allows you to edit study coordinates, add new analyses to the study, as well as modify the study name, authors, PMID, DOI, etc. -If you would like to update the annotation values just for the given study, you can do so utilizing the study annotations table.

Syncing Between Curation and Extraction​

Out of Sync

In an ideal meta-analysis process, once the curation phase is completed then it is not touched again. However, this is not always possible in the real world.

If the curation phase is modified (for example if a study previously marked as "included" was excluded, or an additional study that was previously excluded was changed to "included") then the extraction phase -no longer represents the output of the curation phase. In a situation like this, we need to resynchronize these two so that the extraction phase is aligned again. When neurosynth-compose encounters a mismatch -between the two phases, a banner will pop up prompting the user to synchronize the extraction phase with the new curation phase updates.

Successfully resynchronizing the two phases will cause the banner to go away.

Completion​

The extraction phase is considered complete and the user is prompted to move on when all studies have been marked as complete. Once this step is complete, it is then time to specify the configurations for your meta-analysis. -When all studies are marked as completed, a button should appear prompting the user to continue the meta-analysis process.

info

If you would like to skip the extraction step, then you can go back to the project page and click the button: "Mark all as complete" underneath the extraction section.

Mark all as complete

- +

Extraction

Extraction is the second step in creating a meta-analysis. It involves using the +Studyset created during the curation step to extract relevant information from studies, such as annotations, and peak activation coordinates, or points.

Getting Started​

Once curation is complete, the user is redirected to the extraction phase.

This phase begins with a wizard that guides the user through initializing the extraction process. In addition to creating initial annotation columns, the wizard assists the user with the ingestion of curated studies to generate a new studyset.

Ingestion​

Ingestion is the process of importing studies from the curation phase into the database.

For each study, Neurosynth-Compose searches the Neurostore database for matches. If a study is not already in the database, a new entry is created, requiring the user to extract relevant information from the corresponding paper (e.g., activation coordinates).

If multiple matches are found, the most recently updated one is selected, though the user can switch to a different version if desired. Existing versions may have been automatically extracted by the database or contributed by other users.

Why Ingestion?

During curation, studies are not yet inserted into the database. Many studies imported during curation are excluded from the final set. Inserting all studies at this stage would clutter the database with entries that lack coordinates or may never be used. By waiting until the final subset is selected, we reduce the number of empty or irrelevant entries in the database.

Extraction Table​

Extraction Table

Once ingestion is complete, the user is shown a table listing the studies within the studyset. The extraction step involves iteratively reviewing each study to make sure they contain information suitable for meta-analysis. +Studies in the extraction phase are filtered and categorized to better organize and streamine the process. Initially, all studies +are marked as Unreviewed, and the user can decide to mark them as Save For Later if they want to revisit the study, or Completed when they are finished.

If a study does not have any extracted coordinates, the user must manually locate the original paper and find the coordinates to add to the study.

If the study has automatically extracted coordinates, the user needs only to verify that these coordinates are satisfactory.

The table provides functionality for filtering amongst various columns as well as sorting. To start editing a study, click on one of the table rows.

Annotations​

Annotations Table

Annotations are a way to assign data to each analysis within the studyset. Annotation values can be later used to filter out analyses to include within a meta-analysis.

In the extraction page, click the "Annotations" button on the top right. Annotations are represented with a spreadsheet like interface, where the row headers are the respective studies and their analyses, and the column headers are the properties for +each of those study analyses. Each cell in the spreadsheet repreesnts the value for a given property of a study's analysis.

By default, all annotations will include a column labeled included, which is initially set to true. This column can be modified if needed.

Study Editing​

Study Editing

Clicking on a study in the extraction table leads to the study editing page. Here, users can edit study coordinates, add new analyses to the study, and modify details such as the study's name, authors, PMID, DOI, etc. If you wish to update annotation values for a specific study, you can do so using the study's annotations table.

Syncing Between Curation and Extraction​

Out of Sync

Ideally, once the curation phase is complete, no further changes are made. However, in practice, this is not always possible.

If changes are made during the curation phase (for example, if a previously included study is excluded or an excluded study is included), the extraction phase will no longer align with the output of the curation phase. In such cases, the extraction phase needs to be resynchronized with the updates from the curation phase. When Neurosynth-Compose detects a mismatch between the two phases, a banner will appear prompting the user to resynchronize the extraction phase with the updated curation phase.

Completion​

The extraction phase is considered complete once all studies have been marked as Completed. At this point, the user is prompted to proceed to the meta-analysis configuration step. Once all studies are marked as complete, a button will appear, allowing the user to continue with the meta-analysis process.

info

If you would like to skip the extraction step, you can return to the project page and click the "Mark all as complete" button under the extraction section.

Mark all as complete

+ \ No newline at end of file diff --git a/guide/Project/Running.html b/guide/Project/Running.html index 374a0d7..4e0ebf9 100644 --- a/guide/Project/Running.html +++ b/guide/Project/Running.html @@ -5,7 +5,7 @@ Running Analyses | Neurosynth Compose Docs - + @@ -17,8 +17,8 @@ of the results, or browse the results in the Neurosynth Compose web interface, in the Meta-Analysis section of your Project.

tip

The Colab notebook has limited and varying freely available resources, and may not be able to run large analyses. If your analysis fails, try running it again, or using one of the other methods below.

Docker​

The easiest way to run analyses locally is to use the nsc-runner Docker image provided by Neurosynth Compose.

Docker is a containerization technology that allows you to run software in a consistent environment, regardless of the underlying operating system.

To run the Docker image, you will need to install Docker on your local machine. Instructions for installing Docker can be found here.

Once Docker is installed, you can run your analysis using the using the following command:

docker run -it -v -v /local/dir:/results ghcr.io/neurostuff/nsc-runner:latest <meta-analysis-id>

where /local/dir is the path to a local directory where you would like to save the results of your analysis, and <meta-analysis-id> is the ID of the meta-analysis you would like to run.

If you are trying to run the analysis from a mac with an ARM chip (eg an M1 Macbook air) use this command instead:

docker run -it --platform=linux/amd64 -v  /local/dir:/results ghcr.io/neurostuff/nsc-runner:latest <meta-analysis-id>

The Docker image will download all required software, run the analysis, and upload the results to Neurovault & Neurosynth Compose. -An HTML report will be saved in the results directory, and the results will be available in the Meta-Analysis section of your Project on Neurosynth Compose.

Updating the Docker image​

For every release of nsc-runner, we publish a corresponding Docker image.

You can manually download a specific neuroscout-cli release as follows:

docker pull ghcr.io/neurostuff/nsc-runner:<version>

where <version> is the version of nsc-runner that you want to download. If you omit version, the latest stable version will be downloaded.

You can see the tags available for download on GitHub

Manually prepared environment using pip​

danger

Manually installing nsc-runner may be difficult due to complex dependencies in the SciPy stack, or fMRI-specific tooling. Proceed only if you know what you’re doing.

Use pip to install nsc-runner from PyPI:

pip install nsc-runner

and then run the analysis using the following command:

nsc-runner <meta-analysis-id>
- +An HTML report will be saved in the results directory, and the results will be available in the Meta-Analysis section of your Project on Neurosynth Compose.

Updating the Docker image​

For every release of nsc-runner, we publish a corresponding Docker image.

You can manually download a specific neuroscout-cli release as follows:

docker pull ghcr.io/neurostuff/nsc-runner:<version>

where <version> is the version of nsc-runner that you want to download. If you omit version, the latest stable version will be downloaded.

You can see the tags available for download on GitHub

Manually prepared environment using pip​

danger

Manually installing nsc-runner may be difficult due to complex dependencies in the SciPy stack, or fMRI-specific tooling. Proceed only if you know what you’re doing.

Use pip to install nsc-runner from PyPI:

pip install nsc-runner

and then run the analysis using the following command:

nsc-runner <meta-analysis-id>
+ \ No newline at end of file diff --git a/guide/Project/Specification.html b/guide/Project/Specification.html index 1c0f9ed..b8ca983 100644 --- a/guide/Project/Specification.html +++ b/guide/Project/Specification.html @@ -5,13 +5,13 @@ Specification | Neurosynth Compose Docs - +
-

Specification

Work in progress!​

We're still working on completing the documentation for this. Please check back later.

- +

Specification

Work in progress!​

We're still working on completing the documentation for this. Please check back later.

+ \ No newline at end of file diff --git a/guide/glossary.html b/guide/glossary.html index cf51788..867c85f 100644 --- a/guide/glossary.html +++ b/guide/glossary.html @@ -5,7 +5,7 @@ Glossary | Neurosynth Compose Docs - + @@ -28,8 +28,8 @@ The contents of an analysis include the terms applied to the groups/conditions and their respective weights in the contrast. An analysis also contains the results of the statistical contrast either with an image and/or a table -indicating significant results

Condition​

Overview​

A condition is term/word that represents a psychological (e.g., 2-back), physical (e.g., biking)

Weights​

Point​

Overview​

Image​

- +indicating significant results

Condition​

Overview​

A condition is term/word that represents a psychological (e.g., 2-back), physical (e.g., biking)

Weights​

Point​

Overview​

Image​

+ \ No newline at end of file diff --git a/index.html b/index.html index 1636d25..7ff546d 100644 --- a/index.html +++ b/index.html @@ -5,13 +5,13 @@ What is Neurosynth Compose? | Neurosynth Compose Docs - +
-

What is Neurosynth Compose?

Neurosynth Compose is the next-generation of Neurosynth, enabling users to easily perform custom neuroimaging meta-analyses using a fully web-based platform, with no programming experience required.

Neurosynth Compose is free to use and helps users:

  • 🔎 Search across over 20,000 studies in the Neurosynth database, or import from external databases such as PubMed.
  • 🗃️ Curate your StudySet using systematic review tools conforming to the PRISMA guidelines.
  • 📝 Extract coordinates and metadata for each study, leveraging thousands of pre-extracted studies to minimize effort.
  • 📊 Analyze by specifying a reproducible NiMARE workflow, and execute it locally or in the cloud.
  • 🔗 Share with the community with complete provenance and reproducibility.

Get started! 🚀​

Tutorials

Tutorials show you how to use Neurosynth Compose with complete end-to-end examples.

Go to Tutorials

User Guide

The User Guide provides a detailed overview of the platform, and explains key concepts and features.

Go to User Guide

Getting Help​

  • Ask a question on Neurostars using the neurosynth-compose tag.
  • Report a bug or request a feature on GitHub
  • Help us improve the platform by using the feedback button in the bottom right corner of the page.
- +

What is Neurosynth Compose?

Neurosynth Compose is the next-generation of Neurosynth, enabling users to easily perform custom neuroimaging meta-analyses using a fully web-based platform, with no programming experience required.

Neurosynth Compose is free to use and helps users:

  • 🔎 Search across over 20,000 studies in the Neurosynth database, or import from external databases such as PubMed.
  • 🗃️ Curate your StudySet using systematic review tools conforming to the PRISMA guidelines.
  • 📝 Extract coordinates and metadata for each study, leveraging thousands of pre-extracted studies to minimize effort.
  • 📊 Analyze by specifying a reproducible NiMARE workflow, and execute it locally or in the cloud.
  • 🔗 Share with the community with complete provenance and reproducibility.

Get started! 🚀​

Tutorials

Tutorials show you how to use Neurosynth Compose with complete end-to-end examples.

Go to Tutorials

User Guide

The User Guide provides a detailed overview of the platform, and explains key concepts and features.

Go to User Guide

Getting Help​

  • Ask a question on Neurostars using the neurosynth-compose tag.
  • Report a bug or request a feature on GitHub
  • Help us improve the platform by using the feedback button in the bottom right corner of the page.
+ \ No newline at end of file diff --git a/introduction/ecosystem.html b/introduction/ecosystem.html index d284237..53a4685 100644 --- a/introduction/ecosystem.html +++ b/introduction/ecosystem.html @@ -5,7 +5,7 @@ Ecosystem for fMRI Meta-Analysis | Neurosynth Compose Docs - + @@ -28,8 +28,8 @@ Additionally, the NeuroQuery database will feed directly into NeuroStore as a source of coordinates.

NeuroVault​

NeuroVault is a repository for unthresholded statistical maps from neuroimaging studies.

As of early 2023, NeuroVault contains over 8,000 collections of statistical images, with over 100,000 images in total. It is the largest repository of unthresholded statistical maps in the world, and is the primary source of data for image-based meta-analyses using Neurosynth Compose.

Currently, NeuroVault supports some basic meta-analytic functionality. However, as other tools in this ecosystem are developed, -it is planned that NeuroVault will focus exclusively on image storage and sharing, and will rely on other tools for meta-analysis.

- +it is planned that NeuroVault will focus exclusively on image storage and sharing, and will rely on other tools for meta-analysis.

+ \ No newline at end of file diff --git a/introduction/faq.html b/introduction/faq.html index 4363f59..adb5fe0 100644 --- a/introduction/faq.html +++ b/introduction/faq.html @@ -5,13 +5,13 @@ Frequently Asked Questions | Neurosynth Compose Docs - +
-

Frequently Asked Questions

Is this service free to use?
Yes! Note, however, that NS-Compose is a web-based engine for neuroimaging meta-analysis specification; at the moment, we don’t (yet?) provide free computing resources for the execution of the resulting meta-analysis specifications. However, you can easily run your meta-analysis in the cloud using Google Colab, or locally using Python. Instructions are provided after you complete a meta-analysis.
Are there any restrictions on meta-analyses created?
Yes. Once a meta-analysis specification is executed and results are uploaded to our platform, you will no longer be able to delete or edit the analysis specification. A complete copy of the StudySet and Analysis is kept on our system to ensure complete provenance. You can, however, keep the analysis as private to ensure it is unlisted in the public search.
If you wish to make any edits, you can edit the StudySet and create a new Analysis specification, which will receive a new unique ID.

In the event that you publish any results generated using the Neurosynth Compose, you MUST provide a link to the corresponding meta-analysis specification ID on the platform.
I've noticed that a study on your platform contains errors or is incomplete, can I fix them?
Yes! We welcome user contributions. You can correct or add details on a study, including meta-data and peak activation coordinates. A key piece of information that you may want to correct is how Activation coordinates are grouped into distinct Analyses (i.e., Contrasts). Please ensure that any edits you make are as objective as possible and reflect what is represented in the original Study, and *not* the goals of your meta-analysis.

To avoid debates about the ground truth of a Study, when you make edits a new Version of the study is created, which is associated with your User.
If I contribute new studies to the platform, or edit existing studies, will other users be able to see them?
Yes! Although a new Version of the study is created when you make any edits, we default to displaying user edited Versions over the automatically extracted versions. This is because we assume that any edits made by users will be improvements on the extraction algorithm. Please ensure any changes you make reflect this. You may also make a Version private if you don't want to share your edits with others.
How does this project relate to the original Neurosynth?
Neurosynth 1.0 was an online platform for browsing automatically generated large-scale neuroimaging meta-analyses. However, because all analyses were pre-generated, users were unable to define custom meta-analyses using the Neurosynth database. Instead, Neurosynth 1.0 used text mining techniques to automatically group studies based on the frequency of the terms mentioned in the text. Neurosynth Compose is focused on allowing users to overcome the limitations of automated large-scale meta-analysis, by enabling users to annotate studies, and curate sets of studies amenable for meta-analysis. This way, users can systematically define meta-analyses using their own expertise, while still leveraging the Neurosynth database, and an easy-to-use web-based analysis builder to accelerate the meta-analysis process.
- +

Frequently Asked Questions

Is this service free to use?
Yes! Note, however, that NS-Compose is a web-based engine for neuroimaging meta-analysis specification; at the moment, we don’t (yet?) provide free computing resources for the execution of the resulting meta-analysis specifications. However, you can easily run your meta-analysis in the cloud using Google Colab, or locally using Python. Instructions are provided after you complete a meta-analysis.
Are there any restrictions on meta-analyses created?
Yes. Once a meta-analysis specification is executed and results are uploaded to our platform, you will no longer be able to delete or edit the analysis specification. A complete copy of the StudySet and Analysis is kept on our system to ensure complete provenance. You can, however, keep the analysis as private to ensure it is unlisted in the public search.
If you wish to make any edits, you can edit the StudySet and create a new Analysis specification, which will receive a new unique ID.

In the event that you publish any results generated using the Neurosynth Compose, you MUST provide a link to the corresponding meta-analysis specification ID on the platform.
I've noticed that a study on your platform contains errors or is incomplete, can I fix them?
Yes! We welcome user contributions. You can correct or add details on a study, including meta-data and peak activation coordinates. A key piece of information that you may want to correct is how Activation coordinates are grouped into distinct Analyses (i.e., Contrasts). Please ensure that any edits you make are as objective as possible and reflect what is represented in the original Study, and *not* the goals of your meta-analysis.

To avoid debates about the ground truth of a Study, when you make edits a new Version of the study is created, which is associated with your User.
If I contribute new studies to the platform, or edit existing studies, will other users be able to see them?
Yes! Although a new Version of the study is created when you make any edits, we default to displaying user edited Versions over the automatically extracted versions. This is because we assume that any edits made by users will be improvements on the extraction algorithm. Please ensure any changes you make reflect this. You may also make a Version private if you don't want to share your edits with others.
How does this project relate to the original Neurosynth?
Neurosynth 1.0 was an online platform for browsing automatically generated large-scale neuroimaging meta-analyses. However, because all analyses were pre-generated, users were unable to define custom meta-analyses using the Neurosynth database. Instead, Neurosynth 1.0 used text mining techniques to automatically group studies based on the frequency of the terms mentioned in the text. Neurosynth Compose is focused on allowing users to overcome the limitations of automated large-scale meta-analysis, by enabling users to annotate studies, and curate sets of studies amenable for meta-analysis. This way, users can systematically define meta-analyses using their own expertise, while still leveraging the Neurosynth database, and an easy-to-use web-based analysis builder to accelerate the meta-analysis process.
+ \ No newline at end of file diff --git a/introduction/team.html b/introduction/team.html index 20adc5b..b3d81a6 100644 --- a/introduction/team.html +++ b/introduction/team.html @@ -5,14 +5,14 @@ Our Team | Neurosynth Compose Docs - +

Our Team

Neurosynth-Compose is collaborative effort across several laboratories, and is supported by the National Institute of Mental Health award 5R01MH096906. -Together, we developed Neurosynth-Compose, and related tools, such as NiMARE and Neurostore.

Alejandro de la Vega

Alejandro de la Vega

Principal Investigator
University of Texas at Austin

James Kent

James Kent

Postdoctoral Fellow & Principal Engineer
University of Texas at Austin

Nicholas Lee

Nicholas Lee

Frontend Engineer
McGill University

Taylor Salo

Taylor Salo

Postdoctoral fellow
University of Pennsylvania

Katie Bottenhorn

Katie Bottenhorn

Postdoctoral Fellow
University of Southern California

Jean-Baptiste Poline

Jean-Baptiste Poline

Associate Professor
McGill University

Angela Laird

Angela Laird

Professor
Florida International University

Julio Peraza

Julio Peraza

Graduate Student
Florida International University

Russ Poldrack

Russ Poldrack

Professor
Stanford University

Tom Nichols

Tom Nichols

Professor
Oxford University

Yifan Yu

Yifan Yu

Graduate Student
Oxford University

Kendra Oudyk

Kendra Oudyk

Graduate Student
McGill University

- +Together, we developed Neurosynth-Compose, and related tools, such as NiMARE and Neurostore.

Alejandro de la Vega

Alejandro de la Vega

Principal Investigator
University of Texas at Austin

James Kent

James Kent

Postdoctoral Fellow & Principal Engineer
University of Texas at Austin

Nicholas Lee

Nicholas Lee

Frontend Engineer
McGill University

Taylor Salo

Taylor Salo

Postdoctoral fellow
University of Pennsylvania

Katie Bottenhorn

Katie Bottenhorn

Postdoctoral Fellow
University of Southern California

Jean-Baptiste Poline

Jean-Baptiste Poline

Associate Professor
McGill University

Angela Laird

Angela Laird

Professor
Florida International University

Julio Peraza

Julio Peraza

Graduate Student
Florida International University

Russ Poldrack

Russ Poldrack

Professor
Stanford University

Tom Nichols

Tom Nichols

Professor
Oxford University

Yifan Yu

Yifan Yu

Graduate Student
Oxford University

Kendra Oudyk

Kendra Oudyk

Graduate Student
McGill University

+ \ No newline at end of file diff --git a/markdown-page.html b/markdown-page.html index 285190d..9500e50 100644 --- a/markdown-page.html +++ b/markdown-page.html @@ -5,13 +5,13 @@ Markdown page example | Neurosynth Compose Docs - +

Markdown page example

You don't need React to write simple standalone pages.

- + \ No newline at end of file diff --git a/tutorial.html b/tutorial.html index 9d532a6..5f44ae7 100644 --- a/tutorial.html +++ b/tutorial.html @@ -5,15 +5,15 @@ Tutorials | Neurosynth Compose Docs - +

Tutorials

Quickstart​

Neurosynth Compose supports a range of workflows, from exploratory large-scale automated analyses to highly rigorous manual analyses.

The choice of workflow depends on your research question and resources available for manual curation. -We reccomend starting with the manual meta-analysis tutorial if you are new.

Manual

Most stringent and rigorous.

  • Search across multiple sources, such as: PubMed, Web of Science, NeuroStore
  • Careful curation for inclusion/exclusion criteria
  • Extract coordinates from studies not already indexed
  • Meets PRISMA guidelines

Automated

Fast exploratory analysis.

  • Query studies at scale
  • Search using terms, topics or activation coordinates
  • Replicate results from original Neurosynth
  • Immediate results, ideal for a exploratory analysis

Advanced tutorials​

After you've completed the core tutorials above, you can continue your learning journey with advanced tutorials.

- +We reccomend starting with the manual meta-analysis tutorial if you are new.

Manual

Most stringent and rigorous.

  • Search across multiple sources, such as: PubMed, Web of Science, NeuroStore
  • Careful curation for inclusion/exclusion criteria
  • Extract coordinates from studies not already indexed
  • Meets PRISMA guidelines

Automated

Fast exploratory analysis.

  • Query studies at scale
  • Search using terms, topics or activation coordinates
  • Replicate results from original Neurosynth
  • Immediate results, ideal for a exploratory analysis

Advanced tutorials​

After you've completed the core tutorials above, you can continue your learning journey with advanced tutorials.

+ \ No newline at end of file diff --git a/tutorial/advanced.html b/tutorial/advanced.html index 9739041..76edcf0 100644 --- a/tutorial/advanced.html +++ b/tutorial/advanced.html @@ -5,13 +5,13 @@ Advanced tutorials | Neurosynth Compose Docs - +
-
- + + \ No newline at end of file diff --git a/tutorial/advanced/mkda_association.html b/tutorial/advanced/mkda_association.html index b499ffc..2473384 100644 --- a/tutorial/advanced/mkda_association.html +++ b/tutorial/advanced/mkda_association.html @@ -5,7 +5,7 @@ MKDA Chi-Squared and large-scale association tests | Neurosynth Compose Docs - + @@ -15,8 +15,8 @@ This is a fast algorithm, however, it is recommended to use FWECorrector (family-wise-error) with the montecarlo method for more accurate, publication-quality results.

Next, select the annotation inclusion column you want to use, as before (by default, the "included" column will be used).

Now, select a reference dataset from the dropdown list below. The Neurosynth dataset represents the latest release of the legacy Neurosynth dataset (version 7), released July, 2018. The Neurostore dataset represents the latest update of our continuously updating "live" dataset, spanning over 20,000 neuroimaging studies.

MKDA Chi Squared Reference

Now simply complete the rest of the meta-analysis specification wizard to finish.

Executing your analysis​

As usual, you can execute your meta-analysis using Google Colab or on a local computational resource using Docker.

tip

The MKDAChi2 algorithm takes between ~30s-2minutes to run. However, the FWECorrector with 5,000+ montecarlo iterations can take several hours to complete. We recommend using a workstation or HPC and specifying --n-cores at run-time.

Interpreting results​

The MKDA Chi-Squared Workflow outputs two key maps: uniformity and association test maps.

  • Uniformity test map: z-scores from a one-way ANOVA testing whether the proportion of studies that report activation at a given voxel differs from the rate that would be expected if activations were uniformly distributed throughout gray matter.

The uniformity test map can be interpreted in roughly the same way as most standard whole-brain fMRI analysis: it displays the degree to which each voxel is consistently activated in studies that use a given term. For instance, for a meta-analysis of "emotion" high z-scores in the amygdala implies that studies that use the word emotion a lot tend to consistently report activation in the amygdala--at least, more consistently than one would expect if activation were uniformly distributed throughout gray matter.

  • Association test map: z-scores from a two-way ANOVA testing for the presence of a non-zero association between term use and voxel activation.

The association test maps tell you whether activation in a region XXX occurs more consistently for studies in your meta-analytic sample m than for other studies in the reference dataset. In other words, a large positive z-score implies that studies in a meta-analysis are more likely to report XXX activation than studies whose abstracts don't include the word 'emotion'.

Note that association maps do not tell you what the probability of a given psychological concept or task is. High Z-scores do not imply that a certain region or voxel is selective for a given concept or task. Instead, it just means there is evidence that there is at least a non-zero difference between reference studies, and studies in the meta-analysis.

note

NiMARE outputs a variety of maps, including cluster-corrected and uncorrected versions of all maps.

See the documentation sections on Outputs of NIMARE and Monte Carlo multiple comparisons for more details.

Example: Pintos Lobo (2022) - All Social Processing Tasks​

To demonstrate, we used Neurosynth-Compose to replicate the Pintos Lobo et al., (2022) meta-analysis for All Social Processing Tasks. For this example, we have already created a Project and StudySet with the coordinates used in this meta-analysis.

We then specified a MKDAChi2 Meta-Analysis with FWECorrector with the montecarlo method with 5,000 iterations.

Meta-Analysis Specification and Results on Neurosynth Compose

Results​

First, let's look at the FWE cluster corrected uniformity test map.

z_desc-uniformityMass_level-cluster_corr-FWE_method-montecarlo Uniformity

In this analysis, we replicate the findings of Pinto Lobos (2022), showing consistent activation for social processing across a variety of regions.

Next, let's look at the FWE cluster corrected association map:

z_desc-associationMass_level-cluster_corr-FWE_method-montecarlo -Association

As before, regions which have been previously implicated with social processing, such as the tempo-parietal junction (TPJ), and dorso-medial and ventro-medial PFC are present, meaning that activity in these social processing studies report activity in these regions with greater frequency than other studies in the Neurosynth database.

However, certain regions which we know to have low specificity, such as the insula, medial frontal cingulate cortex (MFCC) and parts of dorso-lateral PFC, are absent, meaning that there is no evidence that social processing tasks report activity in these regions more frequently than other studies in the database.

This example demonstrates how MKDA Chi-Squared association analysis can help determine the specificity activity and tasks in a meta-analysis, even for high-quality manual meta-analyses.

Footnotes & Limitations​

What happened to the "forward inference" and "reverse inference" maps?

We renamed the pre-generated forward and reverse inference maps; they're now referred to as the "uniformity test" and "association test" maps that we discuss here.

Although the method we used hasn't changed (MKDA Chi-Squared), the latter names more accurately capture what these maps actually mean. It was a mistake on our part to have used the forward and reverse inference labels; those labels should properly be reserved for posterior probability maps generated via a Bayesian estimation analysis, rather than for z-scores resulting from a frequentist inferential test of association. Probability maps are more difficult to interpret and use correctly, as they depend on the prior assumed by the researcher. Since setting an appropriate prior is highly non-trivial, these maps are disabled by default.

Using MKDA Chi Squared on manual meta-analyses

In this tutorial, we applied MKDA Chi-Squared to a manual meta-analysis. However, this is not a perfect comparison, as there are differences between the reference sample (Neurosynth), the high-quality manual annotations given as input. Studies in large-scale meta-analytic databases are automatically populated, meaning there are potential sampling biases. Most notably, studies in Neurosynth include all reported coordinates, not only "target" analyses/contrasts. Thus, it is possible that low-level task > no task contrasts are over-represented in this reference sample.

References & Further Reading​

If you want to understand the nuances of what inferences you can and cannot make using these maps, we recommend reading Tal Yarkoni's blog posts on how these maps do not provide evidence that the dACC is select for pain: Post 1, Post 2, as well as a commentary by Tor Wager et al., 2016

Poldrack RA. Inferring mental states from neuroimaging data: from reverse inference to large-scale decoding. Neuron. 2011 Dec 8;72(5):692-7. doi: 10.1016/j.neuron.2011.11.001. PMID: 22153367; PMCID: PMC3240863.

Poldrack RA, Yarkoni T. From Brain Maps to Cognitive Ontologies: Informatics and the Search for Mental Structure. Annu Rev Psychol. 2016;67:587-612. doi: 10.1146/annurev-psych-122414-033729. Epub 2015 Sep 21. PMID: 26393866; PMCID: PMC4701616.

- +Association

As before, regions which have been previously implicated with social processing, such as the tempo-parietal junction (TPJ), and dorso-medial and ventro-medial PFC are present, meaning that activity in these social processing studies report activity in these regions with greater frequency than other studies in the Neurosynth database.

However, certain regions which we know to have low specificity, such as the insula, medial frontal cingulate cortex (MFCC) and parts of dorso-lateral PFC, are absent, meaning that there is no evidence that social processing tasks report activity in these regions more frequently than other studies in the database.

This example demonstrates how MKDA Chi-Squared association analysis can help determine the specificity activity and tasks in a meta-analysis, even for high-quality manual meta-analyses.

Footnotes & Limitations​

What happened to the "forward inference" and "reverse inference" maps?

We renamed the pre-generated forward and reverse inference maps; they're now referred to as the "uniformity test" and "association test" maps that we discuss here.

Although the method we used hasn't changed (MKDA Chi-Squared), the latter names more accurately capture what these maps actually mean. It was a mistake on our part to have used the forward and reverse inference labels; those labels should properly be reserved for posterior probability maps generated via a Bayesian estimation analysis, rather than for z-scores resulting from a frequentist inferential test of association. Probability maps are more difficult to interpret and use correctly, as they depend on the prior assumed by the researcher. Since setting an appropriate prior is highly non-trivial, these maps are disabled by default.

Using MKDA Chi Squared on manual meta-analyses

In this tutorial, we applied MKDA Chi-Squared to a manual meta-analysis. However, this is not a perfect comparison, as there are differences between the reference sample (Neurosynth), the high-quality manual annotations given as input. Studies in large-scale meta-analytic databases are automatically populated, meaning there are potential sampling biases. Most notably, studies in Neurosynth include all reported coordinates, not only "target" analyses/contrasts. Thus, it is possible that low-level task > no task contrasts are over-represented in this reference sample.

References & Further Reading​

If you want to understand the nuances of what inferences you can and cannot make using these maps, we recommend reading Tal Yarkoni's blog posts on how these maps do not provide evidence that the dACC is select for pain: Post 1, Post 2, as well as a commentary by Tor Wager et al., 2016

Poldrack RA. Inferring mental states from neuroimaging data: from reverse inference to large-scale decoding. Neuron. 2011 Dec 8;72(5):692-7. doi: 10.1016/j.neuron.2011.11.001. PMID: 22153367; PMCID: PMC3240863.

Poldrack RA, Yarkoni T. From Brain Maps to Cognitive Ontologies: Informatics and the Search for Mental Structure. Annu Rev Psychol. 2016;67:587-612. doi: 10.1146/annurev-psych-122414-033729. Epub 2015 Sep 21. PMID: 26393866; PMCID: PMC4701616.

+ \ No newline at end of file diff --git a/tutorial/automated.html b/tutorial/automated.html index ac75612..9ef76f6 100644 --- a/tutorial/automated.html +++ b/tutorial/automated.html @@ -5,7 +5,7 @@ Automated Meta-Analysis | Neurosynth Compose Docs - + @@ -13,8 +13,8 @@

Automated Meta-Analysis

How to create a fully automated meta-analysis

caution

This tutorial, and the functionality for automated meta-analysis, is under construction. To view existing automated meta-analyses, you can use Neurosynth Original

Why automated meta-analysis?​

The principal difference between an automated and a manual meta-analysis is the process used to select the final set of Studies and Analyses to include into your meta-analysis.

In a manual meta-analysis, researchers cast a wide net to find a wide range of potentially relevant articles, and use their expertise (read: painstakingly review hundreds of articles) to decide which of articles are relevant to their research question. Our platform seeks streamline this process through a user-friendly interface and pre-extracted data for over 20,000 neuroimaging studies. Yet, a gold standard meta-analysis still requires a significant time investment, limiting their application in routine scientific practice.

In an automated meta-analysis, we instead use data-driven text mining metrics to select articles. The original Neurosynth pioneered this approach by developing text mining techniques to automatically extract brain coordinates and semantic text features from thousands of articles.

Surprisingly, this works! For example, by meta-analyzing all studies that mention the term "emotional" above a certain frequency, we observe a strong association with activity in the amygdala. By and large, the sheer number of studies overcomes the inherent noisiness of automated data extraction and study selection.

Flexible automated meta-analysis in Neurosynth Compose​

Although automated meta-analyses have proved to be a useful tool, there are several limitations. The overall goal of Neurosynth Compose is to give users a flexible data curation platform, to overcome these limitations using their expert knowledge. For example:

  • Flexible selection criteria. The original Neurosynth has a fixed number of terms and meta-analyses. WithNeurosynth Compose you can flexibly search the NeuroStore database using a powerful and flexible search to precisely define your search criteria.
  • Combine expert knowledge with automated selection. Automated study selection is inherently an noisy and imperfect measure. With Neurosynth Compose, you can use automated study selection as a first pass, and later apply your own expert criteria to refine study inclusion criteria.
  • Correct data extraction errors. Automated extraction can miss entire tables of coordinates (e.g. supplementary materials), duplicate coordinates, and groups distinct sets of Analyses (e.g. Contrasts) into a single group. Now, you can correct these data to make your meta-analysis more precise.

Tutorial​

An automated meta-analysis in Neurosynth Compose looks a lot like a manual one, except data curation is optional. We reccomeend following the manual meta-analysis tutorial to learn in depth about our platform.

Search & Curate​

One of the main differences between a manual and automated meta-analysis, is the steps required to select studies. As such, we reccomeend selecting the "Simple" curation workflow, which only consists of a single data curation step (which is optional).

Simple Workflow.

tip

Decide ahead of time if you want to perform a Coordinate or an Image based meta-analysis. Image-based Meta-Analysis (IBMA) is more precise and powerful, but there are much fewer studies available.

Import from Neurostore​

Let's add studies to our curation board by clicking Import Studies. In an automated meta-analysis, you'll want to select Import via NeuroStore, as all indexed studies are guaranteed to contain imaging data (saving you from manual data extraction).

caution

Although the NeuroStore database is continuously growing, it is necessarily an incomplete snapshot of the neuroimaging literature

Input any search term to narrow down studies. This will search the Title and Abstract fields. You may also add additional search filters using the + Add Filter button, and select the desired modality of the imaging data.

Neurostore Search.

To import your search, click "Import Studies From Neurostore" at the bottom right. Give your import a name to Tag all imported studies, and continue back to your Curation board.

note

You must import an entire set of search results into your curation board. If you want to exclude any specific studies, you will do so on your board. This allows the Search & Curate process to be fully reproducible.

Promote studies​

Back to your Curation board, you will now see all studies from your NeuroStore search on the left most column.

Curation board.

At this point, you have two options: manually review the search results and select which studies to include, or perform a fully automated meta-analysis by including all search results.

For this tutorial, we'll skip manual curation and Promote All Uncategorized Studies to the right-most "Included" column.

We can now click Move to Extraction Phase.

Extraction and Annotation​

At this point, you will create a StudySet containing all of your Studies. Advance through the dialog to begin Extraction.

The goal of this phase is to add or correct imaging data (e.g. Coordinates) in imported studies, and create Annotations to determine which Analyses (e.g. Contrasts), should be included in your meta-analysis.

Since we are performing a manual meta-analysis, we're going to skip these steps!

From the main Project page, we can click "Mark All as Complete".

Skip Extraction.

tip

It's up to you if you want to skip this step. The validity of your meta-analysis is highly dependant on input data, so we only recommend skipping all curation for exploratory analyses.

Specify Meta-Analyses​

You can now specify your meta-analysis. This step will be identical between automated and manual meta-analyses.

First, we select the "included" column, which by default includes all Study Analyses as inputs.

Inclusion column.

Next, we select a meta-analysis algorithm. This time, we'll select MKDA Chi-Squared (MKDAChi2) with FDRCorrector.

MKDA Chi-Square compares your StudySet to a reference set of studies (all the studies in NeuroStore that you did not select), allowing you to identify areas of stronger association with your selected studies. This is the algorithm used in the original Neurosynth Platform.

Execute​

Once you specify your meta-analysis, you can execute it in the cloud using Google Colab using your unique meta-analysis id.

Automated execute.

Congratulations, you have now run an automated meta-analysis!

Remember, just because it is easy to run a meta-analysis and get results, does not mean the results are valid. -It is important to think about the validity of your study selection process, for both manual and automated meta-analyses.

- +It is important to think about the validity of your study selection process, for both manual and automated meta-analyses.

+ \ No newline at end of file diff --git a/tutorial/manual.html b/tutorial/manual.html index 30655e6..bcafc64 100644 --- a/tutorial/manual.html +++ b/tutorial/manual.html @@ -5,7 +5,7 @@ Manual Meta-Analysis | Neurosynth Compose Docs - + @@ -50,8 +50,8 @@ Remember, by default, the "included" column will be created and include all Analyses.

Next, you will select a meta-analysis Algorithm and Corrector:

Meta-analysis algorithm

A variety of common meta-analysis algorithms such as "ALE" and "MKDA" are available, as well as two strategies for controlling for multiple comparisons: FDR (false detection rate) and FWE (family wise error).

For this example, we'll choose "MKDADensity" and and "FDRCorrection". You can modify the parameters for each, if you want, but we provide sane defaults for all.

tip

Learn more about meta-analysis algorithms in the NiMARE Documentation

Next, you'll give your meta-analysis a name, and review the details of your specification.

Meta-analysis review

tip

You can define multiple Meta-Analysis specifications in a Project, paired to the same StudySet

Run your meta-analysis!​

Congratulations! You now have a Meta-Analysis specification that is ready to run.

You can execute your Meta-Analysis for free in the cloud on Google Colab by copying the unique meta-analysis id -and pasting it into our Google Colab notebook.

Meta-analysis run

- +and pasting it into our Google Colab notebook.

Meta-analysis run

+ \ No newline at end of file