AFNI program: ConvertSurface

Output of -help



Usage:  ConvertSurface <-i_TYPE inSurf> <-o_TYPE outSurf> 
    [<-sv SurfaceVolume [VolParam for sf surfaces]>] [-tlrc] [-MNI_rai/-MNI_lpi]
    reads in a surface and writes it out in another format.
    Note: This is a not a general utility conversion program. 
    Only fields pertinent to SUMA are preserved.
    -i_TYPE inSurf specifies the input surface, TYPE is one of the following:
       fs: FreeSurfer surface. 
           Only .asc surfaces are read.
       sf: SureFit surface. 
           You must specify the .coord followed by the .topo file.
       vec: Simple ascii matrix format. 
            You must specify the NodeList file followed by the FaceSetList file.
            NodeList contains 3 floats per line, representing X Y Z vertex coordinates.
            FaceSetList contains 3 ints per line, representing v1 v2 v3 triangle vertices.
       ply: PLY format, ascii or binary.
            Only vertex and triangulation info is preserved.
    -o_TYPE outSurf specifies the output surface, TYPE is one of the following:
       fs: FreeSurfer ascii surface. 
       sf: SureFit surface. (NOT IMPLEMENTED YET)
           You must specify the .coord followed by the .topo file.
       vec: Simple ascii matrix format. 
            see help for vec under -i_TYPE options for format specifications.
       ply: PLY format, ascii or binary.
    -make_consistent: Check the consistency of the surface's mesh (triangle
                      winding). This option will write out a new surface even 
                      if the mesh was consistent.
                      See SurfQual -help for mesh checks.
    -sv SurfaceVolume [VolParam for sf surfaces]
       This option must not come before the -i_TYPE option.
       If you supply a surface volume, the coordinates of the input surface.
        are modified to SUMA's convention and aligned with SurfaceVolume.
        You must also specify a VolParam file for SureFit surfaces.
    -acpc: Apply acpc transform (which must be in acpc version of 
        SurfaceVolume) to the surface vertex coordinates. 
        This option must be used with the -sv option.
    -tlrc: Apply Talairach transform (which must be in talairach version of 
        SurfaceVolume) to the surface vertex coordinates. 
        This option must be used with the -sv option.
    -MNI_rai/-MNI_lpi: Apply Andreas Meyer Lindenberg's transform to turn 
        AFNI tlrc coordinates (RAI) into MNI coord space 
        in RAI (with -MNI_rai) or LPI (with -MNI_lpi)).
        NOTE: -MNI_lpi option has not been tested yet (I have no data
        to test it on. Verify alignment with AFNI and please report
        any bugs.
        This option can be used without the -tlrc option.
        But that assumes that surface nodes are already in
        AFNI RAI tlrc coordinates .
   NOTE: The vertex coordinates coordinates of the input surfaces are only
         transformed if -sv option is used. If you do transform surfaces, 
         take care not to load them into SUMA with another -sv option.

    Options for applying arbitrary affine transform:
    [xyz_new] = [Mr] * [xyz_old - cen] + D + cen
    -xmat_1D mat: Apply transformation specified in 1D file mat.1D.
                  to the surface's coordinates.
                  [mat] = [Mr][D] is of the form:
                  r11 r12 r13 D1
                  r21 r22 r23 D2
                  r31 r32 r33 D3
    -xcenter x y z: Use vector cen = [x y z]' for rotation center.
                    Default is cen = [0 0 0]'
++ SUMA version 2.5000, June 10 2004

Compile Date:
   Aug  3 2004

		 Ziad S. Saad SSCC/NIMH/NIH ziad@nih.gov 	 Wed Jan  8 13:44:29 EST 2003 

This page generated on Tue Aug 3 16:42:46 EDT 2004