Differences between revisions 14 and 43 (spanning 29 versions)
Revision 14 as of 2011-03-18 12:56:20
Size: 3452
Editor: KhoaNguyen
Comment:
Revision 43 as of 2013-04-23 17:02:37
Size: 4392
Editor: MartinReuter
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
[[FsTutorial|top]] | [[FsTutorial/LongitudinalTutorial|previous]] [[FsTutorial|top]] | [[FsTutorial/LongitudinalTutorial|Longitudinal Tutorial]]
Line 4: Line 4:
*To follow this exercise exactly be sure you've downloaded the [[FsTutorial/Data|tutorial data set]] before you begin. If you choose not to download the data set you can follow these instructions on your own data, but you will have to substitute your own specific paths and subject names.  *To follow this exercise exactly be sure you've downloaded the [[FsTutorial/Data|tutorial data set]] before you begin. If you choose not to download the data set you can follow these instructions on your own data, but you will have to substitute your own specific paths and subject names.
Line 6: Line 6:
As you can see, the skull strip for this subject is very poor for both timepoints MR1 and MR2, therefore affecting the results of the base and the longitudinals downstream. As you probably noticed, the skullstrip only failed at the first timepoint for this subject, OAS2_0088_MR1. There are quite a lot of skull left behind and that adversely affected the surfaces and the aseg. The image below is taken at slice 90. <<BR>>
{{attachment:0088_tp1_90_before.jpg}}
Line 8: Line 9:
If you look at the coronal slice 158 for OAS2_0004_MR1_before, you can see that the entire neck is still present. If you scroll down to slice 45, you can see that part of the right hemisphere is missing, but is present in T1.mgz. Although the surfaces and the aseg look pretty bad for this timepoint, the surfaces in the base are correct, therefore the surfaces in the long is also correct (since surfaces are copied from the base to the long). However, notice that in OAS2_0088_MR1.long.OAS2_0088, the aseg for the cerebellum is still overlabeling to the dura. Image below at slice 100. <<BR>>
{{attachment:0088_long1_100_before.jpg}}
Line 10: Line 12:
{{/fswiki/FsTutorial/LongSkullStripFix?action=AttachFile&do=get&target=OAS2_0004_MR1_before|OAS2_0004_MR1_before|type="application/octet-stream",title=""}} It is then good to correct this problem. You can simply correct this by adjusting the watershed parameter for timepoint 1. Because the default threshold is always 25, to remove more skull, we need to decrease it. This should only take a couple minutes to complete, so feel free to run the command.
{{{
recon-all -subjid OAS2_0088_MR1 -skullstrip -wsthresh 20 -clean-bm -no-wsgcaatlas
}}}
----
Line 12: Line 18:
The similar thing happened to OAS2_0004_MR2_before. At slice 170, a large part of the brain is missing while the neck is still present.

The best way to fix a problem like this is to adjust the watershed parameters. This can only be done on the cross-sectionals, and you can use the edited cross-sectionals to recreate the base and the longitudinals afterward.

First, adjust the watershed parameters for both MR1 and MR2 using the following command.
If you ran the commands, take a look at your output volumes (directory w/o _fixed), or simply check our edited volumes, and verify that the result of the new skull stripping is correct:
Line 19: Line 21:
recon-all -skullstrip -wsthresh 20 -clean-bm -no-wsgcaatlas -subjid OAS2_0004_MR1_before
and
recon-all -skullstrip -wsthresh 20 -clean-bm -no-wsgcaatlas -subjid OAS2_0004_MR2_before
tkmedit OAS2_0088_MR1_fixed brainmask.mgz -aux T1.mgz -surfs
}}}

After you are satisfied with the results, remember to run the rest of the cross sectional recon-all steps. Notice that although the extra skull is stripped off, the surfaces and the aseg are still incorrect, you'll need to run the following command in order to recreate the surfaces and the aseg. (This step will take very long so you don't need to run it for this tutorial.)

{{{
recon-all -subjid OAS2_0088_MR1 -autorecon2 -autorecon3
}}}

