--srcsubject <source subject name>

Name of source subject

As found in $SUBJECTS_DIR or ico for icosahedron. The input data must have been sampled onto this subject's surface (eg, using mri_vol2surf)

--srcsurfval <sourcefile>

Name of file where the data on the source surface is located.

--trgsubject <target subject name>

name of target subject as found in $SUBJECTS_DIR or ico for icosahedron.

--trgsurfval <targetfile>

Name of file where the data on the target surface will be stored.

BUG ALERT: for trg_type w or paint, use the full path.

--hemi <hemifield>

(lh or rh)

--src_type <typestring>

Format type string

Can be either curv (for FreeSurfer curvature file), paint or w (for FreeSurfer paint files), or anything accepted by mri_convert. If no type string is given, then the type is determined from the sourcefile (if possible). If curv is used, then the curvature file will be looked for in $SUBJECTS_DIR/srcsubject/surf/hemi.sourcefile.

--trgicoorder <n>

Icosahedron order number

This specifies the size of the icosahedron according to the formula #vertices=10*4^n+2. In general, it is best to use the largest size available.

--trg_type <typestring>

Format type string.

Can be paint or w (for FreeSurfer paint files) or anything accepted by mri_convert. Output can also be stored in curv format. If no type string is given, then the type is determined from the sourcefile (if possible). If using paint or w, see also --frame.

--surfreg <registration_surface>

If the source and target subjects are not the same, this surface is used to register the two surfaces. sphere.reg is used as the default. Do not change this unless you know what you're doing.

--mapmethod <methodname>

Method used to map from the vertices in one subject to those of another.

Legal values are: nnfr (neighest-neighbor, forward and reverse) and nnf (neighest-neighbor, forward only). Default is nnfr. The mapping is done in the following way. For each vertex on the target surface, the closest vertex in the source surface is found, based on the distance in the registration space (this is the forward map). If nnf is chosen, then the the value at the target vertex is set to that of the closest source vertex. This, however, can leave some source vertices unrepresented in target (ie, 'holes'). If nnfr is chosen, then each hole is assigned to the closest target vertex. If a target vertex has multiple source vertices, then the source values are averaged together. It does not seem to make much difference.

--nsmooth-in <niterations>, --nsmooth-out <niterations> [note: same as --smooth]

Number of smoothing iterations.

Each iteration consists of averaging eeach vertex with its neighbors. When only smoothing is desired, just set the source and target subjects to the same subject. --smooth-in smoothes the input surface values prior to any resampling. --smooth-out smoothes after any resampling.

--frame <framenumber>

When using paint/w output format, this specifies which frame to output. This format can store only one frame. The frame number is zero-based (default is 0).

--noreshape

By default, mri_surf2surf will save the output as multiple 'slices'; has no effect for paint/w output format. For ico, the output will appear to be a 'volume' with Nv/R colums, 1 row, R slices and Nf frames, where Nv is the number of vertices on the surface. For icosahedrons, R=6. For others, R will be the prime factor of Nv closest to 6. Reshaping is for logistical purposes (eg, in the analyze format the size of a dimension cannot exceed 2^15). Use this flag to prevent this behavior. This has no effect when the output type is paint.