{"id":155,"date":"2010-10-28T21:11:00","date_gmt":"2010-10-28T21:11:00","guid":{"rendered":"http:\/\/brainybehavior.com\/neuroimaging\/?p=155"},"modified":"2010-10-29T00:37:07","modified_gmt":"2010-10-29T00:37:07","slug":"freesurfer-tools-mask-manipulation","status":"publish","type":"post","link":"https:\/\/brainybehavior.com\/neuroimaging\/2010\/10\/freesurfer-tools-mask-manipulation\/","title":{"rendered":"FreeSurfer Tools for Mask Manipulation"},"content":{"rendered":"

FreeSurfer includes a useful tool for manipulating mask files. Let’s say you wanted to pull the left caudate from the aseg.mgz file in order to use it for fiber tracking (that’s my default example in part because it’s salient for my research).<\/p>\n

I want to be able to work with the FreeSurfer created files in other programs so I’ll convert to nii.gz.<\/p>\n

mri_convert \/Applications\/freesurfer\/subjects\/{subjectID}\/mri\/orig.mgz \/Applications\/freesurfer\/subjects\/{subjectID}\/mri\/orig.nii.gz<\/p>\n

Now I want to convert the aseg.mgz file over. I’ll use a different method than mri_convert or mri_binarize (although both could work).<\/p>\n

mri_label2vol –subject {subjectID}\u00a0–seg \/Applications\/freesurfer\/subjects\/{subjectID}\/mri\/aseg.mgz –fillthresh .8 –identity –temp \/Applications\/freesurfer\/subjects\/{subjectID}\/mri\/orig.mgz –o \/Applications\/freesurfer\/subjects\/{subjectID}\/mri\/aseg2vol.nii.gz<\/p>\n

Technically, I didn’t need the –subject on there but I like to include it just as a redundancy.<\/p>\n

Here’s the output in ITK-SNAP:<\/p>\n

\"\"<\/a><\/p>\n

But I don’t need all of the brain structures, I just want the left caudate (label 11).<\/p>\n

mri_binarize –i \/Applications\/freesurfer\/subjects\/{subjectID}\/mri\/aseg2vol.nii.gz –match 11 –o \/Applications\/freesurfer\/subjects\/{subjectID}\/mri\/left_caudate.nii.gz<\/p>\n

You actually can run that command with the basic aseg.mgz (and thus skip the mri_label2vol step above) but I wanted to show both. I’d recommend using mri_label2vol for binary mask creation but for subcortical structures it shouldn’t matter. Running this conversion both ways (mri_label2vol and mri_binarize) results in a perfect mask overlap (the blue and red caudates – one from each method – appear purple in this screenshot).<\/p>\n

\"\"<\/a><\/p>\n

Now say you wanted to make a mask a little bit bigger or a little bit smaller (to either pick up surrounding voxels or to exclude part of a mask). You can use mri_binarize to do that (you could even do this with the step above, I’m separating it out for simplicity):<\/p>\n

mri_binarize –i \/Applications\/freesurfer\/subjects\/{subjectID}\/mri\/left_caudate2.nii.gz –erode 1 –match 2 –o \/Applications\/freesurfer\/subjects\/{subjectID}\/mri\/left_caudate3.nii.gz<\/p>\n

In that command I input (–i), erode 1 voxel in 3D (–erode 1) from the left caudate (–match 2; that is a 2 because I created this binary mask earlier and gave the left caudate a value of 2), and then specify an output (–o).<\/p>\n

Here you can see the results (visualization in FSLView, which I’m not overly fond of but it makes viewing mask overlap very easy):<\/p>\n

\"\"<\/a><\/p>\n

As you can see, the eroded caudate is one voxel smaller in 3D than the original caudate.<\/p>\n

You can created a summed overlap file (or combine any mask files in the same space together) by using fslmaths (you can also do this with the mri_binarize –merge option but I’m just introducing a range of tools):<\/p>\n

fslmaths {input file} -add {adding file} {output}<\/p>\n","protected":false},"excerpt":{"rendered":"

FreeSurfer includes a useful tool for manipulating mask files. Let’s say you wanted to pull the left caudate from the aseg.mgz file in order to use it for fiber tracking (that’s my default example in part because it’s salient for … Continue reading →<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":158,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[12,40,13],"tags":[41,67,27,28,43,42],"_links":{"self":[{"href":"https:\/\/brainybehavior.com\/neuroimaging\/wp-json\/wp\/v2\/posts\/155"}],"collection":[{"href":"https:\/\/brainybehavior.com\/neuroimaging\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/brainybehavior.com\/neuroimaging\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/brainybehavior.com\/neuroimaging\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/brainybehavior.com\/neuroimaging\/wp-json\/wp\/v2\/comments?post=155"}],"version-history":[{"count":5,"href":"https:\/\/brainybehavior.com\/neuroimaging\/wp-json\/wp\/v2\/posts\/155\/revisions"}],"predecessor-version":[{"id":160,"href":"https:\/\/brainybehavior.com\/neuroimaging\/wp-json\/wp\/v2\/posts\/155\/revisions\/160"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/brainybehavior.com\/neuroimaging\/wp-json\/wp\/v2\/media\/158"}],"wp:attachment":[{"href":"https:\/\/brainybehavior.com\/neuroimaging\/wp-json\/wp\/v2\/media?parent=155"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/brainybehavior.com\/neuroimaging\/wp-json\/wp\/v2\/categories?post=155"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/brainybehavior.com\/neuroimaging\/wp-json\/wp\/v2\/tags?post=155"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}