Differences between revisions 1 and 20 (spanning 19 versions)
Revision 1 as of 2020-03-12 17:13:37
Size: 708
Editor: LeahMorgan
Comment:
Revision 20 as of 2020-03-12 19:23:56
Size: 10571
Editor: LeahMorgan
Comment:
Deletions are marked like this. Additions are marked like this.
Line 14: Line 14:
 * LeahMorgan
= Upcoming FreeSurfer courses =
If you would like to be notified about upcoming !FreeSurfer courses, sign up for the [[http://surfer.nmr.mgh.harvard.edu/cgi-bin/fsurfer/interest.cgi|course mailing list.]]. We host two Boston courses each year, typically in the first week of April and the last week of September.<<BR>>

== Suggested Steps for Conducting an at-home FreeSurfer Course ==

=== Step 1: Download FreeSurfer For your Computer ===

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

=== Step 2: Download the tutorial data ===

Download the tutorial data [[FsTutorial/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) ===

||'''Subject''' ||'''Talk''' ||'''Slides''' ||'''Relevant Tutorials''' ||
|| ==== Day 1: Intro to FreeSurfer and Working with the Individual Subject ==== || || ||
|| Intro to Linux for !FreeSurfer Users || [[https://www.youtube.com/watch?v=6eJMxh7PlOY| YouTube Presentation]] || *Slides || [[https://surfer.nmr.mgh.harvard.edu/fswiki/UnixTutorial|Tutorial]] ||
|| Intro to FreeSurfer Jargon || [[https://www.youtube.com/watch?v=GywOKtfKZIU| YouTube Presentation]] || [[http://surfer.nmr.mgh.harvard.edu/pub/docs/fsjargon_clean.pptx|Slides]] || N/A ||
|| Intro to FreeSurfer Software || [[https://www.youtube.com/watch?v=eZcIHXXq_Uc&t=1452s| YouTube Presentation ]] || [[attachment:freesurfer.intro.apr.2019.ppt| Slides ]] || N/A ||
|| Analyzing the Individual Subject || [[ https://www.youtube.com/watch?v=8Ict0Erh7_c&t=1501s | YouTube Presentation Part 1]], [[ https://www.youtube.com/watch?v=KncPouQWAp0&t=1522s | YouTube Presentation Part 2]] || [[http://surfer.nmr.mgh.harvard.edu/pub/docs/fsrecon.pptx| Slides ]] || N/A ||
|| Intro to Freeview and the FreeSurfer Output || [[https://www.youtube.com/watch?v=Mv-ECowxq2o|Freeview demonstration]] || N/A || [[FsTutorial/OutputData_freeview|Introduction to FreeSurfer Output Tutorial]], [[FsTutorial/Practice|Practice Working with Data]] ||
|| ROI Analysis || [[https://www.youtube.com/watch?v=n5QkCwZZPko&t=294s | YouTube Presentation]] || [[http://surfer.nmr.mgh.harvard.edu/pub/docs/fs.roi.EB_wiki.pptx| Slides]] || [[FsTutorial/AnatomicalROIV6.0|ROI Analysis Tutorial]] ||
|| Bonus Talks: [[https://www.youtube.com/watch?v=SwsH64PBBZE|Intro to MRI Presentation]],[[http://surfer.nmr.mgh.harvard.edu/pub/docs/IntroMRI.pptx|Intro to MR Slides]], [[https://www.youtube.com/watch?v=aZfy8gsPxZE| MRI Aquisition Techniques for Morphometry]], [[http://surfer.nmr.mgh.harvard.edu/pub/docs/FreeSurfer_Acquisition_Sep2019.ppt|MRI Acquisition Methods Slides]] || || ||
||==== Day 2: More Structural Processing and Troubleshooting ====|| || || ||
|| Troubleshooting || [[ https://www.youtube.com/watch?v=gf0BC0xs0tM | YouTube Presentation ]], [[https://www.youtube.com/watch?v=AR83_Bt04VQ| Demo]] || [[http://surfer.nmr.mgh.harvard.edu/pub/docs/freesurfer.troubleshooting.apr2019.ppt|FreeSurfer Troubleshooting]] || [[FsTutorial/TroubleshootingDataV6.0|Troubleshooting Tutorial]] ||
|| Longitudinal Analysis || [[ https://www.youtube.com/watch?v=vxJODPBLd3M&t=147s| YouTube Presentation ]] || [[http://surfer.nmr.mgh.harvard.edu/pub/docs/fs.longitudinal.pptx|Longitudinal FreeSurfer]] || [[FsTutorial/LongitudinalTutorial|LongitudinalTutorial]] ||
|| An Overview of Registration Methods || [[https://www.youtube.com/watch?v=DQOmdLpf82k&t=834s| YouTube Presentation ]] || [[http://surfer.nmr.mgh.harvard.edu/pub/docs/fs.registration.ppt|An Overview of Registration Methods]] || N/A ||
||==== Day 3: Group Analysis and Statistics ====|| || || ||
|| Surface-based analysis: Intersubject Registration & Smoothing || [[https://www.youtube.com/watch?v=8WPvXoORoAw&t=23s| YouTube Presentation]] ||[[http://surfer.nmr.mgh.harvard.edu/pub/docs/fs.surface-based-analysis.ppt |Slides]] || N/A ||
|| Group Analysis || [[https://www.youtube.com/watch?v=EJewud8obuo&t=10s| Video 1]], [[https://www.youtube.com/watch?v=9111bn-XVsA&t=22s|Video 2]] || [[http://surfer.nmr.mgh.harvard.edu/pub/docs/GLM.pptx|Group Analysis]] || [[FsTutorial/GroupAnalysisV6.0|Group Analysis Tutorial]] ||
|| Multiple Comparisons || [[ https://www.youtube.com/watch?v=s87--3yG6mU&t=1114s| YouTube Presentation]] || [[http://surfer.nmr.mgh.harvard.edu/pub/docs/multiplecomparisons.ppt|Multiple Comparisons Slides]] || [[FsTutorial/MultipleComparisonsV6.0Perm|Multiple Comparisons Tutorial]] ||
||==== Day 4: Multimodal Analysis / Diffusion Analysis ====|| || ||
|| Intro to Diffusion || [[https://www.youtube.com/watch?v=BKjBdeWYllk&t=66s| Part 1]], [[https://www.youtube.com/watch?v=efsxszjPmpc&t=42s|Part 2]]|| [[http://surfer.nmr.mgh.harvard.edu/pub/docs/dmri,fs.ppt|Introduction to Diffusion MRI]] || [[FsTutorial/DiffusionV6.0|Diffusion Processing Tutorial]] ||
|| Multi-Modal Integration || [[https://www.youtube.com/watch?v=gRl6bYF06hg| Part 1]], [[https://www.youtube.com/watch?v=2vPjMBYMM0E&t=1s | Part 2 ]] || [[http://surfer.nmr.mgh.harvard.edu/pub/docs/fs.multimodal1_2018.pptx|Multi-Modal Integration, Part 1: Registration]], [[http://surfer.nmr.mgh.harvard.edu/pub/docs/fs.multimodal-integration.Part2.pptx|Multi-Modal Integration, Part 2: Group Analysis]] || [[MultiModalTutorialV6.0|Multi-Modal Integration Tutorial, Part 1]] ,[[MultiModalTutorialV6.0|Multi-Modal Integration Tutorial, Part 2]] ||
|| Tracts Constrained by Underlying Anatomy (TRACULA) || [[https://www.youtube.com/watch?v=LpdYbe4pJK0&t=79s| Part 1]], [[https://www.youtube.com/watch?v=BvTi7B4rneU| Part 2]] || [[http://surfer.nmr.mgh.harvard.edu/pub/docs/tracula,fs.ppt|Slides]] || [[FsTutorial/Tracula|TRACULA Tutorial]] ||tutorial ||
||Bonus Talks and Slides: [[http://surfer.nmr.mgh.harvard.edu/pub/docs/tracula,fs.ppt|Longitudinal TRACULA]]|| || || ||
||==== Day 5: fMRI Analysis and FSFAST ====|| || || ||
|| Basics of fMRI || [[https://www.youtube.com/watch?v=cAkdey4SH7o&t=138s| Intro to fMRI Talk]] || [[http://surfer.nmr.mgh.harvard.edu/pub/docs/fMRI_intro2018.ppt|Slides]]
|| Resting State fMRI || [[https://www.youtube.com/watch?v=DavxePlS94w&t=7s| Resting State fMRI Presentation ]] || [[http://surfer.nmr.mgh.harvard.edu/pub/docs/resting-state.fmri.ppt|Resting State fMRI Slides]] || N/A ||
|| FSFAST || [[https://www.youtube.com/watch?v=Q1RoThGmuxk| FSFAST Presentation]] || [[http://surfer.nmr.mgh.harvard.edu/pub/docs/fsfast.ppt|FSFAST, Part 1: Preprocessing]], [[http://surfer.nmr.mgh.harvard.edu/pub/docs/fsfast.ppt|FSFAST, Part 2: GLM Analysis]] || [[FsFastTutorialV6.0|FSFAST Tutorial, Part 1]], [[FsFastTutorialV6.0|FSFAST Tutorial, Part 2]] ||
||Bonus Talks and Slides: [[http://surfer.nmr.mgh.harvard.edu/pub/docs/freesurfer-struct-func04022018-handoutb.pdf| Structural & Functional Data Integration]]|| || || ||

=== Getting the Help and Support you need ===
For questions related to your own data processing and for troubleshooting help, please contact the FreeSurfer mailing list: freesurfer@nmr.mgh.harvard.edu and attach your recon-all.log file to your email.<<BR>>

For tutorial-specific questions, over the next two weeks (March 23 - April 3rd) our FreeSurfer tutorial support team will be extra available to set up video chats or answer your questions over email. Feel free to email the addresses on the list below for help:<<BR>>

mlarrabee1@mgh.harvard.edu, dccordero@mgh.harvard.edu, mvera2@mgh.harvard.edu, lmorgan6@mgh.harvard.edu, brd15@mgh.harvard.edu

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)

Subject

Talk

Slides

Relevant Tutorials

==== Day 1: Intro to FreeSurfer and Working with the Individual Subject ====

Intro to Linux for FreeSurfer Users

YouTube Presentation

*Slides

Tutorial

Intro to FreeSurfer Jargon

YouTube Presentation

Slides

N/A

Intro to FreeSurfer Software

YouTube Presentation

Slides

N/A

Analyzing the Individual Subject

YouTube Presentation Part 1, YouTube Presentation Part 2

Slides

N/A

Intro to Freeview and the FreeSurfer Output

Freeview demonstration

N/A

Introduction to FreeSurfer Output Tutorial, Practice Working with Data

ROI Analysis

YouTube Presentation

Slides

ROI Analysis Tutorial

Bonus Talks: Intro to MRI Presentation,Intro to MR Slides, MRI Aquisition Techniques for Morphometry, MRI Acquisition Methods Slides

==== Day 2: More Structural Processing and Troubleshooting ====

Troubleshooting

YouTube Presentation, Demo

FreeSurfer Troubleshooting

Troubleshooting Tutorial

Longitudinal Analysis

YouTube Presentation

Longitudinal FreeSurfer

LongitudinalTutorial

An Overview of Registration Methods

YouTube Presentation

An Overview of Registration Methods

N/A

==== Day 3: Group Analysis and Statistics ====

Surface-based analysis: Intersubject Registration & Smoothing

YouTube Presentation

Slides

N/A

Group Analysis

Video 1, Video 2

Group Analysis

Group Analysis Tutorial

Multiple Comparisons

YouTube Presentation

Multiple Comparisons Slides

Multiple Comparisons Tutorial

==== Day 4: Multimodal Analysis / Diffusion Analysis ====

Intro to Diffusion

Part 1, Part 2

Introduction to Diffusion MRI

Diffusion Processing Tutorial

|| Multi-Modal Integration || Part 1, Part 2 || Multi-Modal Integration, Part 1: Registration, Multi-Modal Integration, Part 2: Group Analysis || Multi-Modal Integration Tutorial, Part 1 ,Multi-Modal Integration Tutorial, Part 2 ||

Tracts Constrained by Underlying Anatomy (TRACULA)

Part 1, Part 2

Slides

TRACULA Tutorial

tutorial

Bonus Talks and Slides: Longitudinal TRACULA

==== Day 5: fMRI Analysis and FSFAST ====

|| Basics of fMRI || Intro to fMRI Talk || Slides

Resting State fMRI

Resting State fMRI Presentation

Resting State fMRI Slides

N/A

FSFAST

FSFAST Presentation

FSFAST, Part 1: Preprocessing, FSFAST, Part 2: GLM Analysis

FSFAST Tutorial, Part 1, FSFAST Tutorial, Part 2

Bonus Talks and Slides: Structural & Functional Data Integration

Getting the Help and Support you need

For questions related to your own data processing and for troubleshooting help, please contact the FreeSurfer mailing list: freesurfer@nmr.mgh.harvard.edu and attach your recon-all.log file to your email.

For tutorial-specific questions, over the next two weeks (March 23 - April 3rd) our FreeSurfer tutorial support team will be extra available to set up video chats or answer your questions over email. Feel free to email the addresses on the list below for help:

mlarrabee1@mgh.harvard.edu, dccordero@mgh.harvard.edu, mvera2@mgh.harvard.edu, lmorgan6@mgh.harvard.edu, brd15@mgh.harvard.edu

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