Clusters visualisation and cluster time series extraction

Francois · February 17, 2023, 10:36am

Hi Elena,

I added a new function db_set_clusters.m to help you deal with clusters programmatically:

brainstorm-tools/brainstorm3/blob/master/toolbox/db/db_set_clusters.m#L4


      
          function OutputFiles = db_set_clusters(ChannelFile, Target, Clusters)
          % DB_SET_CLUSTERS: Set the list of clusters saved in the channel files of target folders
          %
          % USAGE:  OutputFiles = db_set_clusters(ChannelFile, iDestStudies)   : Copy clusters from a channel file to the target folders
          %         OutputFiles = db_set_clusters(ChannelFile, 'AllConditions'): Copy clusters from a channel file to all the folders in the same subject
          %         OutputFiles = db_set_clusters(ChannelFile, 'AllSubjects')  : Copy clusters from a channel file to all the folders in all the subjects
          %         OutputFiles = db_set_clusters(..., Clusters)               : Copy input clusters to the target studies (instead of reading then from input channel file)
          %         OutputFiles = db_set_clusters(..., [])                     : Empty the list of clusters in the target studies
          
          
% @=============================================================================
          % This function is part of the Brainstorm software:
          % https://neuroimage.usc.edu/brainstorm
          % 
          % Copyright (c) University of Southern California & McGill University

I added some examples in the tutorials:

github.com

brainstorm-tools/brainstorm3/blob/master/toolbox/db/db_set_clusters.m

function OutputFiles = db_set_clusters(ChannelFile, Target, Clusters)
% DB_SET_CLUSTERS: Set the list of clusters saved in the channel files of target folders
%
% USAGE:  OutputFiles = db_set_clusters(ChannelFile, iDestStudies)   : Copy clusters from a channel file to the target folders
%         OutputFiles = db_set_clusters(ChannelFile, 'AllConditions'): Copy clusters from a channel file to all the folders in the same subject
%         OutputFiles = db_set_clusters(ChannelFile, 'AllSubjects')  : Copy clusters from a channel file to all the folders in all the subjects
%         OutputFiles = db_set_clusters(..., Clusters)               : Copy input clusters to the target studies (instead of reading then from input channel file)
%         OutputFiles = db_set_clusters(..., [])                     : Empty the list of clusters in the target studies

% @=============================================================================
% This function is part of the Brainstorm software:
% https://neuroimage.usc.edu/brainstorm
% 
% Copyright (c) University of Southern California & McGill University
% This software is distributed under the terms of the GNU General Public License
% as published by the Free Software Foundation. Further details on the GPLv3
% license can be found at http://www.gnu.org/copyleft/gpl.html.
% 
% FOR RESEARCH PURPOSES ONLY. THE SOFTWARE IS PROVIDED "AS IS," AND THE
% UNIVERSITY OF SOUTHERN CALIFORNIA AND ITS COLLABORATORS DO NOT MAKE ANY

This file has been truncated. show original

Let me know if you think of other options for these functions that would make your life easier.