Skip to content

Commit 482c46e

Browse files
authored
feat: add codespell (#17)
1 parent e5ec291 commit 482c46e

File tree

4 files changed

+230
-47
lines changed

4 files changed

+230
-47
lines changed

.github/workflows/codespell.yml

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
name: Codespell
2+
3+
on:
4+
push:
5+
branches: [master]
6+
pull_request:
7+
branches: [master]
8+
9+
permissions:
10+
contents: read
11+
12+
jobs:
13+
codespell:
14+
name: Check for spelling errors
15+
runs-on: ubuntu-latest
16+
17+
steps:
18+
- name: Checkout
19+
uses: actions/checkout@v4
20+
- name: Codespell
21+
uses: codespell-project/actions-codespell@master
22+
with:
23+
path: src

.github/workflows/deploy.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,4 +35,4 @@ jobs:
3535
# The GH actions bot is used by default if you didn't specify the two fields.
3636
# You can swap them out with your own user credentials.
3737
user_name: github-actions[bot]
38-
user_email: 41898282+github-actions[bot]@users.noreply.github.com
38+
user_email: 41898282+github-actions[bot]@users.noreply.github.com

docs/guide/Project/Curation.md

Lines changed: 44 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -5,32 +5,32 @@ sidebar_position: 0
55

66
# Curation
77

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.
99

1010
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
1111

1212
## Getting Started
1313

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.
1717

1818
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.
1919
If a study is not eligible for inclusion at any point, it should be marked as "excluded" before reaching the inclusion column.
2020

2121
The curation step is complete when all studies have been categorized, either by being included or excluded.
2222

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.
2424

2525
:::tip How specific to be?
2626

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+
:::
2929

3030
### PRISMA Workflow
3131

3232
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
3434
systematic review, and are the gold standard for producing a proper, rigorous, and transparent meta-analysis.
3535

3636
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
4242

4343
:::info PRISMA Summary
4444
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
4646
duplicates of existing studies. All other studies are promoted.
4747

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.
5050

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
5353
for exclusion may include wrong setting, wrong patient population, wrong intervention, wrong paragdigm, etc.
5454

5555
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
6565

6666
## Importing
6767

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.
6969

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
7171
any potential duplicate studies.
7272

7373
:::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
7575
and want to know where a certain study was imported from.
7676
:::
7777

78-
### Import from Neurostore
78+
### Import Method 1: Import from Neurostore
7979

8080
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.
8181

@@ -86,69 +86,72 @@ After entering your search, click the bottom right button to import the searched
8686
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.
8787
:::
8888

89-
### Import from PubMed
89+
### Import Method 2: Import from PubMed
9090

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.
9393

9494
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**
9696
and set **Format** to **PMID**. Click **Create file** and your text file containing the PMIDs will be generated and downloaded.
9797

9898
:::caution
9999
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.
101101
:::
102102

103-
### Import from BibTex/RIS/endnote
103+
### Import Method 3: Import from BibTex/RIS/endnote
104104

105105
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.
106106

107-
### Custom Studies
107+
### Import Method 4: Custom Studies
108108

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
110110
to include resources like unpublished studies.
111111

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+
112116
### Duplicates
113117

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.
115119

116120
:::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.
118122
:::
119123

120124
There are two potential ways that duplicates can occur:
121125

122126
#### Duplicates are detected between the studies being imported and the studies already in the project
123127

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
125129
one already in the project, you will be asked reconcile these duplicates.
126130

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.
128132

129133
#### Duplicates are detected within the file you are importing
130134

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.
132136

133137
## Excluding and Promoting Studies
134138

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.
136140
All studies must be either excluded or moved to the inclusion column in order to progress to the extraction phase.
137141

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.
140144

141145
### Exclude
142146

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
144148
typing to create a new one.
145149

146150
:::tip
147151
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.
148152
Revisit the [PRISMA workflow](./Curation#prisma-workflow) to review reccomended exclusion criteria.
149153
:::
150154

151-
152155
### Promote
153156

154157
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
157160
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.
158161
:::
159162

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+
160167
## On to Extraction
161168

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
163170
successfully completed the curation portion of the meta-analysis.
164171

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

Comments
 (0)