Name

mris_ca_train - ??

Synopsis

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

Arguments

Positional Arguments

[options]	-SDIR, -nbrs, -ORIG, -NORM1, -NORM2, -NORM3, -IC, -SUCL, -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>	(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 filename (default: not written)
-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

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

-  ⇤ ← Revision 2 as of 2004-08-27 15:08:18 → 
  Size: 1147
  Editor: DavidTuch
  Comment:
+   ← Revision 5 as of 2005-11-16 14:28:09 → ⇥
  Size: 3589
  Editor: NickSchmansky
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 13:
-Line 19:
+Line 18:
-mris_ca_train hemi canonsurf annotfile subject1 [subject2 ...] [outputfile]
+mris_ca_train [options] hemi canonsurf annotfile subject1 [subject2 ...] outputfile
-Line 24:
+Line 23:
-|| hemi || hemisphere  ||   ||
|| canon surf || canonical surface ||   ||
|| annot file || annotation file || ||
|| subject 1 [subject 2...] ||  subject(s)||  ||
|| outputfile || output file ||
+|| [options] || -SDIR, -nbrs, -ORIG, -NORM1, -NORM2, -NORM3, -IC, -SUCL, -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 ||
 Line 31:
-none
+hemi canonsurf annotfile subject1 outputfile
 Line 34:
-none
+|| -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> || (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 filename (default: not written) ||
|| -v <number> || diagnostic level (default=0) ||
|| -n <number> || number of inputs (default=1) ||
|| -? || print usage info ||
|| -u || same as -? ||
-Line 37:
+Line 51:
-||outpufile|| ||
+|| outputfile || classifier array output file ||
-Line 39:
+Line 53:
-= Description =
??
+= Example =
{{{
mris_ca_train -n 2 \
    -t ./my_color_file.txt \
    lh \
    sphere.reg \
    my_manual_labeling \
    $SUBJECTS \
    ./lh.my_atlas.gcs
}}}
-Line 42:
+Line 64:
-= Examples =
== Example 1 ==
??
== Example 2 ==
??
+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).
-Line 52:
+Line 80:
+[wiki:Self:mris_5fca_5flabel mris_ca_label]
-Line 54:
+Line 83:
-FreeSurfer, FsFast

= Methods Description =
+CorticalParcellation, FreeSurfer, FsFast
-Line 59:
+Line 86:
+ * [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.