Changeset 457 for trunk/src/series/sub_background.m

Timestamp:

Jun 17, 2012, 10:52:04 PM (12 years ago)

Author:

sommeria

Message:

merg_i_j transformed to the new standards.
Various improvements

File:

• trunk/src/series/sub_background.m (modified) (7 diffs)

trunk/src/series/sub_background.m

@@ -1 @@
-%'sub_background': substract background to an image series, used with series.fig
+%'sub_background': substract a sliding background to an image series
+% This is an example of action on a series of input images
 %------------------------------------------------------------------------
 % Method: 
@@ -14 +15 @@
     % Else nbfield2=nbfield_j =nbre of images in a burst (j index)
     
-% function GUI_series_config=sub_background(Param)
+% function GUI_config=sub_background(Param)
 %
 %%%%%%%%%%% GENERAL TO ALL SERIES ACTION FCTS %%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
+% This function is used in four modes by the GUI series:
+%           1) config GUI: with no input argument, the function determine the suitable GUI configuration
+%           2) interactive input: the function is used to interactively introduce input parameters, and then stops
+%           3) RUN: the function itself runs, when an appropriate input  structure Param has been introduced. 
+%           4) BATCH: the function itself proceeds in BATCH mode, using an xml file 'Param' as input.
+%
 %OUTPUT
 % GUI_series_config=list of options in the GUI series.fig needed for the function
@@ -52 +60 @@
     GUI_config={'NbViewMax';1;...% max nbre of input file series (default='' , no limitation)
         'AllowInputSort';'off';...% allow alphabetic sorting of the list of input files (options 'off'/'on', 'off' by default)
+        'WholeIndexRange';'on';...% prescribes the file index ranges from min to max (options 'off'/'on', 'off' by default)
         'NbSlice';'on'; ...%nbre of slices ('off' by default)
         'VelType';'off';...% menu for selecting the velocity type (options 'off'/'one'/'two',  'off' by default)
@@ -64 +73 @@
 
 %%%%%%%%%%%% STANDARD PART (DO NOT EDIT) %%%%%%%%%%%%
-%% get input parameters, file names and indices
+%% select different modes,  RUN, parameter input, BATCH
 % BATCH  case: read the xml file for batch case
-if ischar(Param) && ~isempty(find(regexp(Param,'.xml$'))) %batch mode
+if ischar(Param)
+    if strcmp(Param,'input?')
+        checkrun=1;% will inly search input parameters (preparation of BATCH mode)
+    else
         Param=xml2struct(Param);
         checkrun=0;
-    % RUN case: parameters introduced as the input structure Param
+    end
+% RUN case: parameters introduced as the input structure Param
 else
     hseries=guidata(Param.hseries);%handles of the GUI series
     WaitbarPos=get(hseries.waitbar_frame,'Position');%position of the waitbar on the GUI series
-    checkrun=1; % indicate the RUN option is used
-end
+    checkrun=2; % indicate the RUN option is used
+end
+
+%% root input file(s) and type
+RootPath=Param.InputTable(:,1);
+RootFile=Param.InputTable(:,3);
+SubDir=Param.InputTable(:,2);
+NomType=Param.InputTable(:,4);
+FileExt=Param.InputTable(:,5);
+
 % get the set of input file names (cell array filecell), and the lists of
 % input file or frame indices i1_series,i2_series,j1_series,j2_series
@@ -84 +105 @@
 % i1_series(iview,fileindex) expresses the same indices as a 1D array in file indices
 % set of frame indices used for movie or multimage input 
-
-
-%% root input file(s) and type
-RootPath=Param.InputTable(:,1);
-RootFile=Param.InputTable(:,3);
-SubDir=Param.InputTable(:,2);
-NomType=Param.InputTable(:,4);
-FileExt=Param.InputTable(:,5);
-
 % numbers of slices and file indices
+
 NbSlice=1;%default
-if isfield(Param.IndexRange,'NbSlice')
+if isfield(Param.IndexRange,'NbSlice')&&~isempty(Param.IndexRange.NbSlice)
     NbSlice=Param.IndexRange.NbSlice;
 end
@@ -162 +175 @@
 end
 
-%% set processing parameters
-if ~isfield(Param,'Specific')
+%% input of specific parameters
+if checkrun %get specific parameters interactively
     prompt = {'volume scan mode (Yes/No)';'Number of images for the sliding background (MUST FIT IN COMPUTER MEMORY)';...
         'the luminosity rank chosen to define the background (0.1=for dense particle seeding, 0.5 (median) for sparse particles'};
@@ -200 +213 @@
     answer=msgbox_uvmat('INPUT_Y-N','apply image rescaling function levels.m after sub_background');
     GUI_config.CheckLevelTransform=strcmp(answer,'Yes');
-    
-%     % return to BATCH mode
-%     if checkrun==-1
-        return %transfer to BATCH mode
-%     end
+    if checkrun==2
+         return 
+    end
+    %%%%%%%%%%%%%%%%%%%%%%  STOP HERE FOR PAMETER INPUT MODE  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 else
     GUI_config=Param.Specific;