|
Size: 2379
Comment: download and setup of the sample data
|
Size: 5281
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] | [[FsTutorial|top]] |
| Line 3: | Line 3: |
| == FreeSurfer Tutorial: Sample Data == | '''Index''' |
| Line 5: | Line 5: |
| A public distribution data set is available to run the tutorials. It contains 40 subjects, and occupies about 21G of disk-space. The data set is divided into two files: the data for the troubleshooting examples (7GB), and the data for the group study analysis (14GB). | <<TableOfContents>> |
| Line 7: | Line 7: |
| The files are available from the [ftp://surfer.nmr.mgh.harvard.edu/pub/dist distribution site], and are called [ftp://surfer.nmr.mgh.harvard.edu/pub/dist/buckner_data-tutorial_subjs.tar.gz buckner_data-tutorial_subjs.tar.gz] and [ftp://surfer.nmr.mgh.harvard.edu/pub/dist/buckner_data-group_study.tar.gz buckner_data-group_study.tar.gz]. |
== FreeSurfer Tutorial Datasets == ## The data set for the Freesurfer tutorials comes in two forms, a "Lightweight" version and a "Full" version. |
| Line 11: | Line 10: |
| The troubleshooting tutorials, in the section [wiki:Self:FsTutorial/MorphAndRecon Morphometry and Reconstruction], require the [ftp://surfer.nmr.mgh.harvard.edu/pub/dist/buckner_data-tutorial_subjs.tar.gz buckner_data-tutorial_subjs.tar.gz] download. | ## * The "Lightweight" version contains only the files required to run the commands of the !FreeSurfer tutorial. It has all the required input and output data, but lacks the other files that would normally be present when performing a recon. People who just want a quick easy way to run the commands in the tutorial should download this data set. |
| Line 13: | Line 12: |
| The group study [wiki:Self:FsTutorial/GroupAnalysis analysis] and [wiki:Self:FsTutorial/Visualization visualization] tutorials require the [ftp://surfer.nmr.mgh.harvard.edu/pub/dist/buckner_data-group_study.tar.gz buckner_data-group_study.tar.gz] download. | ## * The "Full" version contains all the files that would normally be present when performing recons. Because of the numerous subjects involved with the tutorials, the full data set is quite large (~60Gigs). People who want to go into more depth than that which is covered in the tutorials should download this data set. |
| Line 15: | Line 14: |
| Once a file is downloaded, move the file to the $FREESURFER_HOME/subjects directory, and uncompress and install with the following command: | ## == Lightweight version == ## Use the following link to download the lightweight version of the tutorial data: ## . [[ftp://surfer.nmr.mgh.harvard.edu/pub/data/tutorial_data.tar.gz|tutorial_data.tar.gz]] ## Once the download is complete, uncompress the data file - this usually this can be done by simply double-clicking. In order to do the tutorials, users must define an environment variable called '''TUTORIAL_DATA''' which is set to the location of the extracted data. For example: ## {{{ ## $> export TUTORIAL_DATA=/home/username/Downloads/tutorial_data ## $> ls $TUTORIAL_DATA ## buckner_data fsfast-functional ## diffusion_recons fsfast-tutorial.subjects ## diffusion_tutorial long-tutorial ## }}} ## You are now ready to start the [[Tutorials|Freesurfer tutorials]]. ## == Full version == The full data for the [[Tutorials|tutorials]] consists of several data sets: * [[ftp://surfer.nmr.mgh.harvard.edu/pub/data/buckner_data-tutorial_subjs.tar.gz|buckner_data-tutorial_subjs.tar.gz]]: the main 'recon-all' stream subject data processing (size: ~16GB uncompressed). * [[ftp://surfer.nmr.mgh.harvard.edu/pub/data/long-tutorial.tar.gz|long-tutorial.tar.gz]]: the longitudinal tutorial (size: ~16GB uncompressed) * [[ftp://surfer.nmr.mgh.harvard.edu/pub/data/fsfast-tutorial.subjects.tar.gz|fsfast-tutorial.subjects.tar.gz]] & [[ftp://surfer.nmr.mgh.harvard.edu/pub/data/fsfast-functional.tar.gz|fsfast-functional.tar.gz]]: the FS-FAST tutorial data set (size: ~5.6GB uncompressed & ~9.1GB uncompressed, respectively) * [[ftp://surfer.nmr.mgh.harvard.edu/pub/data/diffusion_recons.tar.gz|diffusion_recons.tar.gz]] & [[ftp://surfer.nmr.mgh.harvard.edu/pub/data/diffusion_tutorial_v6.tar.gz|diffusion_tutorial.tar.gz]] - the diffusion and Tracula tutorial data sets Also, if you only want to get started with the basics of !FreeSurfer, you need only download the buckner_data set. This will allow you to do the following tutorials: * [[FsTutorial/OutputData_freeview|Intro to FreeSurfer Output]] * [[FsTutorial/TroubleshootingData|Troubleshooting FreeSurfer Output]] * [[FsTutorial/GroupAnalysis|Group Analysis via command-line]] * [[FsTutorial/QdecGroupAnalysis_freeview|Group Analysis via GUI]] * [[FsTutorial/AnatomicalROI|ROI Analysis]] * [[FsTutorial/MultiModal_freeview|Multimodal Analysis]] == Installation == Once the dataset(s) have been downloaded, uncompress and install with the following command run from a terminal window. |
| Line 18: | Line 52: |
| tar xzvf buckner_data-XXXXXX.tar.gz | tar -xzvf <filename>.tar.gz }}} Replacing <filename> with the name of the file downloaded. The downloaded .tar.gz files can then be deleted. == Configuration == In order to do the tutorials, users must define an environment variable called '''TUTORIAL_DATA''' which is set to the root directory containing the extracted data (i.e. the directories 'buckner_data', 'long-tutorial', 'fsfast-functional', etc.). The tutorials make frequent use of the '''TUTORIAL_DATA''' environment variable and it need to be set properly for any of the tutorials to work. For example: {{{ export TUTORIAL_DATA=/home/username/Downloads/tutorial_data ls $TUTORIAL_DATA buckner_data fsfast-functional diffusion_recons fsfast-tutorial.subjects diffusion_tutorial long-tutorial |
| Line 21: | Line 69: |
| where XXXXXX is either '''tutorial_subjs''' or '''group_study'''. | If you see something similar to the above output (you may not have downloaded all the tutorial data sets) you are now ready to start the [[Tutorials|Freesurfer tutorials]]. |
| Line 23: | Line 71: |
| The downloaded file can then be deleted. | ---- |
| Line 25: | Line 73: |
| 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: | == FreeSurfer Tutorial Datasets 5.1/5.3 == |
| Line 27: | Line 75: |
| {{{ source $FREESURFER_HOME/subjects/buckner_data/tutorial_subjs/scripts/setup_subjects.csh }}} |
Below are links to the previous versions of the tutorial dataset that correspond to freesurfer version 5.1 and 5.3: |
| Line 31: | Line 77: |
| 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: {{{ source $FREESURFER_HOME/subjects/buckner_data/group_study/scripts/setup_subjects.csh }}} |
* [[ftp://surfer.nmr.mgh.harvard.edu/pub/data/buckner_data-tutorial_subjs-5.3.tar.gz|buckner_data-tutorial_subjs-5.3.tar.gz]] * [[ftp://surfer.nmr.mgh.harvard.edu/pub/data/long-tutoriaL-5.3.tar.gz|long-tutorial-5.3.tar.gz]] * [[ftp://surfer.nmr.mgh.harvard.edu/pub/data/fsfast-tutorial.subjects-5.3.tar.gz|fsfast-tutorial.subjects-5.3.tar.gz]] & [[ftp://surfer.nmr.mgh.harvard.edu/pub/data/fsfast-functional.tar.gz|fsfast-functional-5.3.tar.gz]] * [[ftp://surfer.nmr.mgh.harvard.edu/pub/data/diffusion_recons-5.3.tar.gz|diffusion_recons-5.3.tar.gz]] & [[ftp://surfer.nmr.mgh.harvard.edu/pub/data/diffusion_tutorial-5.3.tar.gz|diffusion_tutorial-5.3.tar.gz]] |
Index
Contents
FreeSurfer Tutorial Datasets
The full data for the tutorials consists of several data sets:
buckner_data-tutorial_subjs.tar.gz: the main 'recon-all' stream subject data processing (size: ~16GB uncompressed).
long-tutorial.tar.gz: the longitudinal tutorial (size: ~16GB uncompressed)
fsfast-tutorial.subjects.tar.gz & fsfast-functional.tar.gz: the FS-FAST tutorial data set (size: ~5.6GB uncompressed & ~9.1GB uncompressed, respectively)
diffusion_recons.tar.gz & diffusion_tutorial.tar.gz - the diffusion and Tracula tutorial data sets
Also, if you only want to get started with the basics of FreeSurfer, you need only download the buckner_data set. This will allow you to do the following tutorials:
Installation
Once the dataset(s) have been downloaded, uncompress and install with the following command run from a terminal window.
tar -xzvf <filename>.tar.gz
Replacing <filename> with the name of the file downloaded. The downloaded .tar.gz files can then be deleted.
Configuration
In order to do the tutorials, users must define an environment variable called TUTORIAL_DATA which is set to the root directory containing the extracted data (i.e. the directories 'buckner_data', 'long-tutorial', 'fsfast-functional', etc.). The tutorials make frequent use of the TUTORIAL_DATA environment variable and it need to be set properly for any of the tutorials to work. For example:
export TUTORIAL_DATA=/home/username/Downloads/tutorial_data ls $TUTORIAL_DATA buckner_data fsfast-functional diffusion_recons fsfast-tutorial.subjects diffusion_tutorial long-tutorial
If you see something similar to the above output (you may not have downloaded all the tutorial data sets) you are now ready to start the Freesurfer tutorials.
FreeSurfer Tutorial Datasets 5.1/5.3
Below are links to the previous versions of the tutorial dataset that correspond to freesurfer version 5.1 and 5.3: