Free Surfer Troubleshooting surfer nmr mgh harvard edu

  • Slides: 31
Download presentation
Free. Surfer: Troubleshooting surfer. nmr. mgh. harvard. edu

Free. Surfer: Troubleshooting surfer. nmr. mgh. harvard. edu

MR Anatomy Caveats Surfaces are only as good as your scan. • Dependent on

MR Anatomy Caveats Surfaces are only as good as your scan. • Dependent on data quality – Contrast to noise – Signal to noise – Voxel resolution • MR Artifacts – MR susceptibility – MR distortions • Variations in MR tissue parameters across regions of the brain are altered in different populations

Suggested Morphometry Sequences http: //www. nmr. mgh. harvard. edu/~andre/

Suggested Morphometry Sequences http: //www. nmr. mgh. harvard. edu/~andre/

Processing Errors recon-all fails • check recon-all. log • try to rerun step that

Processing Errors recon-all fails • check recon-all. log • try to rerun step that failed • look at volume from last successful step • examine data quality to see what might cause error • search Free. Surfer mailing list for other instances of this problem: http: //www. mail-archive. com/[email protected] mgh. harvard. edu/ • if it fails again, attempt to run modified version of command if possible • email the mailing list if still need help

Free. Surfer Directory Tree Each data set has its own unique Subject. Id (eg,

Free. Surfer Directory Tree Each data set has its own unique Subject. Id (eg, bert) bert bem stats src mri scripts surf Subject ID tmp label recon-all. log recon-all-status. log

Report Errors • Report version currently using – see top of recon-all. log –

Report Errors • Report version currently using – see top of recon-all. log – more $FREESURFER_HOME/build-stamp. txt • • command line tried to run attach recon-all. log Output in terminal window if appropriate Operating System

Check Your Recon for Accuracy • Do your surfaces follow gm/wm borders? • Does

Check Your Recon for Accuracy • Do your surfaces follow gm/wm borders? • Does the subcortical segmentation follow intensity boundaries?

Output of Cortical Surface Reconstruction

Output of Cortical Surface Reconstruction

Typical Errors • • • Pial Surface misplacement Skull Strip Errors WM Segmentation Errors

Typical Errors • • • Pial Surface misplacement Skull Strip Errors WM Segmentation Errors Intensity Normalization Errors Topological Defect

Pial Surface Misplacement Dura or Blood Vessel White/Gray OK, but Pial Inaccurate Dura and

Pial Surface Misplacement Dura or Blood Vessel White/Gray OK, but Pial Inaccurate Dura and GM have extremely similar intensity characteristics on most T 1 -weighted sequences (but different T 2*!). Typical fix: edit the brainmask. mgz to erase dura/blood vessels, and run: recon-all -s <subject> -autorecon-pial

New Morphometry Protocol: Identifying Dura with Multi-echo MP-RAGE *joint work with Andre van der

New Morphometry Protocol: Identifying Dura with Multi-echo MP-RAGE *joint work with Andre van der Kouwe

Skull Strip Error orig. mgz brainmask. mgz Use “clone” tool to manually correct, or

Skull Strip Error orig. mgz brainmask. mgz Use “clone” tool to manually correct, or adjust watershed parameters and run (default wsthresh is 25, higher means strip less): recon-all -skullstrip -wsthresh 35 -clean-bm -no-wsgcaatlas -s <subj> recon-all -autorecon 2 -autorecon 3 -s <subj>

Troubleshooting: Skull Strip orig. mgz brainmask. mgz Or try gcut (be sure to check

Troubleshooting: Skull Strip orig. mgz brainmask. mgz Or try gcut (be sure to check didn’t take too much!!): recon-all -skullstrip -clean-bm -gcut -s <subj> recon-all -autorecon 2 -autorecon 3 -s <subj>

WM Segmentation Error “Hypo-Intensities” White Matter Lesions Misclassified as gray matter Fill in wm.

WM Segmentation Error “Hypo-Intensities” White Matter Lesions Misclassified as gray matter Fill in wm. mgz then run: recon-all -s <subject> -autorecon 2 -wm -autorecon 3

WM Segmentation Error Eye Socket classified as WM due to Skull Strip Failure. Erase

WM Segmentation Error Eye Socket classified as WM due to Skull Strip Failure. Erase in wm. mgz then run: recon-all -s <subject> -autorecon 2 -wm -autorecon 3

Intensity Normalization Error Intensity Normalization Failure. Most WM in T 1 volume (T 1.

Intensity Normalization Error Intensity Normalization Failure. Most WM in T 1 volume (T 1. mgz) should be close to 110. Can fix by adding “Control Points” to interior of wm. Beware partial voluming! recon-all -s <subject> -autorecon 2 -cp -autorecon 3

Topology Fixer Error Fornix hippocampus Pallidum and Putamen • Holes • Handles • Automatically

Topology Fixer Error Fornix hippocampus Pallidum and Putamen • Holes • Handles • Automatically Fixed Cortical Defects Ventricles and Caudate

Topology Fixer Error White Matter “disconnects” orig. nofix will be accurate Add in wm.

Topology Fixer Error White Matter “disconnects” orig. nofix will be accurate Add in wm. mgz then run: recon-all -s <subject> -autorecon 2 -wm -autorecon 3

What are the Common Interventions? • Manually edit the wm. mgz to change incorrectly

What are the Common Interventions? • Manually edit the wm. mgz to change incorrectly labeled voxels (only for small errors). • Manually edit the brainmask. mgz to erase dura/vasculature. • Adjust watershed parameters or use –gcut to fix largescale skull-strip errors. – Manually erase/clone regions of remaining skull on brainmask. mgz • Control Points – add locations that are in the interior of the white matter and <110 to bring regional wm intensity up. Use norm. mgz as guide. • Use tkregister 2 to fix incorrect talairach. xfm

How Know What to Edit? • If pial surface includes too much: • edit

How Know What to Edit? • If pial surface includes too much: • edit brainmask. mgz • If it affects the white surface (too much/little) or If pial surface includes too little: edit the wm. mgz (if segmentation error) • add control points (if normalization error) •

Must rerun to fix errors recon-all -autorecon 2 -autorecon 3 (Stages 6+) Skull strip

Must rerun to fix errors recon-all -autorecon 2 -autorecon 3 (Stages 6+) Skull strip error (after fixed watershed/cloned) recon-all -autorecon 2 -cp -autorecon 3 (Stages 10+) Added control points recon-all -autorecon 2 -wm -autorecon 3 (Stages 13+) Edited wm. mgz recon-all -autorecon-pial (Stage 19+) Edited brainmask. mgz

Processing Stream Order http: //surfer. nmr. mgh. harvard. edu/fswiki/Recon. All. Dev. Table

Processing Stream Order http: //surfer. nmr. mgh. harvard. edu/fswiki/Recon. All. Dev. Table

Or Make Life Easier recon-all -make all -s subjid

Or Make Life Easier recon-all -make all -s subjid

Troubleshooting – Advice CONTEXT AMBIGUITY CONSISTENCY SPEED

Troubleshooting – Advice CONTEXT AMBIGUITY CONSISTENCY SPEED

Troubleshooting – Advice CONTEXT • Always look at the data in multiple views and

Troubleshooting – Advice CONTEXT • Always look at the data in multiple views and scroll back and forth a few slices – 3 D structure is difficult to discern! AMBIGUITY CONSISTENCY SPEED

Troubleshooting – Advice CONTEXT • Always look at the data in multiple views and

Troubleshooting – Advice CONTEXT • Always look at the data in multiple views and scroll back and forth a few slices – 3 D structure is difficult to discern! AMBIGUITY • Don’t edit too much! This will reduce reliability while only moderately increasing accuracy and is almost never needed. If unsure, leave it. • Even one or two missing voxels can cause large-scale defects, so very minor editing (e. g. filling in white matter voxels that are holes, or erasing handles) may fix the problem. CONSISTENCY SPEED

Troubleshooting – Advice CONTEXT • Always look at the data in multiple views and

Troubleshooting – Advice CONTEXT • Always look at the data in multiple views and scroll back and forth a few slices – 3 D structure is difficult to discern! AMBIGUITY • Don’t edit too much! This will reduce reliability and is almost never needed. If unsure, leave it. • Even one or two missing voxels can cause large-scale defects, so very minor editing (e. g. filling in white matter voxels that are holes, or erasing handles) may fix the problem. CONSISTENCY • Edit consistently within and across subjects. SPEED

Troubleshooting – Advice CONTEXT • Always look at the data in multiple views and

Troubleshooting – Advice CONTEXT • Always look at the data in multiple views and scroll back and forth a few slices – 3 D structure is difficult to discern! AMBIGUITY • Don’t edit too much! This will reduce reliability and is almost never needed. If unsure, leave it. • Even one or two missing voxels can cause large-scale defects, so very minor editing (e. g. filling in white matter voxels that are holes, or erasing handles) may fix the problem. CONSISTENCY • Edit consistently within and across subjects. SPEED • You will get faster with time; certain sections go faster.

Start Over recon-all -clean -s subjid

Start Over recon-all -clean -s subjid

Tutorial Tips • DO NOT open tkmedit & tksurfer from the same terminal window.

Tutorial Tips • DO NOT open tkmedit & tksurfer from the same terminal window. (Use two terminal windows) • You CANNOT type commands in a terminal window if you are running tkmedit or tksurfer from it. (Open a new terminal window to do this. )

See Edits Made recon-all –show-edits -s subjid

See Edits Made recon-all –show-edits -s subjid