|
Size: 3006
Comment: updated ftp download instructions
|
Size: 3934
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| [wiki:Self:FsTutorial top] | [wiki:Self:FsTutorial previous] | [wiki:Self:FsTutorial/Overview next] | [wiki:Self:FsTutorial top] |
| Line 5: | Line 5: |
| A public distribution data set is available to run the tutorials. It contains 40 subjects, and occupies about 20G of disk-space after downloaded and uncompressed. The data set is divided into two files: the data for the troubleshooting examples (6GB), and the data for the group study analysis (14GB). | A [http://surfer.nmr.mgh.harvard.edu/pub/dist/buckner_public_distribution.README.txt public distribution data set] is available to run the tutorials. It contains 40+ subjects, and occupies about 11G of disk-space after download and decompression. There are two download methods: using a web browser, or using the ftp application. The ftp application is recommended, as some web browsers have difficulty downloading files greater than 4GB in size.There are also two tar files associated with the tutorial on the integration of FreeSurfer and FSL/FEAT. |
| Line 7: | Line 7: |
| The files can be obtained via anonymous ftp. Use '''ftp surfer.nmr.mgh.harvard.edu'''. Login as '''anonymous''' and use your email addresses as the password. | === Download using the FTP application === At your terminal, type '''ftp surfer.nmr.mgh.harvard.edu'''. Login as '''anonymous''' and use your email address as the password. |
| Line 29: | Line 31: |
| The troubleshooting tutorials, in the section [wiki:Self:FsTutorial/MorphAndRecon Morphometry and Reconstruction], require the '''buckner_data-tutorial_subjs.tar.gz''' download, which is 4.5GB compressed: | The troubleshooting and group study analysis tutorials require the '''buckner_data-tutorial_subjs.tar.gz''' download, which is 6.5GB compressed (11GB decompressed): |
| Line 33: | Line 35: |
The group study [wiki:Self:FsTutorial/GroupAnalysis analysis] and [wiki:Self:FsTutorial/Visualization visualization] tutorials require the '''buckner_data-group_study.tar.gz''' download, which is about 6.5GB compressed: |
To get the FSL-FEAT tutorial data |
| Line 36: | Line 37: |
| ftp> get buckner_data-group_study.tar.gz | ftp> get fbert-feat.tar.gz ftp> get bert.recon.tar.gz |
| Line 44: | Line 46: |
| Once a file is downloaded, move the file(s) to the $FREESURFER_HOME/subjects directory, and uncompress and install with the following command: | === Download using the web browser === Some web browsers seem to have difficulty downloading files greater than 4GB in size, but if you would like to attempt the download using your browser, then the one necessary file is listed next (click on the .tar.gz filename to download). The troubleshooting and group study analysis tutorials require this download: * [ftp://surfer.nmr.mgh.harvard.edu/pub/dist/buckner_data-tutorial_subjs.tar.gz buckner_data-tutorial_subjs.tar.gz] The FSL-FEAT tutorial require this download: * [ftp://surfer.nmr.mgh.harvard.edu/pub/dist/fbert-feat.tar.gz fbert-feat.tar.gz] * [ftp://surfer.nmr.mgh.harvard.edu/pub/dist/bert.recon.tar.gz bert.recon.tar.gz] === Installation === Once the file is downloaded (via either ftp or web browser), move the file(s) to the $FREESURFER_HOME/subjects directory, and uncompress and install with the following command: |
| Line 47: | Line 61: |
| tar xzvf buckner_data-<dataset>.tar.gz | tar xzvf buckner_data-tutorial_subjs.tar.gz |
| Line 50: | Line 64: |
| where <dataset> is either '''tutorial_subjs''' or '''group_study'''. | The downloaded .tar.gz file can then be deleted. |
| Line 52: | Line 66: |
| The downloaded file can then be deleted. To setup the environment variable SUBJECTS_DIR to point to the troubleshooting tutorial data (for use in the tutorial section [wiki:Self:FsTutorial/MorphAndRecon Morphometry and Reconstruction]), type the following command or include in your .cshrc or .tcshrc file: |
To setup the environment variable SUBJECTS_DIR to point to the tutorial data, type the following command or include in your .cshrc or .tcshrc file: |
| Line 56: | Line 68: |
| source $FREESURFER_HOME/subjects/buckner_data/tutorial_subjs/scripts/setup_subjects.csh | source $FREESURFER_HOME/subjects/buckner_data/tutorial_subjs/scripts/subjects.csh |
| Line 59: | Line 71: |
| To setup the environment variables SUBJECTS_DIR and SUBJECTS to point to the group study tutorial data (for use in the tutorial sections group study [wiki:Self:FsTutorial/GroupAnalysis analysis] and [wiki:Self:FsTutorial/Visualization visualization]), type the following command or include in your .cshrc or .tcshrc file: | The tutorial will also instruct you to set the SUBJECTS_DIR when appropriate. === Additional group study data === There is an additional data set available upon which further group study analysis could be conducted. It is composed of the 40 subjects from which the tutorial's group study component was created. The data set is the full Freesurfer reconstruction of the 40 subjects (conducted using stable v3.0.2). It is 10.5GB compressed, and 18GB decompressed. It is named '''buckner_data-group_study.tar.gz'''. Also, there is the file '''buckner_data-raw_dicoms.tar.gz''', which, as indicated by the name, contains the original DICOM files for the subjects. Be sure to [http://surfer.nmr.mgh.harvard.edu/pub/dist/buckner_public_distribution.README.txt read these notes.] === FSL-FEAT Tutorial Data === |
| Line 61: | Line 78: |
| source $FREESURFER_HOME/subjects/buckner_data/group_study/scripts/setup_subjects.csh | cd $SUBJECTS_DIR tar xvfz bert.recon.tar.gz cd /place/for/functional/data tar xvfz bertf-feat.tar.gz |
| Line 64: | Line 84: |
| You can only source one '''setup_subjects.csh''' file at a time. The tutorial will also instruct you to set the SUBJECTS_DIR when appropriate. |
[wiki:FsTutorial top]
FreeSurfer Tutorial: Sample Data
A [http://surfer.nmr.mgh.harvard.edu/pub/dist/buckner_public_distribution.README.txt public distribution data set] is available to run the tutorials. It contains 40+ subjects, and occupies about 11G of disk-space after download and decompression. There are two download methods: using a web browser, or using the ftp application. The ftp application is recommended, as some web browsers have difficulty downloading files greater than 4GB in size.There are also two tar files associated with the tutorial on the integration of FreeSurfer and FSL/FEAT.
Download using the FTP application
At your terminal, type ftp surfer.nmr.mgh.harvard.edu. Login as anonymous and use your email address as the password.
Example login:
$ ftp surfer.nmr.mgh.harvard.edu Connected to surfer.nmr.mgh.harvard.edu (132.183.202.158). 220 surfer.nmr.mgh.harvard.edu FTP server (Version wu-2.6.2-15.7x.legacy) ready. Name (surfer.nmr.mgh.harvard.edu:fsurfer): anonymous 331 Guest login ok, send your complete e-mail address as password. Password: 230 Guest login ok, access restrictions apply. Remote system type is UNIX. Using binary mode to transfer files. ftp>
The tutorial datasets are found in the pub/dist directory:
ftp> cd pub/dist
The troubleshooting and group study analysis tutorials require the buckner_data-tutorial_subjs.tar.gz download, which is 6.5GB compressed (11GB decompressed):
ftp> get buckner_data-tutorial_subjs.tar.gz
To get the FSL-FEAT tutorial data
ftp> get fbert-feat.tar.gz ftp> get bert.recon.tar.gz
Now exit the ftp application:
ftp> quit
Download using the web browser
Some web browsers seem to have difficulty downloading files greater than 4GB in size, but if you would like to attempt the download using your browser, then the one necessary file is listed next (click on the .tar.gz filename to download).
The troubleshooting and group study analysis tutorials require this download:
[ftp://surfer.nmr.mgh.harvard.edu/pub/dist/buckner_data-tutorial_subjs.tar.gz buckner_data-tutorial_subjs.tar.gz]
The FSL-FEAT tutorial require this download:
[ftp://surfer.nmr.mgh.harvard.edu/pub/dist/fbert-feat.tar.gz fbert-feat.tar.gz]
[ftp://surfer.nmr.mgh.harvard.edu/pub/dist/bert.recon.tar.gz bert.recon.tar.gz]
Installation
Once the file is downloaded (via either ftp or web browser), move the file(s) to the $FREESURFER_HOME/subjects directory, and uncompress and install with the following command:
tar xzvf buckner_data-tutorial_subjs.tar.gz
The downloaded .tar.gz file can then be deleted.
To setup the environment variable SUBJECTS_DIR to point to the tutorial data, type the following command or include in your .cshrc or .tcshrc file:
source $FREESURFER_HOME/subjects/buckner_data/tutorial_subjs/scripts/subjects.csh
The tutorial will also instruct you to set the SUBJECTS_DIR when appropriate.
Additional group study data
There is an additional data set available upon which further group study analysis could be conducted. It is composed of the 40 subjects from which the tutorial's group study component was created. The data set is the full Freesurfer reconstruction of the 40 subjects (conducted using stable v3.0.2). It is 10.5GB compressed, and 18GB decompressed. It is named buckner_data-group_study.tar.gz. Also, there is the file buckner_data-raw_dicoms.tar.gz, which, as indicated by the name, contains the original DICOM files for the subjects. Be sure to [http://surfer.nmr.mgh.harvard.edu/pub/dist/buckner_public_distribution.README.txt read these notes.]
FSL-FEAT Tutorial Data
cd $SUBJECTS_DIR tar xvfz bert.recon.tar.gz cd /place/for/functional/data tar xvfz bertf-feat.tar.gz