brede_ta3_volsurf

(export/brede/brede_ta3_volsurf.m)

Function Synopsis

hh = brede_ta3_volsurf(S, varargin)

Help text

 brede_ta3_volsurf    - Construct 3D Talairach volume surface

       function h = brede_ta3_volsurf(V, ...
            'PropertyName', 'PropertyValue')

       Input:    V          Volume structure

       Property: Alpha        [ 0 <= alpha <= 1 ] Opaqueness (inverse
                              transparency) of surface, 
                 Color        Color of the surface
                 Downsample   Downsampling of the volume. Value
                              should be an integer > 0. The default
                              is 1. 
                 IsoAbsolute  Isosurface threshold absolute
                              value. Value can be in [-Inf;Inf]
                 IsoRelative  Relative threshold value. The default
                              is 0.95. The threshold value is set on
                              the 0.95 of the distribution
                              function. Value should be in [0;1]
                 IsoPart      Threshold value. The part of voxels to
                              exclude. A value of 0.95 will make the
                              isosurface so that 5% of the voxels
                              are inside. The value should in [0;1]
                 ReducePatch  [ {1} ] reduce the number of polygons
                              by the fraction. This just calls the
                              reducepatch Matlab function 
                 Shadow       [ {line} | none ] Type of shadow on the
                              walls 
                 ShadowPos    [ {[ 0.1 0.1 -0.1]} | 1 integer | 3
                              integer ] Shadow position
                 Type         [ {face} | edge ]
                 Urls         Weblinks that are associated with the
                              geometry 
                 AmbientStrength   [ 0 ]
                 DiffuseStrength   [ 0.7 ]
                 SpecularStrength  [ 0.3 ]
                 ( SpecularExponent  [ 5 ] )
                 ( SpecularReflectance [ 1 ] )

       Output:   h          Graphic handle

       This function contructs a isosurface from a 'vol' structure
       (containing a volume) and plot the polygons in the current
       axes. An initial frame of reference can be setup with the
       brede_ta3_frame function.

       The threshold of the isosurface can be set in 3 different
       ways: 'IsoAbsolute' specifies an absolute threshold (the
       function brede_vol_plot_hist can plot a histogram of the voxel
       values which will give an idea of a good threshold). 'IsoPart'
       will a specified percentage of the voxels. 'IsoRelative' will
       select the threshold on the normalized cumulated sum. The
       'IsoRelative' type of threshold value is most suitable for
       probability density volumes.  

       The downsampling is pure decimation without any low-pass
       filtering. It the downsample is 3 it will index in the volume
       as 1:3:end for all three coordinates.

       Right clicking the mouse button will produce a popup menu. The
       color of the surface can be changed using this.

       Example:
         % Here S is a volume structure
         brede_ta3_volsurf(S, 'isopart', 0.95, 'downsample', 2)
         
         % If SPM99 is installed
         f = fullfile(fileparts(which('spm')), 'templates', 'PET');
         V = brede_read_analyze(f);
         figure, brede_ta3_frame
         brede_ta3_volsurf(PET, 'isoabsolute', 0.0025)
 
       See also BREDE, BREDE_TA3, BREDE_VOL, BREDE_TA3_VOLSLICE,
                BREDE_TA3_FRAME, BREDE_TA3_LOC, BREDE_TA2_VOL.
       
 $Id: brede_ta3_volsurf.m,v 1.27 2005/10/20 12:40:13 fnielsen Exp $

Cross-Reference Information

brede          export/brede/brede.m
brede_bib_bib2htmlexport/brede/brede_bib_bib2html.m
brede_exp_exp2htmlexport/brede/brede_exp_exp2html.m
brede_html_vol2htmlexport/brede/brede_html_vol2html.m
brede_mat_2mat2htmlexport/brede/brede_mat_2mat2html.m
brede_mat_plot_mdsexport/brede/brede_mat_plot_mds.m
brede_ta3_aal  export/brede/brede_ta3_aal.m
brede_ta3_bib  export/brede/brede_ta3_bib.m
brede_ta3_exp  export/brede/brede_ta3_exp.m
brede_ui_vol   export/brede/brede_ui_vol.m
brede_ui_vols  export/brede/brede_ui_vols.m
brede_vol_vols2htmlexport/brede/brede_vol_vols2html.m