To save time, you can check in with the recon-all-status.log in the scripts directory of these subjects to see if the normalization step is complete. Or you can wait until the entire recon is done to check whether the surfaces and aseg are updated. They should. To check the corrected version:
{{{
tkmedit OAS2_0088_MR1_fixed brainmask.mgz -aux T1.mgz -surfs
}}}

Notice the major improvement on the same slice 90 for OAS2_0088_MR1. <<BR>>
{{attachment:0088_tp1_90_after.jpg}}

Once that step is complete, you can start recreating your base (remove/rename the base dir if it existed, e.g. {{{mv OAS2_0088 OAS2_0088_old}}}, before running this). To recreate the base using the newly created timepoint(s), use the following command:
{{{
recon-all -base OAS2_0088 -tp OAS2_0088_MR1 -tp OAS2_0088_MR2 -all
}}}

Then, the final step is to recreate the longitudinals once base and cross sectional runs are complete:
{{{
recon-all -long OAS2_0088_MR1 OAS2_0088 -all
recon-all -long OAS2_0088_MR2 OAS2_0000 -all
}}}

**NOTE: When recreating the base and longitudinals, it is recommended to remove or rename the existing base and longitudinal directories and start those processes from scratch, if possible, e.g. {{{mv OAS2_0004 OAS2_0004_old}}}.

You can examine the corrected version of the base and longitudinals by using the following commands in separate terminals.

