brede_bib_bib2mat

 brede_bib_bib2mat    - Generate matrix from 'Bib' structure

       function M = brede_bib_bib2mat(B, ...
          'PropertyName', 'PropertyValue')

       Input:    B      'Bib' structure

       Property: Info   [ {0} | waitbar | integer ] Feedback
                        information during processing
                 NormalizeExp  [ {n} | none | sqrt ]
                 NormalizeLoc  [ {n} | none | sqrt ]
                 Type   [ Abstract | {Author.keyname} |
                        Author(1).keyname | Author.keyname x
                        Author(1).keyname | Exp.Loc.coord | keywords
                        | References.journal |
                        References.Author.keyname ]   
                        Determines what kind of matrix should be
                        contructed
                 Template   [ spm99_default | spm95 | spm99_template
                            | {spm99_default_0.008} |
                            spm99_default_0.004 |
                            spm99_template_0.008 ] 
                 VoxelizationSigma [ {0.01} | LOOCV ] Standard
                        deviation of the voxelization kernel.
 

       Output:   M      'Mat' structure 

       This function makes a 'Bib' structure into a 'Mat' structure.
       The 'Mat' structure contains the following fields:
           M.description String with description
           M.matrix      Matrix
           M.rows        Eg. 'Bib' structure
           M.columes     Eg. cellstrings.
           M.type='mat'  Structure identifier

       It is possible to construct matrix from the name of
       the journals in the reference 'References.journal' and from the
       author names 'Author.keyname'.

       Using 'keywords' as type a (document x term)-matrix will be
       constructed with the 'bib' structures corresponding to rows
       and 'colomns' based on individual words in the 'keywords'
       field of the 'bib' structures.

       'Abstract' type will genearate a (document x term)-matrix
       where the terms are taken from the individual words of the
       abstract. 

       When 'Type'='Exp.Loc.coord' the Talairach coordinates (if any)
       will be used in a voxelization and a row in the returned
       matrix will then correspond to a volume. Voxel coordinates are
       then in the 'columns' field. The 'VoxelizationSigma' property
       determines the kernel width. 0.01 corresponds to 1 centimeter. 
       The function brede_bib_bib2vol is used for the voxelization.
       'VoxelizationSigma' determines the width of the kernel, and
       'template' determines how large the resulting volumes should
       be (in terms of resolution and bounding box).

       Example:
         f = fullfile(fileparts(which('brede')), 'xml', 'wobibs.xml');
         B = brede_read_xml(f, 'output', 'collapsesecond');
         M = brede_bib_bib2mat(B, 'Type', 'Author.keyname');
         brede_mat_plot_count(M);

       See also BREDE, BREDE_BIB, BREDE_MAT, BREDE_BIB_BIB2VOL,
                BREDE_BIB_GETFIELD, BREDE_STR_STR2MAT.

 $Id: brede_bib_bib2mat.m,v 1.21 2007/11/07 12:24:30 fn Exp $