Differences between revisions 9 and 10
Deletions are marked like this. Additions are marked like this.
Line 6: Line 6:
'''mris_ca_train''' - Creates a cortical parcellation atlas file based on one or more annotated subjects. By default, both the sulcus and curvature information is used to parcellate the cortical surface into regions. '''mris_ca_train''' - Creates a cortical parcellation atlas file based on one or more annotated subjects. mris_ca_train builds probabilistic information estimated from a manually labeled training set (of annotated subject). This information is then used by mris_ca_label to automatically assign a neuroanatomical label to each location on a cortical surface model. This procedure incorporates both geometric information derived from the cortical model (sulcus and curvature), and neuroanatomical convention, as found in the training set. The result of mris_ca_train and mris_ca_label is a complete labeling of cortical sulci and gyri.

Navigation(children) Index TableOfContents

Name

mris_ca_train - Creates a cortical parcellation atlas file based on one or more annotated subjects. mris_ca_train builds probabilistic information estimated from a manually labeled training set (of annotated subject). This information is then used by mris_ca_label to automatically assign a neuroanatomical label to each location on a cortical surface model. This procedure incorporates both geometric information derived from the cortical model (sulcus and curvature), and neuroanatomical convention, as found in the training set. The result of mris_ca_train and mris_ca_label is a complete labeling of cortical sulci and gyri.

Synopsis

mris_ca_train [options] hemi canonsurf annotfile subject1 [subject2 ...] outputfile

Arguments

Positional Arguments

[options]

-sdir, -nbrs, -orig, -norm1, -norm2, -norm3, -ic, -sulc, -sulconly, -a, -t, -v, -n, -?, -u

hemi

hemisphere: rh or lh

canon surf

canonical surface file

annot file

annotation file

subject 1 [subject 2...]

subject(s)

outputfile

classifier array output file

Required Flagged Arguments

hemi canonsurf annotfile subject1 outputfile

Optional Flagged Arguments

-sdir <subject dir>

specify a subjects directory (default=$SUBJECTS_DIR)

-nbrs <number>

neighborhood size (default=2)

-orig <filename>

specify filename of original surface (default=smoothwm)

-norm1

GCSA normalize input #1 after reading (default: disabled)

-norm2

GCSA normalize input #2 after reading (default: disabled)

-norm3

GCSA normalize input #3 after reading (default: disabled)

-ic <number_priors> <number_classifiers>

parameters passed to GCSAalloc() routine (default: -ic 7 4)

-sulc

specify sulc as only input (default: sulcus and curvature)

-sulconly

same as -sulc

-a <number>

number of averages (default=5)

-t <filename>

specify parcellation table input file (default: none)

-v <number>

diagnostic level (default=0)

-n <number>

number of inputs (default=1)

-?

print usage info

-u

same as -?

Outputs

outputfile

classifier array output file

Example

mris_ca_train -n 2 \
    -t ./my_color_file.txt \
    lh \
    sphere.reg \
    my_manual_labeling \
    $SUBJECTS \
    ./lh.my_atlas.gcs

In this example, mris_ca_train would look for a file named lh.my_manual_labeling.annot in each of the subjects listed in $SUBJECTS label dir (e.g. $SUBJECTS_DIR/$s/label), and also assume that a file named lh.sphere.reg existed in the surf dir of each subject.

The -n 2 option tells it to use 2 feature dimensions for classification: curv and sulc (which is what is used by default).

The -t ./my_color_file.txt option will read in the file my_color_file.txt and embed it in the atlas, so that mris_ca_label will put it in the automatically generated .annot files, so that later, tksurfer (and other things) can read it in.

The format of the my_color_file.txt file consists of a set of lines like:

1   Corpus_callosum     50      50      50      0

where the last value (0, in this example) is not used, and the 50s are r,g,b (red,green,blue) values. They must match what is in the annot file, in which each vertex is given the value: r+(g << 8)+(b << 16).

Bugs

None

See Also

[wiki:mris_5fca_5flabel mris_ca_label]

Links

CorticalParcellation, FreeSurfer, FsFast

References

[https://surfer.nmr.mgh.harvard.edu/ftp/articles/fischl04-parcellation.pdf Automatically Parcellating the Human Cerebral Cortex], Fischl et al., (2004). Cerebral Cortex, 14:11-22.

Reporting Bugs

Report bugs to <analysis-bugs@nmr.mgh.harvard.edu>

Author/s

BruceFischl

mris_ca_train (last edited 2011-10-19 15:33:06 by NickSchmansky)