Skip to content

Commit 17f2c80

Browse files
authored
added readme
1 parent 674a5fa commit 17f2c80

File tree

1 file changed

+62
-0
lines changed

1 file changed

+62
-0
lines changed

README.md

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
## BIDS App for calculating cortical thickness using ANTs
2+
This BIDS App runs ANTs cortical thickness estimation pipeline.
3+
4+
For more information about the specification of BIDS Apps see [here](https://docs.google.com/document/d/1E1Wi5ONvOVVnGhj21S1bmJJ4kyHFT7tkxnV3C23sjIE/edit#).
5+
6+
### Description
7+
The app finds all T1w files for each subject and runs antsCorticalThickness.sh (if there is only one T1w file per subject) or
8+
antsLongitudinalCorticalThickness.sh (if there are more than one T1w files).
9+
10+
### Documentation
11+
https://github.com/ANTsX/ANTs
12+
13+
### How to report errors
14+
https://github.com/BIDS-Apps/antsCorticalThickness/issues
15+
16+
### Acknowledgements
17+
https://github.com/ANTsX/ANTs#boilerplate-ants
18+
19+
### Usage
20+
This App has the following command line arguments:
21+
22+
usage: run.py [-h]
23+
[--participant_label PARTICIPANT_LABEL [PARTICIPANT_LABEL ...]]
24+
[--n_cpus N_CPUS]
25+
[--stage {brain_extraction,template_registration,tissue_segmentation,qc,cortical_thickness}]
26+
[-v]
27+
bids_dir output_dir {participant}
28+
29+
Cortical thickness estimation using ANTs.
30+
31+
positional arguments:
32+
bids_dir The directory with the input dataset formatted
33+
according to the BIDS standard.
34+
output_dir The directory where the output files should be stored.
35+
If you are running group level analysis this folder
36+
should be prepopulated with the results of
37+
theparticipant level analysis.
38+
{participant} Level of the analysis that will be performed. Multiple
39+
participant level analyses can be run independently
40+
(in parallel) using the same output_dir.
41+
42+
optional arguments:
43+
-h, --help show this help message and exit
44+
--participant_label PARTICIPANT_LABEL [PARTICIPANT_LABEL ...]
45+
The label(s) of the participant(s) that should be
46+
analyzed. The label corresponds to
47+
sub-<participant_label> from the BIDS spec (so it does
48+
not include "sub-"). If this parameter is not provided
49+
all subjects should be analyzed. Multiple participants
50+
can be specified with a space separated list.
51+
--n_cpus N_CPUS Number of CPUs/cores available to use.
52+
--stage {brain_extraction,template_registration,tissue_segmentation,qc,cortical_thickness}
53+
Which stage of ACT to run
54+
-v, --version show program's version number and exit
55+
56+
To run it in participant level mode (for one participant):
57+
58+
docker run -i --rm \
59+
-v /Users/filo/data/ds005:/bids_dataset:ro \
60+
-v /Users/filo/outputs:/outputs \
61+
bids/antscorticalthickness \
62+
/bids_dataset /outputs participant --participant_label 01

0 commit comments

Comments
 (0)