Changes between Version 49 and Version 50 of UvmatHelp


Ignore:
Timestamp:
Jun 6, 2013, 11:40:40 PM (12 years ago)
Author:
sommeria
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • UvmatHelp

    v49 v50  
    606606== 10 - Processing field series ==
    607607=== 10.1 The GUI series.fig ===
    608 Operations on field series are controled by the GUI '''series.fig''', which allows the user to set the root name(s) and file indices over which a processing function operates. The root path, subdirectory, root file name and extension are introduced in the different columns of the table '''[!InputTable]'''. The nomenclature for file indexing is represented in the column '''[!NomType]''', the index extension for the first file in the series.
     608Operations on field series are controled by the GUI '''series.fig''', which allows the user to set the root name(s) and file indices over which a processing function operates. The GUI can be opened from '''uvmat''' through its menu bar option '''[Run/series]'''. It then mirrors the settings of '''uvmat'''. It can be alternatively opened by typing the Matlab command ''>>series'', then selecting  the input file series by the menu bar command '''[Open]'''.
     609
     610The root path, subdirectory, root file name and extension are introduced in the different columns of the table '''[!InputTable]'''. The nomenclature for file indexing is represented in the column '''[!NomType]''', the index extension for the first file in the series.
    609611
    610612Several input file series can be introduced simultaneously by the menu bar command''' [Open_append]''', filling the successive lines of '''!InputTable'''. By contrast, the table of input files is fully refreshed by the browser of the menu bar command '''[Open]'''. The cells in the table can be also edited manually. Then press the button '''[REFRESH]''' to validate the input.
     
    620622When input files are indexed by pairs i1-i2 or j1-j2, as resulting from PIV, the pair indexing is chosen by the panel '''[Set Pairs]'''. The popup menu [mode] provides the choice between 'bursts', 'Di','Dj'. In mode 'bursts' a single j index pair is selected in the menu '''[ListPairs]'''. In mode 'Di' and 'Dj' it selects a given index interval in i or j respectively. Then the first_i and last_i refer to the ''reference indices''. With the option '*-*' in '''[!ListPairs]''', available pairs are automatically chosen. In case of multiple input lines, the selection from '''[Set pairs]''' refers to the line number displayed in [ListView]. It is  transfered to the corresponding line in the table '''[PairString]'''.
    621623
    622 The velocity type and field are automatioally chosen by default, but can be specified by the menus '''[VelType]''' and '''[FieldName]'''. In case of multiple input file series, these menus only refer to the first line. Then the menus '''[VelType_1]''' and '''[FieldName_1]''' refer to the second line, consistently with the input for the GUI '''uvmat'''.
     624The velocity type and field are automatioally chosen by default, but can be specified by the menus '''[!VelType]''' and '''[!FieldName]'''. In case of multiple input file series, these menus only refer to the first line. Then the menus '''[!VelType_1]''' and '''[!FieldName_1]''' refer to the second line, consistently with the input for the GUI '''uvmat'''.
    623625
    624626A transform function can be introduced by the menu '''[!TransformName]'''. A projection object can be introduced by selecting the check box '''[!CheckObject]'''. If a projection object has been already created the  opened interface '''set_object.fig''' will be used. Otherwise a browser appears to open an object file (xml). Similarly the check box '''[!CheckMask]''' can be used to select a mask option. These different menus only appear if they are needed as input of the currently selected action function.
     
    630632
    631633=== 10.3 aver_stat: ===
    632 This option provides any average over the processed files. If nb_slice is not equal to 1, the average is performed slice by slice, providing nb_slice results.   If a projection object is selected (check box '''[CheckObject]'''), the field is projected before averaging.
     634This option provides any average over the processed files. If nb_slice is not equal to 1, the average is performed slice by slice, providing nb_slice results.   If a projection object is selected (check box '''[!CheckObject]'''), the field is projected before averaging.
    633635
    634636For unstructured coordinates varying for successive fields, the data is linearly interpolated on the coordinates of the first field in the series. It is then advised to project the fields on a regular grid, creating a projection object of type 'plane' with projection mode 'interp_lin' or 'interp_tps'.
     
    663665=== 11.1 Overview ===
    664666
    665 The GUI '''civ.fig''' is used to run the programs [CIVx->3]  (Correlation Imaging Velocimetry). It is a free advanced Imaging Velocimetry implementation that relies on direct cross-correlation of pattern boxes between image pairs. The binary executable files suitable for the computer operating system need to be properly installed (see {uvmat_doc/README_INSTALL.txt }).
     667PIV can be performed by selecting the Matlab function ''civ_series'' as '''[ActionName]''' in the GUI '''series'''. The same operations can be also performed with the older function ''civ.m'' running with the specific GUI '''civ.fig''', accessible from uvmat by the menu bar command '''[RUN/civ]'''. This older option is still used to run the fortran programs [CIVx].
    666668
    667669-''' {Opening the GUI:} ''' The GUI '''civ.fig''' for PIV calculation can be directly opened by the command '>>civ' on the Matlab prompt. Then open an image or a documentation file (.xml ) with the file browser. ''' '''The''' ''' GUI '''civ.fig''' can be also directly opened from '''uvmat.fig''', by the menu bar command '''[RUN/civ]'''.  A third way is just to open the Matlab image ({civ.fig} file) stored after each processing in the directory of the velocity fields. Then just edit it and run a new calculation.