You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/guide/Project/Curation.md
+44-37Lines changed: 44 additions & 37 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,32 +5,32 @@ sidebar_position: 0
5
5
6
6
# Curation
7
7
8
-
*Curation* is the first step in creating a meta-analysis, and begins by *searching* for and *importing* studies into the project. Next, you will *review* studies for inclusion based on their relevancy to your research question. This involves **excluding** irrelevant studies, and **including** relevant ones.
8
+
_Curation_ is the first step in creating a meta-analysis, and begins by _searching_ for and _importing_ studies into the project. Next, you will _review_ studies for inclusion based on their relevancy to your research question. This involves **excluding** irrelevant studies, and **including** relevant ones.
9
9
10
10
At the end of the process, you will be ready to create a [**Studyset**](/compose-docs/guide/glossary#studyset) of related studies that are amenable for neuroimaging meta-analysis
11
11
12
12
## Getting Started
13
13
14
-
The curation interface uses columns as a way to label studies based on their current status.
15
-
The left most column is the starting point and all studies imported into the project will begin there.
16
-
The right most column is the **inclusion column** and is the place where studies will go to be included in the meta-analysis.
14
+
The curation interface uses columns as a way to label studies based on their current status.
15
+
The left most column is the starting point and all studies imported into the project will begin there.
16
+
The right most column is the **inclusion column** and is the place where studies will go to be included in the meta-analysis.
17
17
18
18
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.
19
19
If a study is not eligible for inclusion at any point, it should be marked as "excluded" before reaching the inclusion column.
20
20
21
21
The curation step is complete when all studies have been categorized, either by being included or excluded.
22
22
23
-
When you first begin *Curation*, you will choose between different workflows, which vary in how rigorous or systematic the selection of studies will be.
23
+
When you first begin _Curation_, you will choose between different workflows, which vary in how rigorous or systematic the selection of studies will be.
24
24
25
25
:::tip How specific to be?
26
26
27
-
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 *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 *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.
28
-
:::
27
+
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 _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 _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.
28
+
:::
29
29
30
30
### PRISMA Workflow
31
31
32
32
PRISMA stands for the **Preferred Reporting Items for Systematic Review and Meta-Analyses**. The
33
-
[PRISMA guidelines](http://www.prisma-statement.org/?AspxAutoDetectCookieSupport=1) are a set of rules for reporting a
33
+
[PRISMA guidelines](http://www.prisma-statement.org/?AspxAutoDetectCookieSupport=1) are a set of rules for reporting a
34
34
systematic review, and are the gold standard for producing a proper, rigorous, and transparent meta-analysis.
35
35
36
36
If you are trying to create a rigorous [PRISMA compliant manual meta-analysis](/compose-docs/tutorial/manual) you will want to select this option.
@@ -42,14 +42,14 @@ After importing studies into neurosynth, they will be placed into the identifica
42
42
43
43
:::info PRISMA Summary
44
44
The **Identification** column is where all imported studies are deposited into initially. As alluded to by the name, the identification
45
-
column is where you identify all records yielded from your search. In this column, you wil exclude studies purely based on whether they are
45
+
column is where you identify all records yielded from your search. In this column, you wil exclude studies purely based on whether they are
46
46
duplicates of existing studies. All other studies are promoted.
47
47
48
-
The **Screening** column consists of all records that have been screened for duplicates. In this column, you want to review the titles/abstracts of studies
49
-
and exclude purely based on whether they are irrelevant to your research question or domain. All other studies are promoted.
48
+
The **Screening** column consists of all records that have been screened for duplicates. In this column, you want to review the titles/abstracts of studies
49
+
and exclude purely based on whether they are irrelevant to your research question or domain. All other studies are promoted.
50
50
51
-
The **Eligibility** column consists of all records that have been screened for duplicates and irrelevant content. In this column, you want to
52
-
review the full text of studies and exclude based on whether the study described aligns with the standards of the meta-analysis itself. Reasons
51
+
The **Eligibility** column consists of all records that have been screened for duplicates and irrelevant content. In this column, you want to
52
+
review the full text of studies and exclude based on whether the study described aligns with the standards of the meta-analysis itself. Reasons
53
53
for exclusion may include wrong setting, wrong patient population, wrong intervention, wrong paragdigm, etc.
54
54
55
55
The **Included** column consists of all records that have passed previous levels of exclusion and can be considered for the next step of the project.
@@ -65,17 +65,17 @@ This workflow is initalized with only two columns. As before, the left most colu
65
65
66
66
## Importing
67
67
68
-
To begin importing studies into your project clicking the**IMPORT STUDIES** button.
68
+
To begin importing studies into your project click the **IMPORT STUDIES** button.
69
69
70
-
You will be asked to choose a source, name your import, and address
70
+
You will be asked to choose an import method, source, name for your import, and finally address
71
71
any potential duplicate studies.
72
72
73
73
:::tip
74
-
We recommend giving each import a meaningful name. This will be useful when you come back
74
+
We recommend giving each import a meaningful name. This will be useful when you come back
75
75
and want to know where a certain study was imported from.
76
76
:::
77
77
78
-
### Import from Neurostore
78
+
### Import Method 1: Import from Neurostore
79
79
80
80
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.
81
81
@@ -86,69 +86,72 @@ After entering your search, click the bottom right button to import the searched
86
86
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.
87
87
:::
88
88
89
-
### Import from PubMed
89
+
### Import Method 2: Import from PubMed
90
90
91
-
Use this option to import studies directly from PubMed. To start, you need to go to the [PubMed Site](https://pubmed.ncbi.nlm.nih.gov/)
92
-
and either enter in a search or navigate to a previously created collection.
91
+
Use this option to import studies directly from PubMed. To start, you need to go to the [PubMed Site](https://pubmed.ncbi.nlm.nih.gov/)
92
+
and either enter in a search or navigate to a previously created collection.
93
93
94
94
To import the search or collection from PubMed into neurosynth-compose, you will need a text file containing a list of PMIDs.
95
-
You can obtain this by going to your collection/search and clicking the **Save** button. Set **Selection** to **All results**
95
+
You can obtain this by going to your collection/search and clicking the **Save** button. Set **Selection** to **All results**
96
96
and set **Format** to **PMID**. Click **Create file** and your text file containing the PMIDs will be generated and downloaded.
97
97
98
98
:::caution
99
99
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.
100
-
If your collection has more than 1,500 PMIDs, split the import into multiple files.
100
+
If 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.
101
101
:::
102
102
103
-
### Import from BibTex/RIS/endnote
103
+
### Import Method 3: Import from BibTex/RIS/endnote
104
104
105
105
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.
106
106
107
-
### Custom Studies
107
+
### Import Method 4: Custom Studies
108
108
109
-
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
109
+
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
110
110
to include resources like unpublished studies.
111
111
112
+
### Sleuth files
113
+
114
+
At the moment, it's not possible to add studies from a sleuth file into an _existing project_. To create a new project from a sleuth file, [read more here](/compose-docs/guide/glossary#studyset).
115
+
112
116
### Duplicates
113
117
114
-
If duplicates are detected in your import, you will be asked how to re-concile 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 over-ride any of these selection at any time, and choose which studies to keep or exclude.
118
+
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.
115
119
116
120
:::info
117
-
*Neurosynth Compose* does not delete studies. If a study is marked as a duplicate, it is marked as **excluded** but it is not discarded to ensure complete provenance.
121
+
_Neurosynth Compose does not delete studies_. If a study is marked as a duplicate, it is marked as **excluded** but it is not discarded to ensure complete provenance.
118
122
:::
119
123
120
124
There are two potential ways that duplicates can occur:
121
125
122
126
#### Duplicates are detected between the studies being imported and the studies already in the project
123
127
124
-
If any study being important has the same title, PMID, or DOI is the same as
128
+
If any study being important has the same title, PMID, or DOI is the same as
125
129
one already in the project, you will be asked reconcile these duplicates.
126
130
127
-
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.
131
+
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.
128
132
129
133
#### Duplicates are detected within the file you are importing
130
134
131
-
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.
135
+
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.
132
136
133
137
## Excluding and Promoting Studies
134
138
135
-
Once studies have been imported into the first column of the curation phase, they need to be reviewed for inclusion into your meta-analysis.
139
+
Once studies have been imported into the first column of the curation phase, they need to be reviewed for inclusion into your meta-analysis.
136
140
All studies must be either excluded or moved to the inclusion column in order to progress to the extraction phase.
137
141
138
-
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
139
-
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.
142
+
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
143
+
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.
140
144
141
145
### Exclude
142
146
143
-
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
147
+
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
144
148
typing to create a new one.
145
149
146
150
:::tip
147
151
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.
148
152
Revisit the [PRISMA workflow](./Curation#prisma-workflow) to review reccomended exclusion criteria.
149
153
:::
150
154
151
-
152
155
### Promote
153
156
154
157
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.
@@ -157,9 +160,13 @@ If a study meets inclusion critera (for the current phase), click **PROMOTE** to
157
160
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.
158
161
:::
159
162
163
+
## Downloading included studies
164
+
165
+
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.
166
+
160
167
## On to Extraction
161
168
162
-
When you have categorized all imported studies by either excluding them or moving them to the inclusion column, then you have
169
+
When you have categorized all imported studies by either excluding them or moving them to the inclusion column, then you have
163
170
successfully completed the curation portion of the meta-analysis.
164
171
165
-
*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](./Extraction).
172
+
_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](./Extraction).
0 commit comments