brede_loc_query

 brede_loc_query      - Query after 'loc' structures

       function [Lout, dist] = brede_loc_query(q, varargin)

       Input:    q       Query

       Property: Bib     'Bib' structure
                 Info    [ 0 | Integer ] Amount of debug information 
                 Type    [ {NearestCoords} | InWOROI | InWoroiExact |
                         InWoroiRobust | InWoroiOrChildren |
                         InWoroiOrChildrenExact |
                         InWoroiOrChildrenRobust ]

       Output:   Lout    Sorted 'loc' structure
                 dist    Sorted distances

       The function makes a query and return a sorted list of 'Loc'
       structures. The query can be Talairach coordinates and
       the function will return the location sorted according to
       distance from the query location. The nearest locations will
       be the first in the array. 

       For 'Type'='InWOROI' the query should be a numeric value for
       an WOROI identifier, e.g., WOROI=5 is posterior
       cingulate. This type of search will use the 'lobarAnatomy',
       'functionalArea' or 'brodmann' fields in the 'loc'
       structures and compare these against the Brede Database brain
       region taxonomy.

       The first time the function is called the Brede database will
       be setup in persistent variables via the brede_bdb
       function. 

       Example: 
         Lout = brede_loc_query([-2 -52 24]/1000);
         brede_loc_loc2html(Lout, 'file', 'tmp.html')
         web(['file://' fullfile(pwd, 'tmp.html')]);

         % Find posterior cingulate (WOROI: 5) coordinates 
         Lpcc = brede_loc_query(5, 'type', 'InWOROI')

       See also BREDE, BREDE_LOC, BREDE_BDB, BREDE_BIB, BREDE_ROI,
                BREDE_READ_XML, BREDE_LOC_LOC2HTML, BREDE_EXP_QUERY,
                BREDE_PDE_SPECHTLP, BREDE_ROI_ROI2NAMES.

 $Id: brede_loc_query.m,v 1.13 2006/08/17 12:11:21 fn Exp $