Differences between revisions 2 and 6 (spanning 4 versions)
Revision 2 as of 2020-03-12 17:23:22
Size: 1329
Editor: LeahMorgan
Comment:
Revision 6 as of 2020-03-12 18:02:10
Size: 3903
Editor: LeahMorgan
Comment:
Deletions are marked like this. Additions are marked like this.
Line 18: Line 18:
== Suggested Steps for Conducting an at-home FreeSurfer Course== == Suggested Steps for Conducting an at-home FreeSurfer Course ==
Line 20: Line 20:
= Step 1: Download FreeSurfer For your Computer = === Step 1: Download FreeSurfer For your Computer ===
Line 22: Line 22:
= Step 2: Download the tutorial data = Follow the instructions on [[ DownloadAndInstall| this page]] to get FreeSurfer on your personal computer. We highly recommend downloading the standalone Dev version of Freeview to replace the Freeview application in the FreeSurfer v6.0 download package due to incompatabilites with newer operating systems (especially if you have a mac).
Line 24: Line 24:
= Step 3: test your FreeSurfer Install and Tutorial Data = === Step 2: Download the tutorial data ===
Line 26: Line 26:
= Step 4: Suggested Schedule (5 days) = Download the tutorial data [[FsTutorial/Data|here]] (~ 8GB).
Line 28: Line 28:
= Getting the Help and Support you need = === Step 3: test your FreeSurfer Install and Tutorial Data ===

These are some instructions written by Paul Wighton on how to run a script that will test some of the FreeSurfer tutorial commands on your laptop and ensure your install is working well enough to attempt the tutorials for the course.
{{{
FreeSurfer 6 can be downloaded from here: https://surfer.nmr.mgh.harvard.edu/pub/dist/freesurfer/6.0.0/freesurfer-Linux-centos6_x86_64-stable-pub-v6.0.0.tar.gz
More insallation instructions can be found here: https://surfer.nmr.mgh.harvard.edu/fswiki/DownloadAndInstall
The tutorial data can be downloaded from here: https://surfer.nmr.mgh.harvard.edu/pub/data/tutorial_data.tar.gz

On my machine, I stored the downloaded `tar.gz` files in a directory called `/home/paul/lcn/data/fs-course-20200310`. After extracting the archives I have the following subdirectories in `/home/paul/lcn/data/fs-course-20200310`
- `freesurfer`
- `tutorial_data_20190918_1558`

Next, edit the file `bashrc` in the `tutorial_data_20190918_1558` directory. (In my case, the full path of that file is `/home/paul/lcn/data/fs-course-20200310/tutorial_data_20190918_1558/bashrc`) and change lines 16 and 19 to match the location of freesurfer and the tutorial data on your machine.

In my case, I edited the lines to read:
- Line 16: `export TUTORIAL_DATA=/home/paul/lcn/data/fs-course-20200310/tutorial_data_20190918_1558`
- Line 19: `export FREESURFER_HOME=/home/paul/lcn/data/fs-course-20200310/freesurfer`

Next, change into the tutorial data directory:

```
cd /home/paul/lcn/data/fs-course-20200310/tutorial_data_20190918_1558
```

and test the installation by running:
```
source bashrc
test_commands.sh.15
```

This may take a while (30 minutes to an hour) and the script will constantly "steal focus" so you will not be able to use your machine while the tests are running.

If at some point, you see:
```
mean.practice.table (END)
```

Hit `q` so the script can continue (I had to do this twice)

When you see `colortable with 14176 entries read (originally /autofs/cluster/freesurfer/centos7_x86_64/stable6/FreeSurferColorLUT.txt)` you can hit enter and the script will end.
}}}

=== Step 4: Suggested Schedule (5 days) ===

=== Getting the Help and Support you need ===

Upcoming FreeSurfer courses

If you would like to be notified about upcoming FreeSurfer courses, sign up for the course mailing list.. We host two Boston courses each year, typically in the first week of April and the last week of September.

Suggested Steps for Conducting an at-home FreeSurfer Course

Step 1: Download FreeSurfer For your Computer

Follow the instructions on this page to get FreeSurfer on your personal computer. We highly recommend downloading the standalone Dev version of Freeview to replace the Freeview application in the FreeSurfer v6.0 download package due to incompatabilites with newer operating systems (especially if you have a mac).

Step 2: Download the tutorial data

Download the tutorial data here (~ 8GB).

Step 3: test your FreeSurfer Install and Tutorial Data

These are some instructions written by Paul Wighton on how to run a script that will test some of the FreeSurfer tutorial commands on your laptop and ensure your install is working well enough to attempt the tutorials for the course.

FreeSurfer 6 can be downloaded from here: https://surfer.nmr.mgh.harvard.edu/pub/dist/freesurfer/6.0.0/freesurfer-Linux-centos6_x86_64-stable-pub-v6.0.0.tar.gz
More insallation instructions can be found here: https://surfer.nmr.mgh.harvard.edu/fswiki/DownloadAndInstall
The tutorial data can be downloaded from here: https://surfer.nmr.mgh.harvard.edu/pub/data/tutorial_data.tar.gz

On my machine, I stored the downloaded `tar.gz` files in a directory called `/home/paul/lcn/data/fs-course-20200310`.  After extracting the archives I have the following subdirectories in `/home/paul/lcn/data/fs-course-20200310`
- `freesurfer`
- `tutorial_data_20190918_1558`

Next, edit the file `bashrc` in the `tutorial_data_20190918_1558` directory.  (In my case, the full path of that file is `/home/paul/lcn/data/fs-course-20200310/tutorial_data_20190918_1558/bashrc`) and change lines 16 and 19 to match the location of freesurfer and the tutorial data on your machine.

In my case, I edited the lines to read:
- Line 16: `export TUTORIAL_DATA=/home/paul/lcn/data/fs-course-20200310/tutorial_data_20190918_1558`
- Line 19: `export FREESURFER_HOME=/home/paul/lcn/data/fs-course-20200310/freesurfer`

Next, change into the tutorial data directory:

```
cd /home/paul/lcn/data/fs-course-20200310/tutorial_data_20190918_1558
```

and test the installation by running:
```
source bashrc
test_commands.sh.15
```

This may take a while (30 minutes to an hour) and the script will constantly "steal focus" so you will not be able to use your machine while the tests are running.

If at some point, you see:
```
mean.practice.table (END)
```

Hit `q` so the script can continue (I had to do this twice)

When you see `colortable with 14176 entries read (originally /autofs/cluster/freesurfer/centos7_x86_64/stable6/FreeSurferColorLUT.txt)` you can hit enter and the script will end.

Step 4: Suggested Schedule (5 days)

Getting the Help and Support you need

TeachYourselfFreeSurfer (last edited 2022-11-28 14:31:16 by LiamrSennott)