{{{
tkmedit OAS2_0088_fixed brainmask.mgz -aux T1.mgz -surfs
tkmedit OAS2_0088_MR1.long.OAS2_0088_fixed brainmask.mgz -aux T1.mgz -surfs
tkmedit OAS2_0088_MR2.long.OAS2_0088_fixed brainmask.mgz -aux T1.mgz -surfs
Line 24: Line 59:
Take a look at your output volume (brainmask.mgz has been changed) along with the original T1 volume (T1.mgz), and verify the result of the new skull stripping is correct.
Line 26: Line 60:
{{{
tkmedit OAS2_0004_MR1_before brainmask.mgz -aux T1.mgz -surfs
tkmedit OAS2_0004_MR2_before brainmask.mgz -aux T1.mgz -surfs
}}}
----
The output for both should look like this:

<insert pictures>
You should not notice any changes to the base and the long for timepoint 2, however there is an improvement on the aseg for the long of timepoint 1. Here is the same slice 100 as shown above. <<BR>>
{{attachment:0088_long1_100_after.jpg}}
Line 36: Line 64:
After you are satisfied with the results, remember to run the rest of the recon-all steps for all timepoints that you made an adjustment to. Now that was a fairly simple case, if you are still up for it, click [[FsTutorial/LongSkullStripFix2|here]] for a bigger challenge.
Line 38: Line 66:
{{{
recon-all -autorecon2 -autorecon3 -subjid OAS2_0004_MR1_before
recon-all -autorecon2 -autorecon3 -subjid OAS2_0004_MR2_before
}}}
Line 43: Line 67:
To save time, you can check in with the recon-all-status.log in the scripts directory of these subjects to see if the normalization step is complete. Once that step is complete, you can start recreating your base.

{{{
recon-all -base OAS2_0004 -tp OAS2_0004_MR1_before -tp OAS2_0004_MR2_before -all
}}}
----
Then, the final step is to recreate the longitudinals.

{{{
recon-all -long OAS2_0004_MR1_before OAS2_0004 -all
recon-all -long OAS2_0004_MR2_before OAS2_0004 -all
}}}
----
**NOTE: When recreating the base and longitudinals, it is better if you remove the existing base and longitudinal directories or rename them to something else and remove them.

You can examine the corrected version of base and longitudinals by using the following commands in separate terminals.

{{{
tkmedit OAS2_0004 brainmask.mgz -aux T1.mgz -surfs
tkmedit OAS2_0004_MR1.long.OAS2_0004 brainmask.mgz -aux T1.mgz -surfs
tkmedit OAS2_0004_MR2.long.OAS2_0004 brainmask.mgz -aux T1.mgz -surfs
}}}
----
This is only one example of a skull strip error, for more details on this type of error, you can read about it [[FsTutorial/SkullStripFix|here]].
For more details on skull strip errors and the different ways to fix them, refer back to the [[FsTutorial/SkullStripFix|Troubleshooting Skull Strip Tutorial]].

top | Longitudinal Tutorial

Fixing a bad skull strip

  • To follow this exercise exactly be sure you've downloaded the tutorial data set before you begin. If you choose not to download the data set you can follow these instructions on your own data, but you will have to substitute your own specific paths and subject names.

As you probably noticed, the skullstrip only failed at the first timepoint for this subject, OAS2_0088_MR1. There are quite a lot of skull left behind and that adversely affected the surfaces and the aseg. The image below is taken at slice 90.
0088_tp1_90_before.jpg

Although the surfaces and the aseg look pretty bad for this timepoint, the surfaces in the base are correct, therefore the surfaces in the long is also correct (since surfaces are copied from the base to the long). However, notice that in OAS2_0088_MR1.long.OAS2_0088, the aseg for the cerebellum is still overlabeling to the dura. Image below at slice 100.
0088_long1_100_before.jpg

It is then good to correct this problem. You can simply correct this by adjusting the watershed parameter for timepoint 1. Because the default threshold is always 25, to remove more skull, we need to decrease it. This should only take a couple minutes to complete, so feel free to run the command.

recon-all -subjid OAS2_0088_MR1 -skullstrip -wsthresh 20 -clean-bm -no-wsgcaatlas


If you ran the commands, take a look at your output volumes (directory w/o _fixed), or simply check our edited volumes, and verify that the result of the new skull stripping is correct:

tkmedit OAS2_0088_MR1_fixed brainmask.mgz -aux T1.mgz -surfs

After you are satisfied with the results, remember to run the rest of the cross sectional recon-all steps. Notice that although the extra skull is stripped off, the surfaces and the aseg are still incorrect, you'll need to run the following command in order to recreate the surfaces and the aseg. (This step will take very long so you don't need to run it for this tutorial.)

recon-all -subjid OAS2_0088_MR1 -autorecon2 -autorecon3

To save time, you can check in with the recon-all-status.log in the scripts directory of these subjects to see if the normalization step is complete. Or you can wait until the entire recon is done to check whether the surfaces and aseg are updated. They should. To check the corrected version:

tkmedit OAS2_0088_MR1_fixed brainmask.mgz -aux T1.mgz -surfs

Notice the major improvement on the same slice 90 for OAS2_0088_MR1.
0088_tp1_90_after.jpg

Once that step is complete, you can start recreating your base (remove/rename the base dir if it existed, e.g. mv OAS2_0088 OAS2_0088_old, before running this). To recreate the base using the newly created timepoint(s), use the following command:

recon-all -base OAS2_0088 -tp OAS2_0088_MR1 -tp OAS2_0088_MR2 -all

Then, the final step is to recreate the longitudinals once base and cross sectional runs are complete:

recon-all -long OAS2_0088_MR1 OAS2_0088 -all
recon-all -long OAS2_0088_MR2 OAS2_0000 -all

**NOTE: When recreating the base and longitudinals, it is recommended to remove or rename the existing base and longitudinal directories and start those processes from scratch, if possible, e.g. mv OAS2_0004 OAS2_0004_old.

You can examine the corrected version of the base and longitudinals by using the following commands in separate terminals.

tkmedit OAS2_0088_fixed brainmask.mgz -aux T1.mgz -surfs
tkmedit OAS2_0088_MR1.long.OAS2_0088_fixed brainmask.mgz -aux T1.mgz -surfs
tkmedit OAS2_0088_MR2.long.OAS2_0088_fixed brainmask.mgz -aux T1.mgz -surfs


You should not notice any changes to the base and the long for timepoint 2, however there is an improvement on the aseg for the long of timepoint 1. Here is the same slice 100 as shown above.
0088_long1_100_after.jpg


Now that was a fairly simple case, if you are still up for it, click here for a bigger challenge.


For more details on skull strip errors and the different ways to fix them, refer back to the Troubleshooting Skull Strip Tutorial.

FsTutorial/LongSkullStripFix (last edited 2013-04-23 17:02:37 by MartinReuter)