source: trunk/src/proj_field.m @ 380

Last change on this file since 380 was 379, checked in by sommeria, 12 years ago

several bugs corrected
set_object.fig rationalized so that read_set_object is replaced by the rgeneral fct read_GUI.

File size: 101.6 KB
Line 
1%'proj_field': projects the field on a projection object
2%--------------------------------------------------------------------------
3%  function [ProjData,errormsg]=proj_field(FieldData,ObjectData)
4%
5% OUTPUT:
6% ProjData structure containing the fields of the input field FieldData,
7% transmitted or projected on the object, plus the additional fields
8%    .UMax, .UMin, .VMax, .VMin: min and max of velocity components in a domain
9%    .UMean,VMean: mean of the velocity components in a domain
10%    .AMin, AMax: min and max of a scalar
11%    .AMean: mean of a scalar in a domain 
12%  .NbPix;
13%  .DimName=  names of the matrix dimensions (matlab cell)
14%  .VarName= names of the variables [ProjData.VarName {'A','AMean','AMin','AMax'}];
15%  .VarDimNameIndex= dimensions of the variables, indicated by indices in the list .DimName;
16%
17%INPUT
18% ObjectData: structure characterizing the projection object
19%    .Type : type of projection object
20%    .ProjMode=mode of projection ;
21%    .CoordUnit: 'px', 'cm' units for the coordinates defining the object
22%    .Phi  angle of rotation (=0 by default)
23%    .ProjAngle=angle of projection;
24%    .DX,.DY,.DZ=increments along each coordinate
25%    .Coord(nbpoints,3): set of coordinates defining the object position;
26
27%FieldData: data of the field to be projected on the projection object, with optional fields
28%    .Txt: error message, transmitted to the projection
29%    .CoordType: 'px' or 'phys' type of coordinates of the field, must be the same as for the projection object, transmitted
30%    .Mesh: typical distance between data points (used for mouse action or display), transmitted
31%    .CoordUnit, .TimeUnit, .dt: transmitted
32% standardised description of fields, nc-formated Matlab structure with fields:
33%         .ListGlobalAttribute: cell listing the names of the global attributes
34%        .Att_1,Att_2... : values of the global attributes
35%            .ListVarName: cell listing the names of the variables
36%           .VarAttribute: cell of structures s containing names and values of variable attributes (s.name=value) for each variable of .ListVarName
37%        .Var1, .Var2....: variables (Matlab arrays) with names listed in .ListVarName
38% The variables are grouped in 'fields', made of a set of variables with common dimensions (using the function find_field_indices)
39% The variable attribute 'Role' is used to define the role for plotting:
40%       Role = 'scalar':  (default) represents a scalar field
41%            = 'coord':  represents a set of unstructured coordinates, whose
42%                     space dimension is given by the last array dimension (called 'NbDim').
43%            = 'coord_x', 'coord_y',  'coord_z': represents a separate set of
44%                        unstructured coordinate x, y  or z
45%            = 'vector': represents a vector field whose number of components
46%                is given by the last dimension (called 'NbDim')
47%            = 'vector_x', 'vector_y', 'vector_z'  :represents the x, y or z  component of a vector 
48%            = 'warnflag' : provides a warning flag about the quality of data in a 'Field', default=0, no warning
49%            = 'errorflag': provides an error flag marking false data,
50%                   default=0, no error. Different non zero values can represent different criteria of elimination.
51%
52% Default role of variables (by name)
53%  vector field:
54%    .X,.Y: position of the velocity vectors, projected on the object
55%    .U, .V, .W: velocity components, projected on the object
56%    .C, .CName: scalar associated to the vector
57%    .F : equivalent to 'warnflag'
58%    .FF: equivalent to 'errorflag'
59%  scalar field or image:
60%    .AName: name of a scalar (to be calculated from velocity fields after projection), transmitted
61%    .A: scalar, projected on the object
62%    .AX, .AY: positions for the scalar
63%     case of a structured grid: A is a dim 2 matrix and .AX=[first last] (length 2 vector) represents the first and last abscissa of the grid
64%     case of an unstructured scalar: A is a vector, AX and AY the corresponding coordinates
65%
66%AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
67%  Copyright Joel Sommeria, 2008, LEGI / CNRS-UJF-INPG, sommeria@coriolis-legi.org.
68%AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
69%     This file is part of the toolbox UVMAT.
70%
71%     UVMAT is free software; you can redistribute it and/or modify
72%     it under the terms of the GNU General Public License as published by
73%     the Free Software Foundation; either version 2 of the License, or
74%     (at your option) any later version.
75%
76%     UVMAT is distributed in the hope that it will be useful,
77%     but WITHOUT ANY WARRANTY; without even the implied warranty of
78%     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
79%     GNU General Public License (file UVMAT/COPYING.txt) for more details.
80%AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
81
82function [ProjData,errormsg]=proj_field(FieldData,ObjectData)
83errormsg='';%default
84%% case of no projection (object is used only as graph display)
85if isfield(ObjectData,'ProjMode') && (isequal(ObjectData.ProjMode,'none')||isequal(ObjectData.ProjMode,'mask_inside')||isequal(ObjectData.ProjMode,'mask_outside'))
86    ProjData=[];
87    return
88end
89
90%% in the absence of object Type or projection mode, or object coordinaes, the input field is just tranfered without change
91if ~isfield(ObjectData,'Type')||~isfield(ObjectData,'ProjMode')
92    ProjData=FieldData;
93    return
94end
95if ~isfield(ObjectData,'Coord')
96    if strcmp(ObjectData.Type,'plane')
97        ObjectData.Coord=[0 0 0];%default
98    else
99        ProjData=FieldData;
100        return
101    end
102end
103       
104%% OBSOLETE
105if isfield(ObjectData,'XMax') && ~isempty(ObjectData.XMax)
106    ObjectData.RangeX(1)=ObjectData.XMax;
107end
108if isfield(ObjectData,'XMin') && ~isempty(ObjectData.XMin)
109    ObjectData.RangeX(2)=ObjectData.XMin;
110end
111if isfield(ObjectData,'YMax') && ~isempty(ObjectData.YMax)
112    ObjectData.RangeY(1)=ObjectData.YMax;
113end
114if isfield(ObjectData,'YMin') && ~isempty(ObjectData.YMin)
115    ObjectData.RangeY(2)=ObjectData.YMin;
116end
117if isfield(ObjectData,'ZMax') && ~isempty(ObjectData.ZMax)
118    ObjectData.RangeZ(1)=ObjectData.ZMax;
119end
120if isfield(ObjectData,'ZMin') && ~isempty(ObjectData.ZMin)
121    ObjectData.RangeZ(2)=ObjectData.ZMin;
122end
123%%%%%%%%%%
124
125%% apply projection depending on the object style
126switch ObjectData.Type
127    case 'points'
128    [ProjData,errormsg]=proj_points(FieldData,ObjectData);
129    case {'line','polyline'}
130     [ProjData,errormsg] = proj_line(FieldData,ObjectData);
131    case {'polygon','rectangle','ellipse'}
132        if isequal(ObjectData.ProjMode,'inside')||isequal(ObjectData.ProjMode,'outside')
133            [ProjData,errormsg] = proj_patch(FieldData,ObjectData);
134        else
135            [ProjData,errormsg] = proj_line(FieldData,ObjectData);
136        end
137    case 'plane'
138            [ProjData,errormsg] = proj_plane(FieldData,ObjectData);
139    case 'volume'
140        [ProjData,errormsg] = proj_volume(FieldData,ObjectData);
141end
142
143%-----------------------------------------------------------------
144%project on a set of points
145function  [ProjData,errormsg]=proj_points(FieldData,ObjectData)%%
146%-------------------------------------------------------------------
147
148siz=size(ObjectData.Coord);
149width=0;
150if isfield(ObjectData,'Range')
151    width=ObjectData.Range(1,2);
152end
153if isfield(ObjectData,'RangeX')&&~isempty(ObjectData.RangeX)
154    width=max(ObjectData.RangeX);
155end
156if isfield(ObjectData,'RangeY')&&~isempty(ObjectData.RangeY)
157    width=max(width,max(ObjectData.RangeY));
158end
159if isfield(ObjectData,'RangeZ')&&~isempty(ObjectData.RangeZ)
160    width=max(width,max(ObjectData.RangeZ));
161end
162if isequal(ObjectData.ProjMode,'projection')
163    if width==0
164        errormsg='projection range around points needed';
165        return
166    end
167elseif  ~isequal(ObjectData.ProjMode,'interp')
168    errormsg=(['ProjMode option ' ObjectData.ProjMode ' not available in proj_field']);
169        return
170end
171[ProjData,errormsg]=proj_heading(FieldData,ObjectData);
172ProjData.NbDim=0;
173[CellVarIndex,NbDimCell,VarTypeCell,errormsg]=find_field_indices(FieldData);
174if ~isempty(errormsg)
175    errormsg=['error in proj_field/proj_points:' errormsg];
176    return
177end
178%LOOP ON GROUPS OF VARIABLES SHARING THE SAME DIMENSIONS
179for icell=1:length(CellVarIndex)
180    if NbDimCell(icell)==1
181        continue
182    end
183    VarIndex=CellVarIndex{icell};%  indices of the selected variables in the list FieldData.ListVarName
184    VarType=VarTypeCell{icell};
185    ivar_X=VarType.coord_x;
186    ivar_Y=VarType.coord_y;
187    ivar_Z=VarType.coord_z;
188    ivar_Anc=VarType.ancillary;
189    test_anc(ivar_Anc)=ones(size(ivar_Anc));
190    ivar_F=VarType.warnflag;
191    ivar_FF=VarType.errorflag;
192    VarIndex([ivar_X ivar_Y ivar_Z ivar_Anc ivar_F ivar_FF])=[];% not projected variables removed frlom list
193    if isempty(ivar_X)
194        test_grid=1;%test for input data on regular grid (e.g. image)coordinates     
195    else
196        if length(ivar_X)>1 || length(ivar_Y)>1 || length(ivar_Z)>1
197                 errormsg='multiple coordinate input in proj_field.m';
198                    return
199        end
200        if length(ivar_Y)~=1
201                errormsg='y coordinate not defined in proj_field.m';
202                return
203        end
204        test_grid=0;
205    end
206    ProjData.ListVarName={'Y','X','NbVal'};
207    ProjData.VarDimName={'nb_points','nb_points','nb_points'};
208    ProjData.VarAttribute{1}.Role='ancillary';
209    ProjData.VarAttribute{2}.Role='ancillary';
210    ProjData.VarAttribute{3}.Role='ancillary';
211    for ivar=VarIndex       
212        VarName=FieldData.ListVarName{ivar};
213        ProjData.ListVarName=[ProjData.ListVarName {VarName}];
214        ProjData.VarDimName=[ProjData.VarDimName {'nb_points'}];
215    end
216    if ~test_grid
217        eval(['coord_x=FieldData.' FieldData.ListVarName{ivar_X} ';'])
218        eval(['coord_y=FieldData.' FieldData.ListVarName{ivar_Y} ';'])
219        test3D=0;% TEST 3D CASE : NOT COMPLETED ,  3D CASE : NOT COMPLETED
220        if length(ivar_Z)==1
221            eval(['coord_z=FieldData.' FieldData.ListVarName{ivar_Z} ';'])
222            test3D=1;
223        end
224        if length(ivar_F)>1 || length(ivar_FF)>1
225                 msgbox_uvmat('ERROR','multiple flag input in proj_field.m')
226                    return
227        end     
228        for ipoint=1:siz(1)
229           Xpoint=ObjectData.Coord(ipoint,:);
230           distX=coord_x-Xpoint(1);
231           distY=coord_y-Xpoint(2);         
232           dist=distX.*distX+distY.*distY;
233           indsel=find(dist<width*width);
234           ProjData.X(ipoint,1)=Xpoint(1);
235           ProjData.Y(ipoint,1)=Xpoint(2);
236           if isequal(length(ivar_FF),1)
237               FFName=FieldData.ListVarName{ivar_FF};
238               eval(['FF=FieldData.' FFName '(indsel);'])
239               %ind_indsel=find(~FF);
240               indsel=indsel(~FF);
241           end
242           ProjData.NbVal(ipoint,1)=length(indsel);
243            for ivar=VarIndex
244               VarName=FieldData.ListVarName{ivar};
245               if isempty(indsel)
246                    eval(['ProjData.' VarName '(ipoint,1)=NaN;'])
247               else
248                    eval(['Var=FieldData.' VarName '(indsel);'])
249                    eval(['ProjData.' VarName '(ipoint,1)=mean(Var);'])
250                    if isequal(ObjectData.ProjMode,'interp')
251                         ProjData.(VarName)(ipoint,1)=griddata_uvmat(coord_x(indsel),coord_y(indsel),Var,Xpoint(1),Xpoint(2));
252                    end
253               end
254            end
255        end
256    else
257        %DimIndices=FieldData.VarDimIndex{VarIndex(1)};%indices of the dimensions of the first variable (common to all variables in the cell)
258        %case of structured coordinates
259        if  numel(VarType.coord)>=2 & VarType.coord(1:2) > 0;
260            AYName=FieldData.ListVarName{VarType.coord(1)};
261            AXName=FieldData.ListVarName{VarType.coord(2)};
262            eval(['AX=FieldData.' AXName ';']);% set of x positions
263            eval(['AY=FieldData.' AYName ';']);% set of y positions 
264            AName=FieldData.ListVarName{VarIndex(1)};
265            eval(['A=FieldData.' AName ';']);% scalar
266            npxy=size(A);
267
268% %             nbcolor=1; %default
269%             for idim=1:length(ListDimName)
270%                 DimName=ListDimName{idim};
271%                 if isequal(DimName,'rgb')|isequal(DimName,'nb_coord')|isequal(DimName,'nb_coord_i')
272%                    nbcolor=npxy(idim);
273%                    DimIndices(idim)=[];
274%                    npxy(idim)=[];
275%                 end
276%                 if isequal(DimName,'nb_coord_j')% NOTE: CASE OF TENSOR NOT TREATED
277%                     DimIndices(idim)=[];
278%                     npxy(idim)=[];
279%                 end
280%             end 
281            ind_1=find(npxy==1);
282            %DimIndices(ind_1)=[]; %suppress singleton dimensions
283%             indxy=find(DimVarIndex(DimIndices));%select dimension variables (DimIndices non zero)
284            %NbDim=length(DimIndices)%number of space dimensions
285            NbDim=numel(VarType.coord);
286            Coord_z=[];
287            Coord_y=[];
288            Coord_x=[];   
289            for idim=1:NbDim %loop on space dimensions
290                test_interp(idim)=0;%test for coordiate interpolation (non regular grid), =0 by default
291                test_coord(idim)=0;%test for defined coordinates, =0 by default
292                %ivar=DimVarIndex(DimIndices(idim));% index of the variable corresponding to the current dimension
293                ivar=VarType.coord(idim);
294%                 if ~isequal(ivar,0)%  a variable corresponds to the current dimension
295                    eval(['Coord{idim}=FieldData.' FieldData.ListVarName{ivar} ';']) ;% position for the first index
296                    if numel(Coord{idim})==2
297                       DCoord_min(idim)= (Coord{idim}(2)-Coord{idim}(1))/(npxy(idim)-1);
298                    else
299                        DCoord=diff(Coord{idim});
300                        DCoord_min(idim)=min(DCoord);
301                        DCoord_max=max(DCoord);
302                        test_direct(idim)=DCoord_max>0;% =1 for increasing values, 0 otherwise
303                        test_direct_min=DCoord_min(idim)>0;% =1 for increasing values, 0 otherwise
304                        if ~isequal(test_direct(idim),test_direct_min)
305                            errormsg=['non monotonic dimension variable # ' num2str(idim)  ' in proj_field.m'];
306                                    return
307                        end               
308                        test_interp(idim)=(DCoord_max-DCoord_min(idim))> 0.0001*abs(DCoord_max);% test grid regularity
309                        test_coord(idim)=1;
310                    end
311%                 else  % no variable associated with the first dimension, look fo variable  attributes Coord_1, _2 or _3
312%                     Coord_i_str=['Coord_' num2str(idim)];
313%                     DCoord_min(idim)=1;%default
314%                     Coord{idim}=[0.5 npxy(idim)];
315%                     test_direct(idim)=1;
316%                 end
317            end
318            DX=DCoord_min(2);
319            DY=DCoord_min(1);
320            for ipoint=1:siz(1)
321                xwidth=width/(abs(DX));
322                ywidth=width/(abs(DY));
323                i_min=round((ObjectData.Coord(ipoint,1)-Coord{2}(1))/DX+0.5-xwidth); %minimum index of the selected region
324                i_min=max(1,i_min);%restrict to field limit
325                i_plus=round((ObjectData.Coord(ipoint,1)-Coord{2}(1))/DX+0.5+xwidth);
326                i_plus=min(npxy(2),i_plus); %restrict to field limit
327                j_min=round((ObjectData.Coord(ipoint,2)-Coord{1}(1))/DY-ywidth+0.5);
328                j_min=max(1,j_min);
329                j_plus=round((ObjectData.Coord(ipoint,2)-Coord{1}(1))/DY+ywidth+0.5);
330                j_plus=min(npxy(1),j_plus);
331                ProjData.X(ipoint,1)=ObjectData.Coord(ipoint,1);
332                ProjData.Y(ipoint,1)=ObjectData.Coord(ipoint,2);
333                i_int=(i_min:i_plus);
334                j_int=(j_min:j_plus);
335                ProjData.NbVal(ipoint,1)=length(j_int)*length(i_int);
336                if isempty(i_int) || isempty(j_int)
337                   for ivar=VarIndex   
338                        eval(['ProjData.' FieldData.ListVarName{ivar} '(ipoint,:)=NaN;']);
339                   end
340                   errormsg=['no data points in the selected projection range ' num2str(width) ];
341                else
342                    %TODO: introduce circle in the selected subregion
343                    %[I,J]=meshgrid([1:j_int],[1:i_int]);
344                    for ivar=VarIndex   
345                        eval(['Avalue=FieldData.' FieldData.ListVarName{ivar} '(j_int,i_int,:);']);
346                        eval(['ProjData.' FieldData.ListVarName{ivar} '(ipoint,:)=mean(mean(Avalue));']);
347                    end
348                end
349            end
350        end
351   end
352end
353
354%-----------------------------------------------------------------
355%project in a patch
356function  [ProjData,errormsg]=proj_patch(FieldData,ObjectData)%%
357%-------------------------------------------------------------------
358[ProjData,errormsg]=proj_heading(FieldData,ObjectData);
359
360objectfield=fieldnames(ObjectData);
361widthx=0;
362widthy=0;
363if isfield(ObjectData,'RangeX')&~isempty(ObjectData.RangeX)
364    widthx=max(ObjectData.RangeX);
365end
366if isfield(ObjectData,'RangeY')&~isempty(ObjectData.RangeY)
367    widthy=max(ObjectData.RangeY);
368end
369
370%A REVOIR, GENERALISER: UTILISER proj_line
371ProjData.NbDim=1;
372ProjData.ListVarName={};
373ProjData.VarDimName={};
374ProjData.VarAttribute={};
375
376Mesh=zeros(1,numel(FieldData.ListVarName));
377if isfield (FieldData,'VarAttribute')
378    %ProjData.VarAttribute=FieldData.VarAttribute;%list of variable attribute names
379    for iattr=1:length(FieldData.VarAttribute)%initialization of variable attribute values
380%         ProjData.VarAttribute{iattr}={};
381        if isfield(FieldData.VarAttribute{iattr},'Unit')
382            unit{iattr}=FieldData.VarAttribute{iattr}.Unit;
383        end
384        if isfield(FieldData.VarAttribute{iattr},'Mesh')
385            Mesh(iattr)=FieldData.VarAttribute{iattr}.Mesh;
386        end
387    end
388end
389
390%group the variables (fields of 'FieldData') in cells of variables with the same dimensions
391testfalse=0;
392ListIndex={};
393% DimVarIndex=0;%initilise list of indices for dimension variables
394idimvar=0;
395[CellVarIndex,NbDim,VarTypeCell,errormsg]=find_field_indices(FieldData);
396if ~isempty(errormsg)
397    errormsg=['error in proj_field/proj_patch:' errormsg];
398    return
399end
400
401%LOOP ON GROUPS OF VARIABLES SHARING THE SAME DIMENSIONS
402dimcounter=0;
403for icell=1:length(CellVarIndex)
404    testX=0;
405    testY=0;
406    test_Amat=0;
407    testfalse=0;
408    VarIndex=CellVarIndex{icell};%  indices of the selected variables in the list FieldData.ListVarName
409    VarType=VarTypeCell{icell};
410  %  DimIndices=FieldData.VarDimIndex{VarIndex(1)};%indices of the dimensions of the first variable (common to all variables in the cell)
411    if NbDim(icell)~=2% proj_patch acts only on fields of space dimension 2
412        continue
413    end
414    testX=~isempty(VarType.coord_x) && ~isempty(VarType.coord_y);
415    testfalse=~isempty(VarType.errorflag);
416    testproj(VarIndex)=zeros(size(VarIndex));%default
417    testproj(VarType.scalar)=1;
418    testproj(VarType.vector_x)=1;
419    testproj(VarType.vector_y)=1;
420    testproj(VarType.vector_z)=1;
421    testproj(VarType.image)=1;
422    testproj(VarType.color)=1;
423    VarIndex=VarIndex(find(testproj(VarIndex)));%select only the projected variables
424    if testX %case of unstructured coordinates
425         eval(['nbpoint=numel(FieldData.' FieldData.ListVarName{VarIndex(1)} ');'])
426         for ivar=[VarIndex VarType.coord_x VarType.coord_y VarType.errorflag]
427               VarName=FieldData.ListVarName{ivar};
428            eval(['FieldData.' VarName '=reshape(FieldData.' VarName ',nbpoint,1);'])
429         end
430         XName=FieldData.ListVarName{VarType.coord_x};
431         YName=FieldData.ListVarName{VarType.coord_y};
432         eval(['coord_x=FieldData.' XName ';'])
433         eval(['coord_y=FieldData.' YName ';'])
434    end
435    if testfalse
436        FFName=FieldData.ListVarName{VarType.errorflag};
437        eval(['errorflag=FieldData.' FFName ';'])
438    end
439    % image or 2D matrix
440    if numel(VarType.coord)>=2 & VarType.coord(1:2) > 0;
441        test_Amat=1;% test for image or 2D matrix
442        AYName=FieldData.ListVarName{VarType.coord(1)};
443        AXName=FieldData.ListVarName{VarType.coord(2)};
444        eval(['AX=FieldData.' AXName ';'])% x coordinate
445        eval(['AY=FieldData.' AYName ';'])% y coordinate
446        VarName=FieldData.ListVarName{VarIndex(1)};
447        eval(['DimValue=size(FieldData.' VarName ');'])
448       if length(AX)==2
449           AX=linspace(AX(1),AX(end),DimValue(2));
450       end
451       if length(AY)==2
452           AY=linspace(AY(1),AY(end),DimValue(1));
453       end
454%         for idim=1:length(DimValue)       
455%             Coord_i_str=['Coord_' num2str(idim)];
456%             DCoord_min(idim)=1;%default
457%             Coord{idim}=[0.5 DimValue(idim)];
458%             test_direct(idim)=1;
459%         end
460%         AX=linspace(Coord{2}(1),Coord{2}(2),DimValue(2));
461%         AY=linspace(Coord{1}(1),Coord{1}(2),DimValue(1));  %TODO : 3D case
462        testcolor=find(numel(DimValue)==3);
463        if length(DimValue)==3
464            testcolor=1;
465            npxy(3)=3;
466        else
467            testcolor=0;
468            npxy(3)=1;
469        end
470        [Xi,Yi]=meshgrid(AX,AY);
471        npxy(1)=length(AY);
472        npxy(2)=length(AX);
473        Xi=reshape(Xi,npxy(1)*npxy(2),1);
474        Yi=reshape(Yi,npxy(1)*npxy(2),1);
475        for ivar=1:length(VarIndex)
476            VarName=FieldData.ListVarName{VarIndex(ivar)};
477            eval(['FieldData.' VarName '=reshape(FieldData.' VarName ',npxy(1)*npxy(2),npxy(3));']); % keep only non false vectors
478        end
479    end
480%select the indices in the range of action
481    testin=[];%default
482    if isequal(ObjectData.Type,'rectangle')
483%            if ~isfield(ObjectData,'RangeX')|~isfield(ObjectData,'RangeY')
484%                 errormsg='rectangle half sides RangeX and RangeY needed'
485%                 return
486%            end
487       if testX
488            distX=abs(coord_x-ObjectData.Coord(1,1));
489            distY=abs(coord_y-ObjectData.Coord(1,2));
490            testin=distX<widthx & distY<widthy;
491       elseif test_Amat
492           distX=abs(Xi-ObjectData.Coord(1,1));
493           distY=abs(Yi-ObjectData.Coord(1,2));
494           testin=distX<widthx & distY<widthy;
495       end
496    elseif isequal(ObjectData.Type,'polygon')
497        if testX
498            testin=inpolygon(coord_x,coord_y,ObjectData.Coord(:,1),ObjectData.Coord(:,2));
499        elseif test_Amat
500           testin=inpolygon(Xi,Yi,ObjectData.Coord(:,1),ObjectData.Coord(:,2));
501       else%calculate the scalar
502           testin=[]; %A REVOIR
503       end
504    elseif isequal(ObjectData.Type,'ellipse')
505       X2Max=widthx*widthx;
506       Y2Max=(widthy)*(widthy);
507       if testX
508            distX=(coord_x-ObjectData.Coord(1,1));
509            distY=(coord_y-ObjectData.Coord(1,2));
510            testin=(distX.*distX/X2Max+distY.*distY/Y2Max)<1;
511       elseif test_Amat %case of usual 2x2 matrix
512           distX=(Xi-ObjectData.Coord(1,1));
513           distY=(Yi-ObjectData.Coord(1,2));
514           testin=(distX.*distX/X2Max+distY.*distY/Y2Max)<1;
515       end
516    end
517    %selected indices
518    if isequal(ObjectData.ProjMode,'outside')
519            testin=~testin;
520    end
521    if testfalse
522        testin=testin & (errorflag==0); % keep only non false vectors         
523    end
524    indsel=find(testin);
525    for ivar=VarIndex
526        if testproj(ivar)
527            VarName=FieldData.ListVarName{ivar};
528            eval(['ProjData.' VarName 'Mean=mean(mean(double(FieldData.' VarName '(indsel,:))));']); % keep only non false vectors
529            eval(['ProjData.' VarName 'Min=min(min(double(FieldData.' VarName '(indsel,:))));']); % keep only non false vectors
530            eval(['ProjData.' VarName 'Max=max(max(double(FieldData.' VarName '(indsel,:))));']); % keep only non false vectors
531            if isequal(Mesh(ivar),0)
532                eval(['[ProjData.' VarName 'Histo,ProjData.' VarName ']=hist(double(FieldData.' VarName '(indsel,:)),100);']); % default histogram with 100 bins
533            else
534                eval(['ProjData.' VarName '=(ProjData.' VarName 'Min+Mesh(ivar)/2:Mesh(ivar):ProjData.' VarName 'Max);']); % list of bin values
535                eval(['ProjData.' VarName 'Histo=hist(double(FieldData.' VarName '(indsel,:)),ProjData.' VarName ');']); % histogram at predefined bin positions
536            end
537            ProjData.ListVarName=[ProjData.ListVarName {VarName} {[VarName 'Histo']} {[VarName 'Mean']} {[VarName 'Min']} {[VarName 'Max']}];
538            if test_Amat && testcolor
539                 ProjData.VarDimName=[ProjData.VarDimName  {VarName} {{VarName,'rgb'}} {'rgb'}];%{{'nb_point','rgb'}};
540            else
541               ProjData.VarDimName=[ProjData.VarDimName {VarName} {VarName} {'nbpoint'} {'nbpoint'} {'nbpoint'}];
542            end
543            ProjData.VarAttribute=[ProjData.VarAttribute FieldData.VarAttribute{ivar} {[]} {[]} {[]} {[]}];
544        end
545    end
546%     if test_Amat & testcolor
547%        %ProjData.ListDimName=[ProjData.ListDimName {'rgb'}];
548%       % ProjData.DimValue=[ProjData.DimValue 3];
549%       % ProjData.VarDimIndex={[1 2]};
550%        ProjData.VarDimName=[ProjData.VarDimName {VarName} {VarName,'rgb'}];%{{'nb_point','rgb'}};
551%        ProjData.VarDimName
552%     end
553end
554
555
556%-----------------------------------------------------------------
557%project on a line
558% AJOUTER flux,circul,error
559function  [ProjData,errormsg] = proj_line(FieldData, ObjectData)
560%-----------------------------------------------------------------
561[ProjData,errormsg]=proj_heading(FieldData,ObjectData);%transfer global attributes
562if ~isempty(errormsg)
563    return
564end
565ProjData.NbDim=1;
566%initialisation of the input parameters and defaultoutput
567ProjMode='projection';%direct projection on the line by default
568if isfield(ObjectData,'ProjMode'),ProjMode=ObjectData.ProjMode; end;
569% ProjAngle=90; %90 degrees projection by default
570% if isfield(FieldData,'ProjAngle'),ProjAngle=ObjectData.ProjAngle; end;
571width=0;%default width of the projection band
572if isfield(ObjectData,'Range')&&size(ObjectData.Range,2)>=2
573    width=abs(ObjectData.Range(1,2));
574end
575if isfield(ObjectData,'RangeY')
576    width=max(ObjectData.RangeY);
577end
578
579% default output
580errormsg=[];%default
581Xline=[];
582flux=0;
583circul=0;
584liny=ObjectData.Coord(:,2);
585siz_line=size(ObjectData.Coord);
586if siz_line(1)<2
587    return% line needs at least 2 points to be defined
588end
589testfalse=0;
590ListIndex={};
591
592%angles of the polyline and boundaries of action
593dlinx=diff(ObjectData.Coord(:,1));
594dliny=diff(ObjectData.Coord(:,2));
595theta=angle(dlinx+i*dliny);%angle of each segment
596theta(siz_line(1))=theta(siz_line(1)-1);
597% determine a rectangles at +-width from the line (only used for the ProjMode='projection or 'filter')
598if isequal(ProjMode,'projection') || isequal(ProjMode,'filter')
599    xsup(1)=ObjectData.Coord(1,1)-width*sin(theta(1));
600    xinf(1)=ObjectData.Coord(1,1)+width*sin(theta(1));
601    ysup(1)=ObjectData.Coord(1,2)+width*cos(theta(1));
602    yinf(1)=ObjectData.Coord(1,2)-width*cos(theta(1));
603    for ip=2:siz_line(1)
604        xsup(ip)=ObjectData.Coord(ip,1)-width*sin((theta(ip)+theta(ip-1))/2)/cos((theta(ip-1)-theta(ip))/2);
605        xinf(ip)=ObjectData.Coord(ip,1)+width*sin((theta(ip)+theta(ip-1))/2)/cos((theta(ip-1)-theta(ip))/2);
606        ysup(ip)=ObjectData.Coord(ip,2)+width*cos((theta(ip)+theta(ip-1))/2)/cos((theta(ip-1)-theta(ip))/2);
607        yinf(ip)=ObjectData.Coord(ip,2)-width*cos((theta(ip)+theta(ip-1))/2)/cos((theta(ip-1)-theta(ip))/2);
608    end
609end
610
611%group the variables (fields of 'FieldData') in cells of variables with the same dimensions
612[CellVarIndex,NbDim,VarTypeCell,errormsg]=find_field_indices(FieldData);
613if ~isempty(errormsg)
614    errormsg=['error in proj_field/proj_line:' errormsg];
615    return
616end
617
618% loop on variable cells with the same space dimension
619ProjData.ListVarName={};
620ProjData.VarDimName={};
621for icell=1:length(CellVarIndex)
622    VarIndex=CellVarIndex{icell};%  indices of the selected variables in the list FieldData.ListVarName
623    VarType=VarTypeCell{icell}; %types of variables
624    if NbDim(icell)~=2% proj_line acts only on fields of space dimension 2, TODO: check 3D case
625        continue
626    end
627    testX=~isempty(VarType.coord_x) && ~isempty(VarType.coord_y);% test for unstructured coordinates
628    testU=~isempty(VarType.vector_x) && ~isempty(VarType.vector_y);% test for vectors
629    testfalse=~isempty(VarType.errorflag);% test for error flag
630    testproj(VarIndex)=zeros(size(VarIndex));% test =1 for simply projected variables, default =0
631                                             %=0 for vector components, treated separately
632    testproj(VarType.scalar)=1;
633    testproj(VarType.image)=1;
634    testproj(VarType.color)=1;
635    VarIndex=VarIndex(find(testproj(VarIndex)));%select only the projected variables
636    if testU
637         VarIndex=[VarIndex VarType.vector_x VarType.vector_y];%append u and v at the end of the list of variables
638    end
639    %identify vector components   
640    if testU
641        UName=FieldData.ListVarName{VarType.vector_x};
642        VName=FieldData.ListVarName{VarType.vector_y};
643        eval(['vector_x=FieldData.' UName ';'])
644        eval(['vector_y=FieldData.' VName ';'])
645    end 
646    %identify error flag
647    if testfalse
648        FFName=FieldData.ListVarName{VarType.errorflag};
649        eval(['errorflag=FieldData.' FFName ';'])
650    end   
651    % check needed object properties for unstructured positions (position given by the variables with role coord_x, coord_y
652    if testX
653        if  ~isequal(ProjMode,'interp')
654            if width==0
655                errormsg='range of the projection object is missing';
656                return     
657            else
658                lambda=2/(width*width); %smoothing factor used for filter: weight exp(-2) at distance width from the line
659            end
660        end
661        if ~isequal(ProjMode,'projection')
662            if isfield(ObjectData,'DX')&~isempty(ObjectData.DX)
663                DX=abs(ObjectData.DX);%mesh of interpolation points along the line
664            else
665                errormsg='DX missing';
666                return
667            end
668        end
669        XName= FieldData.ListVarName{VarType.coord_x};
670        YName= FieldData.ListVarName{VarType.coord_y};
671        eval(['coord_x=FieldData.' XName ';'])   
672        eval(['coord_y=FieldData.' YName ';'])
673    end   
674    %initiate projection
675    for ivar=1:length(VarIndex)
676        ProjLine{ivar}=[];
677    end
678    XLine=[];
679    linelengthtot=0;
680
681%         circul=0;
682%         flux=0;
683  %%%%%%%  % A FAIRE CALCULER MEAN DES QUANTITES    %%%%%%
684   %case of unstructured coordinates
685    if testX   
686        for ip=1:siz_line(1)-1     %Loop on the segments of the polyline
687            linelength=sqrt(dlinx(ip)*dlinx(ip)+dliny(ip)*dliny(ip)); 
688            %select the vector indices in the range of action
689            if testfalse
690                flagsel=(errorflag==0); % keep only non false vectors
691            else
692                flagsel=ones(size(coord_x));
693            end
694            if isequal(ProjMode,'projection') | isequal(ProjMode,'filter')
695                flagsel=flagsel & ((coord_y -yinf(ip))*(xinf(ip+1)-xinf(ip))>(coord_x-xinf(ip))*(yinf(ip+1)-yinf(ip))) ...
696                & ((coord_y -ysup(ip))*(xsup(ip+1)-xsup(ip))<(coord_x-xsup(ip))*(ysup(ip+1)-ysup(ip))) ...
697                & ((coord_y -yinf(ip+1))*(xsup(ip+1)-xinf(ip+1))>(coord_x-xinf(ip+1))*(ysup(ip+1)-yinf(ip+1))) ...
698                & ((coord_y -yinf(ip))*(xsup(ip)-xinf(ip))<(coord_x-xinf(ip))*(ysup(ip)-yinf(ip)));
699            end
700            indsel=find(flagsel);%indsel =indices of good vectors
701            X_sel=coord_x(indsel);
702            Y_sel=coord_y(indsel);
703            nbvar=0;
704            for iselect=1:numel(VarIndex)-2*testU
705                VarName=FieldData.ListVarName{VarIndex(iselect)};
706                eval(['ProjVar{iselect}=FieldData.' VarName '(indsel);']);%scalar value
707            end   
708            if testU
709                ProjVar{numel(VarIndex)-1}=cos(theta(ip))*vector_x(indsel)+sin(theta(ip))*vector_y(indsel);% longitudinal component
710                ProjVar{numel(VarIndex)}=-sin(theta(ip))*vector_x(indsel)+cos(theta(ip))*vector_y(indsel);%transverse component         
711            end
712            if isequal(ProjMode,'projection')
713                sintheta=sin(theta(ip));
714                costheta=cos(theta(ip));
715                Xproj=(X_sel-ObjectData.Coord(ip,1))*costheta + (Y_sel-ObjectData.Coord(ip,2))*sintheta; %projection on the line
716                [Xproj,indsort]=sort(Xproj);
717                for ivar=1:numel(ProjVar)
718                    if ~isempty(ProjVar{ivar})
719                        ProjVar{ivar}=ProjVar{ivar}(indsort);
720                     end
721                end
722            elseif isequal(ProjMode,'interp') %linear interpolation:
723                npoint=floor(linelength/DX)+1;% nbre of points in the profile (interval DX)
724                Xproj=linelength/(2*npoint):linelength/npoint:linelength-linelength/(2*npoint);
725                xreg=cos(theta(ip))*Xproj+ObjectData.Coord(ip,1);
726                yreg=sin(theta(ip))*Xproj+ObjectData.Coord(ip,2);
727                for ivar=1:numel(ProjVar)
728                     if ~isempty(ProjVar{ivar})
729                        ProjVar{ivar}=griddata_uvmat(X_sel,Y_sel,ProjVar{ivar},xreg,yreg);
730                     end
731                end
732            elseif isequal(ProjMode,'filter') %filtering
733                npoint=floor(linelength/DX)+1;% nbre of points in the profile (interval DX)
734                Xproj=linelength/(2*npoint):linelength/npoint:linelength-linelength/(2*npoint);
735                siz=size(X_sel);
736                xregij=cos(theta(ip))*ones(siz(1),1)*Xproj+ObjectData.Coord(ip,1);
737                yregij=sin(theta(ip))*ones(siz(1),1)*Xproj+ObjectData.Coord(ip,2);
738                xij=X_sel*ones(1,npoint);
739                yij=Y_sel*ones(1,npoint);
740                Aij=exp(-lambda*((xij-xregij).*(xij-xregij)+(yij-yregij).*(yij-yregij)));
741                norm=Aij'*ones(siz(1),1);
742                for ivar=1:numel(ProjVar)
743                     if ~isempty(ProjVar{ivar})
744                        ProjVar{ivar}=Aij'*ProjVar{ivar}./norm;
745                     end
746                end             
747            end
748            %prolongate the total record
749            for ivar=1:numel(ProjVar)
750                  if ~isempty(ProjVar{ivar})
751                     ProjLine{ivar}=[ProjLine{ivar}; ProjVar{ivar}];
752                  end
753            end
754            XLine=[XLine ;(Xproj+linelengthtot)];%along line abscissa
755            linelengthtot=linelengthtot+linelength;
756            %     circul=circul+(sum(U_sel))*linelength/npoint;
757            %     flux=flux+(sum(V_sel))*linelength/npoint;
758        end
759        ProjData.X=XLine';
760        cur_index=1;
761        ProjData.ListVarName=[ProjData.ListVarName {XName}];
762        ProjData.VarDimName=[ProjData.VarDimName {XName}];
763        ProjData.VarAttribute{1}.long_name='abscissa along line';
764        for iselect=1:numel(VarIndex)
765            VarName=FieldData.ListVarName{VarIndex(iselect)};
766            eval(['ProjData.' VarName '=ProjLine{iselect};'])
767            ProjData.ListVarName=[ProjData.ListVarName {VarName}];
768            ProjData.VarDimName=[ProjData.VarDimName {XName}];
769            ProjData.VarAttribute{iselect}=FieldData.VarAttribute{VarIndex(iselect)};
770            if strcmp(ProjMode,'projection')
771                ProjData.VarAttribute{iselect}.Role='discrete';
772            else
773                 ProjData.VarAttribute{iselect}.Role='continuous';
774            end
775        end
776   
777    %case of structured coordinates
778    elseif  numel(VarType.coord)>=2 & VarType.coord(1:2) > 0;
779        if ~isequal(ObjectData.Type,'line')% exclude polyline
780            errormsg=['no  projection available on ' ObjectData.Type 'for structured coordinates']; %
781        else
782            test_Amat=1;%image or 2D matrix
783            test_interp2=0;%default
784%             if ~isempty(VarType.coord_y) 
785            AYName=FieldData.ListVarName{VarType.coord(1)};
786            AXName=FieldData.ListVarName{VarType.coord(2)};
787            eval(['AX=FieldData.' AXName ';']);% set of x positions
788            eval(['AY=FieldData.' AYName ';']);% set of y positions 
789            AName=FieldData.ListVarName{VarIndex(1)};
790            eval(['A=FieldData.' AName ';']);% scalar
791            npxy=size(A);
792            npx=npxy(2);
793            npy=npxy(1);
794            if numel(AX)==2
795                DX=(AX(2)-AX(1))/(npx-1);
796            else
797                DX_vec=diff(AX);
798                DX=max(DX_vec);
799                DX_min=min(DX_vec);
800                if (DX-DX_min)>0.0001*abs(DX)
801                    test_interp2=1;
802                    DX=DX_min;
803                end   
804            end
805            if numel(AY)==2
806                DY=(AY(2)-AY(1))/(npy-1);
807            else
808                DY_vec=diff(AY);
809                DY=max(DY_vec);
810                DY_min=min(DY_vec);
811                if (DY-DY_min)>0.0001*abs(DY)
812                   test_interp2=1;
813                    DY=DY_min;
814                end     
815            end             
816            AXI=linspace(AX(1),AX(end), npx);%set of  x  positions for the interpolated input data
817            AYI=linspace(AY(1),AY(end), npy);%set of  x  positions for the interpolated input data
818            if isfield(ObjectData,'DX')
819                DXY_line=ObjectData.DX;%mesh on the projection line
820            else
821                DXY_line=sqrt(abs(DX*DY));% mesh on the projection line
822            end
823            dlinx=ObjectData.Coord(2,1)-ObjectData.Coord(1,1);
824            dliny=ObjectData.Coord(2,2)-ObjectData.Coord(1,2);
825            linelength=sqrt(dlinx*dlinx+dliny*dliny);
826            theta=angle(dlinx+i*dliny);%angle of the line   
827            if isfield(FieldData,'RangeX')
828                XMin=min(FieldData.RangeX);%shift of the origin on the line
829            else
830                XMin=0;
831            end
832            eval(['ProjData.' AXName '=linspace(XMin,XMin+linelength,linelength/DXY_line+1);'])%abscissa of the new pixels along the line
833            y=linspace(-width,width,2*width/DXY_line+1);%ordintes of the new pixels (coordinate across the line)
834            eval(['npX=length(ProjData.' AXName ');'])
835            npY=length(y); %TODO: utiliser proj_grid
836            eval(['[X,Y]=meshgrid(ProjData.' AXName ',y);'])%grid in the line coordinates
837            XIMA=ObjectData.Coord(1,1)+(X-XMin)*cos(theta)-Y*sin(theta);
838            YIMA=ObjectData.Coord(1,2)+(X-XMin)*sin(theta)+Y*cos(theta);
839            XIMA=(XIMA-AX(1))/DX+1;%  index of the original image along x
840            YIMA=(YIMA-AY(1))/DY+1;% index of the original image along y
841            XIMA=reshape(round(XIMA),1,npX*npY);%indices reorganized in 'line'
842            YIMA=reshape(round(YIMA),1,npX*npY);
843            flagin=XIMA>=1 & XIMA<=npx & YIMA >=1 & YIMA<=npy;%flagin=1 inside the original image
844            ind_in=find(flagin);
845            ind_out=find(~flagin);
846            ICOMB=(XIMA-1)*npy+YIMA;
847            ICOMB=ICOMB(flagin);%index corresponding to XIMA and YIMA in the aligned original image vec_A
848            nbcolor=1; %color images
849            if numel(npxy)==2
850                nbcolor=1;
851            elseif length(npxy)==3
852                nbcolor=npxy(3);
853            else
854                errormsg='multicomponent field not projected';
855                display(errormsg)
856                return
857            end
858            nbvar=length(ProjData.ListVarName);% number of var from previous cells
859            ProjData.ListVarName=[ProjData.ListVarName {AXName}];
860            ProjData.VarDimName=[ProjData.VarDimName {AXName}];
861            for ivar=VarIndex
862                VarName{ivar}=FieldData.ListVarName{ivar};
863                if test_interp2% interpolate on new grid
864                    eval(['FieldData.' VarName{ivar} '=interp2(FieldData.' AXName ',FieldData.' AYName ',FieldData.' VarName{ivar} ',AXI,AYI'');']) %TO TEST
865                end
866                eval(['vec_A=reshape(squeeze(FieldData.' VarName{ivar} '),npx*npy,nbcolor);']) %put the original image in colum
867                if nbcolor==1
868                    vec_B(ind_in)=vec_A(ICOMB);
869                    vec_B(ind_out)=zeros(size(ind_out));
870                    A_out=reshape(vec_B,npY,npX);
871                    eval(['ProjData.' VarName{ivar} '=((sum(A_out,1)/npY))'';']);
872                elseif nbcolor==3
873                    vec_B(ind_in,1:3)=vec_A(ICOMB,:);
874                    vec_B(ind_out,1)=zeros(size(ind_out));
875                    vec_B(ind_out,2)=zeros(size(ind_out));
876                    vec_B(ind_out,3)=zeros(size(ind_out));
877                    A_out=reshape(vec_B,npY,npX,nbcolor);
878                    eval(['ProjData.' VarName{ivar} '=squeeze(sum(A_out,1)/npY);']);
879                end 
880                ProjData.ListVarName=[ProjData.ListVarName VarName{ivar} ];
881                ProjData.VarDimName=[ProjData.VarDimName {AXName}];%to generalize with the initial name of the x coordinate
882                ProjData.VarAttribute{ivar}.Role='continuous';% for plot with continuous line
883            end
884            if testU
885                 eval(['vector_x =ProjData.' VarName{VarType.vector_x} ';'])
886                 eval(['vector_y =ProjData.' VarName{VarType.vector_y} ';'])
887                 eval(['ProjData.' VarName{VarType.vector_x} '=cos(theta)*vector_x+sin(theta)*vector_y;'])
888                 eval(['ProjData.' VarName{VarType.vector_y} '=-sin(theta)*vector_x+cos(theta)*vector_y;'])
889            end
890            ProjData.VarAttribute{nbvar+1}.long_name='abscissa along line';
891            if nbcolor==3
892                ProjData.VarDimName{end}={AXName,'rgb'};
893            end
894        end     
895    end
896end
897
898% %shotarter case for horizontal or vertical line (A FAIRE
899% %     Rangx=[0.5 npx-0.5];%image coordiantes of corners
900% %     Rangy=[npy-0.5 0.5];
901% %     if isfield(Calib,'Pxcmx')&isfield(Calib,'Pxcmy')%old calib
902% %         Rangx=Rangx/Calib.Pxcmx;
903% %         Rangy=Rangy/Calib.Pxcmy;
904% %     else
905% %         [Rangx]=phys_XYZ(Calib,Rangx,[0.5 0.5],[0 0]);%case of translations without rotation and quadratic deformation
906% %         [xx,Rangy]=phys_XYZ(Calib,[0.5 0.5],Rangy,[0 0]);
907% %     end
908%
909% %     test_scal=0;%default% 3- 'UserData':(get(handles.Tag,'UserData')
910
911
912%-----------------------------------------------------------------
913%project on a plane
914% AJOUTER flux,circul,error
915 function  [ProjData,errormsg] = proj_plane(FieldData, ObjectData)
916%-----------------------------------------------------------------
917
918%% initialisation of the input parameters of the projection plane
919ProjMode='projection';%direct projection by default
920if isfield(ObjectData,'ProjMode'),ProjMode=ObjectData.ProjMode; end;
921
922%axis origin
923if isempty(ObjectData.Coord)
924    ObjectData.Coord(1,1)=0;%origin of the plane set to [0 0] by default
925    ObjectData.Coord(1,2)=0;
926    ObjectData.Coord(1,3)=0;
927end
928
929%rotation angles
930PlaneAngle=[0 0 0];
931norm_plane=[0 0 1];
932cos_om=1;
933sin_om=0;
934test90x=0;%=1 for 90 degree rotation alround x axis
935test90y=0;%=1 for 90 degree rotation alround y axis
936if isfield(ObjectData,'Angle')&& isequal(size(ObjectData.Angle),[1 3])&& ~isequal(ObjectData.Angle,[0 0 0])
937    test90y=isequal(ObjectData.Angle,[0 90 0]);
938    PlaneAngle=(pi/180)*ObjectData.Angle;
939    om=norm(PlaneAngle);%norm of rotation angle in radians
940    OmAxis=PlaneAngle/om; %unit vector marking the rotation axis
941    cos_om=cos(om);
942    sin_om=sin(om);
943    coeff=OmAxis(3)*(1-cos_om);
944    %components of the unity vector norm_plane normal to the projection plane
945    norm_plane(1)=OmAxis(1)*coeff+OmAxis(2)*sin_om;
946    norm_plane(2)=OmAxis(2)*coeff-OmAxis(1)*sin_om;
947    norm_plane(3)=OmAxis(3)*coeff+cos_om;
948end
949testangle=~isequal(PlaneAngle,[0 0 0]);% && ~test90y && ~test90x;%=1 for slanted plane
950
951%mesh sizes DX and DY
952DX=0;
953DY=0; %default
954if isfield(ObjectData,'DX') && ~isempty(ObjectData.DX)
955     DX=abs(ObjectData.DX);%mesh of interpolation points
956end
957if isfield(ObjectData,'DY') && ~isempty(ObjectData.DY)
958     DY=abs(ObjectData.DY);%mesh of interpolation points
959end
960if  ~strcmp(ProjMode,'projection') && (DX==0||DY==0)
961        errormsg='DX or DY missing';
962        display(errormsg)
963        return
964end
965
966%extrema along each axis
967testXMin=0;
968testXMax=0;
969testYMin=0;
970testYMax=0;
971if isfield(ObjectData,'RangeX')
972        XMin=min(ObjectData.RangeX);
973        XMax=max(ObjectData.RangeX);
974        testXMin=XMax>XMin;
975        testXMax=1;
976end
977if isfield(ObjectData,'RangeY')
978        YMin=min(ObjectData.RangeY);
979        YMax=max(ObjectData.RangeY);
980        testYMin=YMax>YMin;
981        testYMax=1;
982end
983width=0;%default width of the projection band
984if isfield(ObjectData,'RangeZ')
985        width=max(ObjectData.RangeZ);
986end
987
988% initiate Matlab  structure for physical field
989[ProjData,errormsg]=proj_heading(FieldData,ObjectData);
990ProjData.NbDim=2;
991ProjData.ListVarName={};
992ProjData.VarDimName={};
993if ~isequal(DX,0)&& ~isequal(DY,0)
994    ProjData.Mesh=sqrt(DX*DY);%define typical data mesh, useful for mouse selection in plots
995elseif isfield(FieldData,'Mesh')
996    ProjData.Mesh=FieldData.Mesh;
997end
998
999error=0;%default
1000flux=0;
1001testfalse=0;
1002ListIndex={};
1003
1004%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1005%% group the variables (fields of 'FieldData') in cells of variables with the same dimensions
1006%-----------------------------------------------------------------
1007idimvar=0;
1008
1009[CellVarIndex,NbDimVec,VarTypeCell,errormsg]=find_field_indices(FieldData);
1010if ~isempty(errormsg)
1011    errormsg=['error in proj_field/proj_plane:' errormsg];
1012    return
1013end
1014
1015% LOOP ON GROUPS OF VARIABLES SHARING THE SAME DIMENSIONS
1016% CellVarIndex=cells of variable index arrays
1017ivar_new=0; % index of the current variable in the projected field
1018icoord=0;
1019nbcoord=0;%number of added coordinate variables brought by projection
1020nbvar=0;
1021for icell=1:length(CellVarIndex)
1022    NbDim=NbDimVec(icell);
1023    if NbDim<2
1024        continue
1025    end
1026    VarIndex=CellVarIndex{icell};%  indices of the selected variables in the list FieldData.ListVarName
1027    VarType=VarTypeCell{icell};
1028    ivar_X=VarType.coord_x;
1029    ivar_Y=VarType.coord_y;
1030    ivar_Z=VarType.coord_z;
1031    ivar_U=VarType.vector_x;
1032    ivar_V=VarType.vector_y;
1033    ivar_W=VarType.vector_z;
1034    ivar_C=VarType.scalar ;
1035    ivar_Anc=VarType.ancillary;
1036    test_anc=zeros(size(VarIndex));
1037    test_anc(ivar_Anc)=ones(size(ivar_Anc));
1038    ivar_F=VarType.warnflag;
1039    ivar_FF=VarType.errorflag;
1040    testX=~isempty(ivar_X) && ~isempty(ivar_Y);
1041    DimCell=FieldData.VarDimName{VarIndex(1)};
1042    if ischar(DimCell)
1043        DimCell={DimCell};%name of dimensions
1044    end
1045   
1046    %% case of input fields with unstructured coordinates
1047    if testX
1048        XName=FieldData.ListVarName{ivar_X};
1049        YName=FieldData.ListVarName{ivar_Y};
1050        eval(['coord_x=FieldData.' XName ';'])
1051        eval(['coord_y=FieldData.' YName ';'])
1052        if length(ivar_Z)==1
1053            ZName=FieldData.ListVarName{ivar_Z};
1054            eval(['coord_z=FieldData.' ZName ';'])
1055        end
1056       
1057        % translate  initial coordinates
1058        coord_x=coord_x-ObjectData.Coord(1,1);
1059        coord_y=coord_y-ObjectData.Coord(1,2);
1060        if ~isempty(ivar_Z)
1061            coord_z=coord_z-ObjectData.Coord(1,3);
1062        end
1063       
1064        % selection of the vectors in the projection range (3D case)
1065        if length(ivar_Z)==1 &&  width > 0
1066            %components of the unitiy vector normal to the projection plane
1067            fieldZ=norm_plane(1)*coord_x + norm_plane(2)*coord_y+ norm_plane(3)*coord_z;% distance to the plane
1068            indcut=find(abs(fieldZ) <= width);
1069            size(indcut)
1070            for ivar=VarIndex
1071                VarName=FieldData.ListVarName{ivar};
1072                eval(['FieldData.' VarName '=FieldData.' VarName '(indcut);'])
1073                % A VOIR : CAS DE VAR STRUCTUREE MAIS PAS GRILLE REGULIERE : INTERPOLER SUR GRILLE REGULIERE
1074            end
1075            coord_x=coord_x(indcut);
1076            coord_y=coord_y(indcut);
1077            coord_z=coord_z(indcut);
1078        end
1079       
1080        %rotate coordinates if needed:
1081        if testangle && ~test90y && ~test90x;%=1 for slanted plane
1082            %             coord_X=coord_x;
1083            %             coord_Y=coord_y;
1084            %             if ~isequal(Theta,0)
1085            %                 coord_Y=coord_Y *cos(Theta);
1086            %             end
1087            %         else
1088            coord_X=(coord_x *cos(Phi) + coord_y* sin(Phi));
1089            coord_Y=(-coord_x *sin(Phi) + coord_y *cos(Phi))*cos(Theta);
1090            %         end
1091            %         if ~isempty(ivar_Z)
1092            coord_Y=coord_Y+coord_z *sin(Theta);
1093            %         end
1094            %         if testangle
1095            coord_X=(coord_X *cos(Psi) - coord_Y* sin(Psi));%A VERIFIER
1096            coord_Y=(coord_X *sin(Psi) + coord_Y* cos(Psi));
1097        else
1098            coord_X=coord_x;
1099            coord_Y=coord_y;
1100        end
1101       
1102        %restriction to the range of x and y if imposed
1103        testin=ones(size(coord_X)); %default
1104        testbound=0;
1105        if testXMin
1106            testin=testin & (coord_X >= XMin);
1107            testbound=1;
1108        end
1109        if testXMax
1110            testin=testin & (coord_X <= XMax);
1111            testbound=1;
1112        end
1113        if testYMin
1114            testin=testin & (coord_Y >= YMin);
1115            testbound=1;
1116        end
1117        if testYMin
1118            testin=testin & (coord_Y <= YMax);
1119            testbound=1;
1120        end
1121        if testbound
1122            indcut=find(testin);
1123            for ivar=VarIndex
1124                VarName=FieldData.ListVarName{ivar};
1125                eval(['FieldData.' VarName '=FieldData.' VarName '(indcut);'])
1126            end
1127            coord_X=coord_X(indcut);
1128            coord_Y=coord_Y(indcut);
1129            if length(ivar_Z)==1
1130                coord_Z=coord_Z(indcut);
1131            end
1132        end
1133        % different cases of projection
1134        if isequal(ObjectData.ProjMode,'projection')
1135            %the list of dimension
1136            %ProjData.ListDimName=[ProjData.ListDimName FieldData.VarDimName(VarIndex(1))];%add the point index to the list of dimensions
1137            %ProjData.DimValue=[ProjData.
1138            %length(coord_X)];
1139           
1140            for ivar=VarIndex %transfer variables to the projection plane
1141                VarName=FieldData.ListVarName{ivar};
1142                if ivar==ivar_X %x coordinate
1143                    eval(['ProjData.' VarName '=coord_X;'])
1144                elseif ivar==ivar_Y % y coordinate
1145                    eval(['ProjData.' VarName '=coord_Y;'])
1146                elseif isempty(ivar_Z) || ivar~=ivar_Z % other variables (except Z coordinate wyhich is not reproduced)
1147                    eval(['ProjData.' VarName '=FieldData.' VarName ';'])
1148                end
1149                if isempty(ivar_Z) || ivar~=ivar_Z
1150                    ProjData.ListVarName=[ProjData.ListVarName VarName];
1151                    ProjData.VarDimName=[ProjData.VarDimName DimCell];
1152                    nbvar=nbvar+1;
1153                    if isfield(FieldData,'VarAttribute') && length(FieldData.VarAttribute) >=ivar
1154                        ProjData.VarAttribute{nbvar}=FieldData.VarAttribute{ivar};
1155                    end
1156                end
1157            end
1158        elseif isequal(ObjectData.ProjMode,'interp')||isequal(ObjectData.ProjMode,'filter')%interpolate data on a regular grid
1159            if isequal(ObjectData.ProjMode,'filter')
1160                rho=1000;%smoothing parameter, (small for strong smoothing)
1161            else
1162                rho=0;
1163            end
1164            coord_x_proj=XMin:DX:XMax;
1165            coord_y_proj=YMin:DY:YMax;
1166            DimCell={'coord_y','coord_x'};
1167            ProjData.ListVarName={'coord_y','coord_x'};
1168            ProjData.VarDimName={'coord_y','coord_x'};
1169            nbcoord=2;
1170            ProjData.coord_y=[YMin YMax];
1171            ProjData.coord_x=[XMin XMax];
1172            if isempty(ivar_X), ivar_X=0; end;
1173            if isempty(ivar_Y), ivar_Y=0; end;
1174            if isempty(ivar_Z), ivar_Z=0; end;
1175            if isempty(ivar_U), ivar_U=0; end;
1176            if isempty(ivar_V), ivar_V=0; end;
1177            if isempty(ivar_W), ivar_W=0; end;
1178            if isempty(ivar_F), ivar_F=0; end;
1179            if isempty(ivar_FF), ivar_FF=0; end;
1180            if ~isequal(ivar_FF,0)
1181                VarName_FF=FieldData.ListVarName{ivar_FF};
1182                eval(['indsel=find(FieldData.' VarName_FF '==0);'])
1183                coord_X=coord_X(indsel);
1184                coord_Y=coord_Y(indsel);
1185            end
1186            FF=zeros(1,length(coord_y_proj)*length(coord_x_proj));
1187            testFF=0;
1188            for ivar=VarIndex
1189                VarName=FieldData.ListVarName{ivar};
1190                if ~( ivar==ivar_X || ivar==ivar_Y || ivar==ivar_Z || ivar==ivar_F || ivar==ivar_FF || test_anc(ivar)==1)
1191                    ivar_new=ivar_new+1;
1192                    ProjData.ListVarName=[ProjData.ListVarName {VarName}];
1193                    ProjData.VarDimName=[ProjData.VarDimName {DimCell}];
1194                    if isfield(FieldData,'VarAttribute') && length(FieldData.VarAttribute) >=ivar
1195                        ProjData.VarAttribute{ivar_new+nbcoord}=FieldData.VarAttribute{ivar};
1196                    end
1197                    if  ~isequal(ivar_FF,0)
1198                        eval(['FieldData.' VarName '=FieldData.' VarName '(indsel);'])
1199                    end
1200                    eval(['ProjData.' VarName '=griddata_uvmat(double(coord_X),double(coord_Y),double(FieldData.' VarName '),coord_x_proj,coord_y_proj'',rho);'])
1201                    eval(['varline=reshape(ProjData.' VarName ',1,length(coord_y_proj)*length(coord_x_proj));'])
1202                    FFlag= isnan(varline); %detect undefined values NaN
1203                    indnan=find(FFlag);
1204                    if~isempty(indnan)
1205                        varline(indnan)=zeros(size(indnan));
1206                        eval(['ProjData.' VarName '=reshape(varline,length(coord_y_proj),length(coord_x_proj));'])
1207                        FF(indnan)=ones(size(indnan));
1208                        testFF=1;
1209                    end
1210                    if ivar==ivar_U
1211                        ivar_U=ivar_new;
1212                    end
1213                    if ivar==ivar_V
1214                        ivar_V=ivar_new;
1215                    end
1216                    if ivar==ivar_W
1217                        ivar_W=ivar_new;
1218                    end
1219                end
1220            end
1221            if testFF
1222                ProjData.FF=reshape(FF,length(coord_y_proj),length(coord_x_proj));
1223                ProjData.ListVarName=[ProjData.ListVarName {'FF'}];
1224                ProjData.VarDimName=[ProjData.VarDimName {DimCell}];
1225                ProjData.VarAttribute{ivar_new+1+nbcoord}.Role='errorflag';
1226            end
1227        end
1228       
1229        %% case of input fields defined on a structured  grid
1230    else
1231        VarName=FieldData.ListVarName{VarIndex(1)};%get the first variable of the cell to get the input matrix dimensions
1232        eval(['DimValue=size(FieldData.' VarName ');'])%input matrix dimensions
1233        DimValue(DimValue==1)=[];%remove singleton dimensions
1234        NbDim=numel(DimValue);%update number of space dimensions
1235        nbcolor=1; %default number of 'color' components: third matrix index without corresponding coordinate
1236        if NbDim>=3
1237            if NbDim>3
1238                errormsg='matrices with more than 3 dimensions not handled';
1239                return
1240            else
1241                if numel(find(VarType.coord))==2% the third matrix dimension does not correspond to a space coordinate
1242                    nbcolor=DimValue(3);
1243                    DimValue(3)=[]; %number of 'color' components updated
1244                    NbDim=2;% space dimension set to 2
1245                end
1246            end
1247        end
1248        AYName=FieldData.ListVarName{VarType.coord(NbDim-1)};%name of input x coordinate (name preserved on projection)
1249        AXName=FieldData.ListVarName{VarType.coord(NbDim)};%name of input y coordinate (name preserved on projection)
1250        if testangle% TODO modify name also in case of origin shift in x or y
1251            AYProjName='Y';
1252            AXProjName='X';
1253            count=0;
1254            %modify coordinate names if they are already used
1255            while ~(isempty(find(strcmp('AXName',ProjData.ListVarName),1)) && isempty(find(strcmp('AYName',ProjData.ListVarName),1)))
1256                count=count+1;
1257                AYProjName=[AYProjName '_' num2str(count)];
1258                AXProjName=[AXProjName '_' num2str(count)];
1259            end
1260        else
1261            AYProjName=AYName;% (name preserved on projection)
1262            AXProjName=AXName;%name of input y coordinate (name preserved on projection)
1263        end
1264        ListDimName=FieldData.VarDimName{VarIndex(1)};
1265        ProjData.ListVarName=[ProjData.ListVarName {AYProjName} {AXProjName}]; %TODO: check if it already exists in Projdata (several cells)
1266        ProjData.VarDimName=[ProjData.VarDimName {AYProjName} {AXProjName}];
1267        Coord_z=[];
1268        Coord_y=[];
1269        Coord_x=[];
1270       
1271        for idim=1:NbDim %loop on space dimensions
1272            test_interp(idim)=0;%test for coordiate interpolation (non regular grid), =0 by default
1273            ivar=VarType.coord(idim);% index of the variable corresponding to the current dimension
1274            if ~isequal(ivar,0)%  a variable corresponds to the dimension #idim
1275                eval(['Coord{idim}=FieldData.' FieldData.ListVarName{ivar} ';']) ;% coord values for the input field
1276                if numel(Coord{idim})==2 %input array defined on a regular grid
1277                    DCoord_min(idim)=(Coord{idim}(2)-Coord{idim}(1))/DimValue(idim);
1278                else
1279                    DCoord=diff(Coord{idim});%array of coordinate derivatives for the input field
1280                    DCoord_min(idim)=min(DCoord);
1281                    DCoord_max=max(DCoord);
1282                    %    test_direct(idim)=DCoord_max>0;% =1 for increasing values, 0 otherwise
1283                    if abs(DCoord_max-DCoord_min(idim))>abs(DCoord_max/1000)
1284                        msgbox_uvmat('ERROR',['non monotonic dimension variable # ' num2str(idim)  ' in proj_field.m'])
1285                        return
1286                    end
1287                    test_interp(idim)=(DCoord_max-DCoord_min(idim))> 0.0001*abs(DCoord_max);% test grid regularity
1288                end
1289                test_direct(idim)=(DCoord_min(idim)>0);
1290            else  % no variable associated with the  dimension #idim, the coordinate value is set equal to the matrix index by default
1291                Coord_i_str=['Coord_' num2str(idim)];
1292                DCoord_min(idim)=1;%default
1293                Coord{idim}=[0.5 DimValue(idim)-0.5];
1294                test_direct(idim)=1;
1295            end
1296        end
1297        if DY==0
1298            DY=abs(DCoord_min(NbDim-1));
1299        end
1300        npY=1+round(abs(Coord{NbDim-1}(end)-Coord{NbDim-1}(1))/DY);%nbre of points after interpol
1301        if DX==0
1302            DX=abs(DCoord_min(NbDim));
1303        end
1304        npX=1+round(abs(Coord{NbDim}(end)-Coord{NbDim}(1))/DX);%nbre of points after interpol
1305        for idim=1:NbDim
1306            if test_interp(idim)
1307                DimValue(idim)=1+round(abs(Coord{idim}(end)-Coord{idim}(1))/abs(DCoord_min(idim)));%nbre of points after possible interpolation on a regular gri
1308            end
1309        end
1310        Coord_y=linspace(Coord{NbDim-1}(1),Coord{NbDim-1}(end),npY);
1311        test_direct_y=test_direct(NbDim-1);
1312        Coord_x=linspace(Coord{NbDim}(1),Coord{NbDim}(end),npX);
1313        test_direct_x=test_direct(NbDim);
1314        DAX=DCoord_min(NbDim);
1315        DAY=DCoord_min(NbDim-1);
1316        minAX=min(Coord_x);
1317        maxAX=max(Coord_x);
1318        minAY=min(Coord_y);
1319        maxAY=max(Coord_y);
1320        xcorner=[minAX maxAX minAX maxAX]-ObjectData.Coord(1,1);
1321        ycorner=[maxAY maxAY minAY minAY]-ObjectData.Coord(1,2);
1322        xcor_new=xcorner*cos_om+ycorner*sin_om;%coord new frame
1323        ycor_new=-xcorner*sin_om+ycorner*cos_om;
1324        if ~testXMax
1325            XMax=max(xcor_new);
1326        end
1327        if ~testXMin
1328            XMin=min(xcor_new);
1329        end
1330        if ~testYMax
1331            YMax=max(ycor_new);
1332        end
1333        if ~testYMin
1334            YMin=min(ycor_new);
1335        end
1336        DXinit=(maxAX-minAX)/(DimValue(NbDim)-1);
1337        DYinit=(maxAY-minAY)/(DimValue(NbDim-1)-1);
1338        if DX==0
1339            DX=DXinit;
1340        end
1341        if DY==0
1342            DY=DYinit;
1343        end
1344        if NbDim==3
1345            DZ=(Coord{1}(end)-Coord{1}(1))/(DimValue(1)-1);
1346            if ~test_direct(1)
1347                DZ=-DZ;
1348            end
1349            Coord_z=linspace(Coord{1}(1),Coord{1}(end),DimValue(1));
1350            test_direct_z=test_direct(1);
1351        end
1352        npX=floor((XMax-XMin)/DX+1);
1353        npY=floor((YMax-YMin)/DY+1);
1354        if test_direct_y
1355            coord_y_proj=linspace(YMin,YMax,npY);%abscissa of the new pixels along the line
1356        else
1357            coord_y_proj=linspace(YMax,YMin,npY);%abscissa of the new pixels along the line
1358        end
1359        if test_direct_x
1360            coord_x_proj=linspace(XMin,XMax,npX);%abscissa of the new pixels along the line
1361        else
1362            coord_x_proj=linspace(XMax,XMin,npX);%abscissa of the new pixels along the line
1363        end
1364        % case with no  interpolation
1365        if isequal(ProjMode,'projection') && (~testangle || test90y || test90x)
1366            if  NbDim==2 && ~testXMin && ~testXMax && ~testYMin && ~testYMax
1367                ProjData=FieldData;% no change by projection
1368            else
1369                indY=NbDim-1;
1370                if test_direct(indY)
1371                    min_indy=ceil((YMin-Coord{indY}(1))/DYinit)+1;
1372                    max_indy=floor((YMax-Coord{indY}(1))/DYinit)+1;
1373                    Ybound(1)=Coord{indY}(1)+DYinit*(min_indy-1);
1374                    Ybound(2)=Coord{indY}(1)+DYinit*(max_indy-1);
1375                else
1376                    min_indy=ceil((Coord{indY}(1)-YMax)/DYinit)+1;
1377                    max_indy=floor((Coord{indY}(1)-YMin)/DYinit)+1;
1378                    Ybound(2)=Coord{indY}(1)-DYinit*(max_indy-1);
1379                    Ybound(1)=Coord{indY}(1)-DYinit*(min_indy-1);
1380                end
1381                if test_direct(NbDim)==1
1382                    min_indx=ceil((XMin-Coord{NbDim}(1))/DXinit)+1;
1383                    max_indx=floor((XMax-Coord{NbDim}(1))/DXinit)+1;
1384                    Xbound(1)=Coord{NbDim}(1)+DXinit*(min_indx-1);
1385                    Xbound(2)=Coord{NbDim}(1)+DXinit*(max_indx-1);
1386                else
1387                    min_indx=ceil((Coord{NbDim}(1)-XMax)/DXinit)+1;
1388                    max_indx=floor((Coord{NbDim}(1)-XMin)/DXinit)+1;
1389                    Xbound(2)=Coord{NbDim}(1)+DXinit*(max_indx-1);                         
1390                    Xbound(1)=Coord{NbDim}(1)+DXinit*(min_indx-1);
1391                end
1392                min_indy=max(min_indy,1);% deals with margin (bound lower than the first index)
1393                min_indx=max(min_indx,1);
1394
1395                if test90y
1396                    ind_new=[3 2 1];
1397                    DimCell={AYProjName,AXProjName};
1398%                     DimValue=DimValue(ind_new);
1399                    iz=ceil((ObjectData.Coord(1,1)-Coord{3}(1))/DX)+1;
1400                    for ivar=VarIndex
1401                        VarName=FieldData.ListVarName{ivar};
1402                        ProjData.ListVarName=[ProjData.ListVarName VarName];
1403                        ProjData.VarDimName=[ProjData.VarDimName {DimCell}];
1404                        ProjData.VarAttribute{length(ProjData.ListVarName)}=FieldData.VarAttribute{ivar}; %reproduce the variable attributes
1405                        eval(['ProjData.' VarName '=permute(FieldData.' VarName ',ind_new);'])% permute x and z indices for 90 degree rotation
1406                        eval(['ProjData.' VarName '=squeeze(ProjData.' VarName '(iz,:,:));'])% select the z index iz
1407                    end
1408                    eval(['ProjData.' AYProjName '=[Ybound(1) Ybound(2)];']) %record the new (projected ) y coordinates
1409                    eval(['ProjData.' AXProjName '=[Coord{1}(end),Coord{1}(1)];']) %record the new (projected ) x coordinates
1410                else
1411                    if NbDim==3
1412                        DimCell(1)=[]; %suppress z variable
1413                        DimValue(1)=[];
1414                        if test_direct(1)
1415                            iz=ceil((ObjectData.Coord(1,3)-Coord{1}(1))/DZ)+1;
1416                        else
1417                            iz=ceil((Coord{1}(1)-ObjectData.Coord(1,3))/DZ)+1;
1418                        end
1419                    end
1420                    max_indy=min(max_indy,DimValue(1));%introduce bounds in y and x indices
1421                    max_indx=min(max_indx,DimValue(2));
1422                    for ivar=VarIndex% loop on non coordinate variables
1423                        VarName=FieldData.ListVarName{ivar};
1424                        ProjData.ListVarName=[ProjData.ListVarName VarName];
1425                        ProjData.VarDimName=[ProjData.VarDimName {DimCell}];
1426                        if isfield(FieldData,'VarAttribute') && length(FieldData.VarAttribute)>=ivar
1427                            ProjData.VarAttribute{length(ProjData.ListVarName)}=FieldData.VarAttribute{ivar};
1428                        end
1429                        if NbDim==3
1430                            eval(['ProjData.' VarName '=squeeze(FieldData.' VarName '(iz,min_indy:max_indy,min_indx:max_indx));']);
1431                        else
1432                            eval(['ProjData.' VarName '=FieldData.' VarName '(min_indy:max_indy,min_indx:max_indx,:);']);
1433                        end
1434                    end
1435                    eval(['ProjData.' AYProjName '=[Ybound(1) Ybound(2)];']) %record the new (projected ) y coordinates
1436                    eval(['ProjData.' AXProjName '=[Xbound(1) Xbound(2)];']) %record the new (projected ) x coordinates
1437                end
1438            end
1439        else       % case with rotation and/or interpolation
1440            if NbDim==2 %2D case
1441                [X,Y]=meshgrid(coord_x_proj,coord_y_proj);%grid in the new coordinates
1442                XIMA=ObjectData.Coord(1,1)+(X)*cos(PlaneAngle(3))-Y*sin(PlaneAngle(3));%corresponding coordinates in the original image
1443                YIMA=ObjectData.Coord(1,2)+(X)*sin(PlaneAngle(3))+Y*cos(PlaneAngle(3));
1444                XIMA=(XIMA-minAX)/DXinit+1;% image index along x
1445                YIMA=(-YIMA+maxAY)/DYinit+1;% image index along y
1446                XIMA=reshape(round(XIMA),1,npX*npY);%indices reorganized in 'line'
1447                YIMA=reshape(round(YIMA),1,npX*npY);
1448                flagin=XIMA>=1 & XIMA<=DimValue(2) & YIMA >=1 & YIMA<=DimValue(1);%flagin=1 inside the original image
1449                if isequal(ObjectData.ProjMode,'filter')
1450                    npx_filter=ceil(abs(DX/DAX));
1451                    npy_filter=ceil(abs(DY/DAY));
1452                    Mfilter=ones(npy_filter,npx_filter)/(npx_filter*npy_filter);
1453                    test_filter=1;
1454                else
1455                    test_filter=0;
1456                end
1457                eval(['ProjData.' AYName '=[coord_y_proj(1) coord_y_proj(end)];']) %record the new (projected ) y coordinates
1458                eval(['ProjData.' AXName '=[coord_x_proj(1) coord_x_proj(end)];']) %record the new (projected ) x coordinates
1459                for ivar=VarIndex
1460                    VarName=FieldData.ListVarName{ivar};
1461                    if test_interp(1) || test_interp(2)%interpolate on a regular grid
1462                        eval(['ProjData.' VarName '=interp2(Coord{2},Coord{1},FieldData.' VarName ',Coord_x,Coord_y'');']) %TO TEST
1463                    end
1464                    %filter the field (image) if option 'filter' is used
1465                    if test_filter
1466                        Aclass=class(FieldData.A);
1467                        eval(['ProjData.' VarName '=filter2(Mfilter,FieldData.' VarName ',''valid'');'])
1468                        if ~isequal(Aclass,'double')
1469                            eval(['ProjData.' VarName '=' Aclass '(FieldData.' VarName ');'])%revert to integer values
1470                        end
1471                    end
1472                    eval(['vec_A=reshape(FieldData.' VarName ',[],nbcolor);'])%put the original image in line
1473                    %ind_in=find(flagin);
1474                    ind_out=find(~flagin);
1475                    ICOMB=(XIMA-1)*DimValue(1)+YIMA;
1476                    ICOMB=ICOMB(flagin);%index corresponding to XIMA and YIMA in the aligned original image vec_A
1477                    vec_B(flagin,1:nbcolor)=vec_A(ICOMB,:);
1478                    for icolor=1:nbcolor
1479                        vec_B(ind_out,icolor)=zeros(size(ind_out));
1480                    end
1481                    ProjData.ListVarName=[ProjData.ListVarName VarName];
1482                    ProjData.VarDimName=[ProjData.VarDimName {DimCell}];
1483                    if isfield(FieldData,'VarAttribute')&&length(FieldData.VarAttribute)>=ivar
1484                        ProjData.VarAttribute{length(ProjData.ListVarName)+nbcoord}=FieldData.VarAttribute{ivar};
1485                    end
1486                    eval(['ProjData.' VarName '=reshape(vec_B,npY,npX,nbcolor);']);
1487                end
1488                ProjData.FF=reshape(~flagin,npY,npX);%false flag A FAIRE: tenir compte d'un flga antérieur
1489                ProjData.ListVarName=[ProjData.ListVarName 'FF'];
1490                ProjData.VarDimName=[ProjData.VarDimName {DimCell}];
1491                ProjData.VarAttribute{length(ProjData.ListVarName)}.Role='errorflag';
1492            elseif ~testangle
1493                % unstructured z coordinate
1494                test_sup=(Coord{1}>=ObjectData.Coord(1,3));
1495                iz_sup=find(test_sup);
1496                iz=iz_sup(1);
1497                if iz>=1 & iz<=npz
1498                    %ProjData.ListDimName=[ProjData.ListDimName ListDimName(2:end)];
1499                    %ProjData.DimValue=[ProjData.DimValue npY npX];
1500                    for ivar=VarIndex
1501                        VarName=FieldData.ListVarName{ivar};
1502                        ProjData.ListVarName=[ProjData.ListVarName VarName];
1503                        ProjData.VarAttribute{length(ProjData.ListVarName)}=FieldData.VarAttribute{ivar}; %reproduce the variable attributes
1504                        eval(['ProjData.' VarName '=squeeze(FieldData.' VarName '(iz,:,:));'])% select the z index iz
1505                        %TODO : do a vertical average for a thick plane
1506                        if test_interp(2) || test_interp(3)
1507                            eval(['ProjData.' VarName '=interp2(Coord{3},Coord{2},ProjData.' VarName ',Coord_x,Coord_y'');'])
1508                        end
1509                    end
1510                end
1511            else
1512                errormsg='projection of structured coordinates on oblique plane not yet implemented';
1513                %TODO: use interp3
1514                return
1515            end
1516        end
1517    end
1518   
1519    %% projection of  velocity components in the rotated coordinates
1520    if testangle && length(ivar_U)==1
1521        if isempty(ivar_V)
1522            msgbox_uvmat('ERROR','v velocity component missing in proj_field.m')
1523            return
1524        end
1525        UName=FieldData.ListVarName{ivar_U};
1526        VName=FieldData.ListVarName{ivar_V};
1527        eval(['ProjData.' UName  '=cos(PlaneAngle(3))*ProjData.' UName '+ sin(PlaneAngle(3))*ProjData.' VName ';'])
1528        eval(['ProjData.' VName  '=cos(Theta)*(-sin(PlaneAngle(3))*ProjData.' UName '+ cos(PlaneAngle(3))*ProjData.' VName ');'])
1529        if ~isempty(ivar_W)
1530            WName=FieldData.ListVarName{ivar_W};
1531            eval(['ProjData.' VName '=ProjData.' VName '+ ProjData.' WName '*sin(Theta);'])%
1532            eval(['ProjData.' WName '=NormVec_X*ProjData.' UName '+ NormVec_Y*ProjData.' VName '+ NormVec_Z* ProjData.' WName ';']);
1533        end
1534        if ~isequal(Psi,0)
1535            eval(['ProjData.' UName '=cos(Psi)* ProjData.' UName '- sin(Psi)*ProjData.' VName ';']);
1536            eval(['ProjData.' VName '=sin(Psi)* ProjData.' UName '+ cos(Psi)*ProjData.' VName ';']);
1537        end
1538    end
1539end
1540
1541%-----------------------------------------------------------------
1542%projection in a volume
1543 function  [ProjData,errormsg] = proj_volume(FieldData, ObjectData)
1544%-----------------------------------------------------------------
1545ProjData=FieldData;%default output
1546
1547%% initialisation of the input parameters of the projection plane
1548ProjMode='projection';%direct projection by default
1549if isfield(ObjectData,'ProjMode'),ProjMode=ObjectData.ProjMode; end;
1550
1551%% axis origin
1552if isempty(ObjectData.Coord)
1553    ObjectData.Coord(1,1)=0;%origin of the plane set to [0 0] by default
1554    ObjectData.Coord(1,2)=0;
1555    ObjectData.Coord(1,3)=0;
1556end
1557
1558%% rotation angles
1559VolumeAngle=[0 0 0];
1560norm_plane=[0 0 1];
1561if isfield(ObjectData,'Angle')&& isequal(size(ObjectData.Angle),[1 3])&& ~isequal(ObjectData.Angle,[0 0 0])
1562    PlaneAngle=ObjectData.Angle;
1563    VolumeAngle=ObjectData.Angle;
1564    om=norm(VolumeAngle);%norm of rotation angle in radians
1565    OmAxis=VolumeAngle/om; %unit vector marking the rotation axis
1566    cos_om=cos(pi*om/180);
1567    sin_om=sin(pi*om/180);
1568    coeff=OmAxis(3)*(1-cos_om);
1569    %components of the unity vector norm_plane normal to the projection plane
1570    norm_plane(1)=OmAxis(1)*coeff+OmAxis(2)*sin_om;
1571    norm_plane(2)=OmAxis(2)*coeff-OmAxis(1)*sin_om;
1572    norm_plane(3)=OmAxis(3)*coeff+cos_om;
1573end
1574testangle=~isequal(VolumeAngle,[0 0 0]);
1575
1576%% mesh sizes DX, DY, DZ
1577DX=0;
1578DY=0; %default
1579DZ=0;
1580if isfield(ObjectData,'DX')&~isempty(ObjectData.DX)
1581     DX=abs(ObjectData.DX);%mesh of interpolation points
1582end
1583if isfield(ObjectData,'DY')&~isempty(ObjectData.DY)
1584     DY=abs(ObjectData.DY);%mesh of interpolation points
1585end
1586if isfield(ObjectData,'DZ')&~isempty(ObjectData.DZ)
1587     DZ=abs(ObjectData.DZ);%mesh of interpolation points
1588end
1589if  ~strcmp(ProjMode,'projection') && (DX==0||DY==0||DZ==0)
1590        errormsg='grid mesh DX , DY or DZ is missing';
1591        return
1592end
1593
1594%% extrema along each axis
1595testXMin=0;
1596testXMax=0;
1597testYMin=0;
1598testYMax=0;
1599if isfield(ObjectData,'RangeX')
1600        XMin=min(ObjectData.RangeX);
1601        XMax=max(ObjectData.RangeX);
1602        testXMin=XMax>XMin;
1603        testXMax=1;
1604end
1605if isfield(ObjectData,'RangeY')
1606        YMin=min(ObjectData.RangeY);
1607        YMax=max(ObjectData.RangeY);
1608        testYMin=YMax>YMin;
1609        testYMax=1;
1610end
1611width=0;%default width of the projection band
1612if isfield(ObjectData,'RangeZ')
1613        ZMin=min(ObjectData.RangeZ);
1614        ZMax=max(ObjectData.RangeZ);
1615        testZMin=ZMax>ZMin;
1616        testZMax=1;
1617end
1618
1619%% initiate Matlab  structure for physical field
1620[ProjData,errormsg]=proj_heading(FieldData,ObjectData);
1621ProjData.NbDim=3;
1622ProjData.ListVarName={};
1623ProjData.VarDimName={};
1624if ~isequal(DX,0)&& ~isequal(DY,0)
1625    ProjData.Mesh=sqrt(DX*DY);%define typical data mesh, useful for mouse selection in plots
1626elseif isfield(FieldData,'Mesh')
1627    ProjData.Mesh=FieldData.Mesh;
1628end
1629
1630error=0;%default
1631flux=0;
1632testfalse=0;
1633ListIndex={};
1634
1635%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1636%% group the variables (fields of 'FieldData') in cells of variables with the same dimensions
1637%-----------------------------------------------------------------
1638idimvar=0;
1639[CellVarIndex,NbDimVec,VarTypeCell,errormsg]=find_field_indices(FieldData);
1640if ~isempty(errormsg)
1641    errormsg=['error in proj_field/proj_plane:' errormsg];
1642    return
1643end
1644
1645% LOOP ON GROUPS OF VARIABLES SHARING THE SAME DIMENSIONS
1646% CellVarIndex=cells of variable index arrays
1647ivar_new=0; % index of the current variable in the projected field
1648icoord=0;
1649nbcoord=0;%number of added coordinate variables brought by projection
1650nbvar=0;
1651for icell=1:length(CellVarIndex)
1652    NbDim=NbDimVec(icell);
1653    if NbDim<3
1654        continue
1655    end
1656    VarIndex=CellVarIndex{icell};%  indices of the selected variables in the list FieldData.ListVarName
1657    VarType=VarTypeCell{icell};
1658    ivar_X=VarType.coord_x;
1659    ivar_Y=VarType.coord_y;
1660    ivar_Z=VarType.coord_z;
1661    ivar_U=VarType.vector_x;
1662    ivar_V=VarType.vector_y;
1663    ivar_W=VarType.vector_z;
1664    ivar_C=VarType.scalar ;
1665    ivar_Anc=VarType.ancillary;
1666    test_anc=zeros(size(VarIndex));
1667    test_anc(ivar_Anc)=ones(size(ivar_Anc));
1668    ivar_F=VarType.warnflag;
1669    ivar_FF=VarType.errorflag;
1670    testX=~isempty(ivar_X) && ~isempty(ivar_Y);
1671    DimCell=FieldData.VarDimName{VarIndex(1)};
1672    if ischar(DimCell)
1673        DimCell={DimCell};%name of dimensions
1674    end
1675
1676%% case of input fields with unstructured coordinates
1677    if testX
1678        XName=FieldData.ListVarName{ivar_X};
1679        YName=FieldData.ListVarName{ivar_Y};
1680        eval(['coord_x=FieldData.' XName ';'])
1681        eval(['coord_y=FieldData.' YName ';'])
1682        if length(ivar_Z)==1
1683            ZName=FieldData.ListVarName{ivar_Z};
1684            eval(['coord_z=FieldData.' ZName ';'])
1685        end
1686
1687        % translate  initial coordinates
1688        coord_x=coord_x-ObjectData.Coord(1,1);
1689        coord_y=coord_y-ObjectData.Coord(1,2);
1690        if ~isempty(ivar_Z)
1691            coord_z=coord_z-ObjectData.Coord(1,3);
1692        end
1693       
1694        % selection of the vectors in the projection range
1695%         if length(ivar_Z)==1 &&  width > 0
1696%             %components of the unitiy vector normal to the projection plane
1697%             fieldZ=NormVec_X*coord_x + NormVec_Y*coord_y+ NormVec_Z*coord_z;% distance to the plane           
1698%             indcut=find(abs(fieldZ) <= width);
1699%             for ivar=VarIndex
1700%                 VarName=FieldData.ListVarName{ivar};
1701%                 eval(['FieldData.' VarName '=FieldData.' VarName '(indcut);']) 
1702%                     % A VOIR : CAS DE VAR STRUCTUREE MAIS PAS GRILLE REGULIERE : INTERPOLER SUR GRILLE REGULIERE             
1703%             end
1704%             coord_x=coord_x(indcut);
1705%             coord_y=coord_y(indcut);
1706%             coord_z=coord_z(indcut);
1707%         end
1708
1709       %rotate coordinates if needed: TODO modify
1710       if testangle
1711           coord_X=(coord_x *cos(Phi) + coord_y* sin(Phi));
1712           coord_Y=(-coord_x *sin(Phi) + coord_y *cos(Phi))*cos(Theta);
1713           if ~isempty(ivar_Z)
1714               coord_Y=coord_Y+coord_z *sin(Theta);
1715           end
1716           
1717           coord_X=(coord_X *cos(Psi) - coord_Y* sin(Psi));%A VERIFIER
1718           coord_Y=(coord_X *sin(Psi) + coord_Y* cos(Psi));
1719           
1720       else
1721           coord_X=coord_x;
1722           coord_Y=coord_y;
1723           coord_Z=coord_z;
1724       end
1725        %restriction to the range of x and y if imposed
1726        testin=ones(size(coord_X)); %default
1727        testbound=0;
1728        if testXMin
1729            testin=testin & (coord_X >= XMin);
1730            testbound=1;
1731        end
1732        if testXMax
1733            testin=testin & (coord_X <= XMax);
1734            testbound=1;
1735        end
1736        if testYMin
1737            testin=testin & (coord_Y >= YMin);
1738            testbound=1;
1739        end
1740        if testYMax
1741            testin=testin & (coord_Y <= YMax);
1742            testbound=1;
1743        end
1744        if testbound
1745            indcut=find(testin);
1746            for ivar=VarIndex
1747                VarName=FieldData.ListVarName{ivar};
1748                eval(['FieldData.' VarName '=FieldData.' VarName '(indcut);'])           
1749            end
1750            coord_X=coord_X(indcut);
1751            coord_Y=coord_Y(indcut);
1752            if length(ivar_Z)==1
1753                coord_Z=coord_Z(indcut);
1754            end
1755        end
1756        % different cases of projection
1757        if isequal(ObjectData.ProjMode,'projection')%%%%%%%   NOT USED %%%%%%%%%%
1758            for ivar=VarIndex %transfer variables to the projection plane
1759                VarName=FieldData.ListVarName{ivar};
1760                if ivar==ivar_X %x coordinate
1761                    eval(['ProjData.' VarName '=coord_X;'])
1762                elseif ivar==ivar_Y % y coordinate
1763                    eval(['ProjData.' VarName '=coord_Y;'])
1764                elseif isempty(ivar_Z) || ivar~=ivar_Z % other variables (except Z coordinate wyhich is not reproduced)
1765                    eval(['ProjData.' VarName '=FieldData.' VarName ';'])
1766                end
1767                if isempty(ivar_Z) || ivar~=ivar_Z
1768                    ProjData.ListVarName=[ProjData.ListVarName VarName];
1769                    ProjData.VarDimName=[ProjData.VarDimName DimCell];
1770                    nbvar=nbvar+1;
1771                    if isfield(FieldData,'VarAttribute') && length(FieldData.VarAttribute) >=ivar
1772                        ProjData.VarAttribute{nbvar}=FieldData.VarAttribute{ivar};
1773                    end
1774                end
1775            end 
1776        elseif isequal(ObjectData.ProjMode,'interp')||isequal(ObjectData.ProjMode,'filter')%interpolate data on a regular grid
1777            coord_x_proj=XMin:DX:XMax;
1778            coord_y_proj=YMin:DY:YMax;
1779            coord_z_proj=ZMin:DZ:ZMax;
1780            DimCell={'coord_z','coord_y','coord_x'};
1781            ProjData.ListVarName={'coord_z','coord_y','coord_x'};
1782            ProjData.VarDimName={'coord_z','coord_y','coord_x'};   
1783            nbcoord=2; 
1784            ProjData.coord_z=[ZMin ZMax];
1785            ProjData.coord_y=[YMin YMax];
1786            ProjData.coord_x=[XMin XMax];
1787            if isempty(ivar_X), ivar_X=0; end;
1788            if isempty(ivar_Y), ivar_Y=0; end;
1789            if isempty(ivar_Z), ivar_Z=0; end;
1790            if isempty(ivar_U), ivar_U=0; end;
1791            if isempty(ivar_V), ivar_V=0; end;
1792            if isempty(ivar_W), ivar_W=0; end;
1793            if isempty(ivar_F), ivar_F=0; end;
1794            if isempty(ivar_FF), ivar_FF=0; end;
1795            if ~isequal(ivar_FF,0)
1796                VarName_FF=FieldData.ListVarName{ivar_FF};
1797                eval(['indsel=find(FieldData.' VarName_FF '==0);'])
1798                coord_X=coord_X(indsel);
1799                coord_Y=coord_Y(indsel);
1800            end
1801            FF=zeros(1,length(coord_y_proj)*length(coord_x_proj));
1802            testFF=0;
1803            [X,Y,Z]=meshgrid(coord_y_proj,coord_z_proj,coord_x_proj);%grid in the new coordinates
1804            for ivar=VarIndex
1805                VarName=FieldData.ListVarName{ivar};
1806                if ~( ivar==ivar_X || ivar==ivar_Y || ivar==ivar_Z || ivar==ivar_F || ivar==ivar_FF || test_anc(ivar)==1)                 
1807                    ivar_new=ivar_new+1;
1808                    ProjData.ListVarName=[ProjData.ListVarName {VarName}];
1809                    ProjData.VarDimName=[ProjData.VarDimName {DimCell}];
1810                    if isfield(FieldData,'VarAttribute') && length(FieldData.VarAttribute) >=ivar
1811                        ProjData.VarAttribute{ivar_new+nbcoord}=FieldData.VarAttribute{ivar};
1812                    end
1813                    if  ~isequal(ivar_FF,0)
1814                        eval(['FieldData.' VarName '=FieldData.' VarName '(indsel);'])
1815                    end
1816                    eval(['InterpFct=TriScatteredInterp(double(coord_X),double(coord_Y),double(coord_Z),double(FieldData.' VarName '))'])
1817                    eval(['ProjData.' VarName '=InterpFct(X,Y,Z);'])
1818%                     eval(['varline=reshape(ProjData.' VarName ',1,length(coord_y_proj)*length(coord_x_proj));'])
1819%                     FFlag= isnan(varline); %detect undefined values NaN
1820%                     indnan=find(FFlag);
1821%                     if~isempty(indnan)
1822%                         varline(indnan)=zeros(size(indnan));
1823%                         eval(['ProjData.' VarName '=reshape(varline,length(coord_y_proj),length(coord_x_proj));'])
1824%                         FF(indnan)=ones(size(indnan));
1825%                         testFF=1;
1826%                     end
1827                    if ivar==ivar_U
1828                        ivar_U=ivar_new;
1829                    end
1830                    if ivar==ivar_V
1831                        ivar_V=ivar_new;
1832                    end
1833                    if ivar==ivar_W
1834                        ivar_W=ivar_new;
1835                    end
1836                end
1837            end
1838            if testFF
1839                ProjData.FF=reshape(FF,length(coord_y_proj),length(coord_x_proj));
1840                ProjData.ListVarName=[ProjData.ListVarName {'FF'}];
1841               ProjData.VarDimName=[ProjData.VarDimName {DimCell}];
1842                ProjData.VarAttribute{ivar_new+1+nbcoord}.Role='errorflag';
1843            end
1844        end
1845       
1846%% case of input fields defined on a structured  grid
1847    else
1848        VarName=FieldData.ListVarName{VarIndex(1)};%get the first variable of the cell to get the input matrix dimensions
1849        eval(['DimValue=size(FieldData.' VarName ');'])%input matrix dimensions
1850        DimValue(DimValue==1)=[];%remove singleton dimensions       
1851        NbDim=numel(DimValue);%update number of space dimensions
1852        nbcolor=1; %default number of 'color' components: third matrix index without corresponding coordinate
1853        if NbDim>=3
1854            if NbDim>3
1855                errormsg='matrices with more than 3 dimensions not handled';
1856                return
1857            else
1858                if numel(find(VarType.coord))==2% the third matrix dimension does not correspond to a space coordinate
1859                    nbcolor=DimValue(3);
1860                    DimValue(3)=[]; %number of 'color' components updated
1861                    NbDim=2;% space dimension set to 2
1862                end
1863            end
1864        end
1865        AYName=FieldData.ListVarName{VarType.coord(NbDim-1)};%name of input x coordinate (name preserved on projection)
1866        AXName=FieldData.ListVarName{VarType.coord(NbDim)};%name of input y coordinate (name preserved on projection)   
1867        eval(['AX=FieldData.' AXName ';'])
1868        eval(['AY=FieldData.' AYName ';'])
1869        ListDimName=FieldData.VarDimName{VarIndex(1)};
1870        ProjData.ListVarName=[ProjData.ListVarName {AYName} {AXName}]; %TODO: check if it already exists in Projdata (several cells)
1871        ProjData.VarDimName=[ProjData.VarDimName {AYName} {AXName}];
1872
1873%         for idim=1:length(ListDimName)
1874%             DimName=ListDimName{idim};
1875%             if strcmp(DimName,'rgb')||strcmp(DimName,'nb_coord')||strcmp(DimName,'nb_coord_i')
1876%                nbcolor=DimValue(idim);
1877%                DimValue(idim)=[];
1878%             end
1879%             if isequal(DimName,'nb_coord_j')% NOTE: CASE OF TENSOR NOT TREATED
1880%                 DimValue(idim)=[];
1881%             end
1882%         end 
1883        Coord_z=[];
1884        Coord_y=[];
1885        Coord_x=[];   
1886
1887        for idim=1:NbDim %loop on space dimensions
1888            test_interp(idim)=0;%test for coordiate interpolation (non regular grid), =0 by default
1889            ivar=VarType.coord(idim);% index of the variable corresponding to the current dimension
1890            if ~isequal(ivar,0)%  a variable corresponds to the dimension #idim
1891                eval(['Coord{idim}=FieldData.' FieldData.ListVarName{ivar} ';']) ;% coord values for the input field
1892                if numel(Coord{idim})==2 %input array defined on a regular grid
1893                   DCoord_min(idim)=(Coord{idim}(2)-Coord{idim}(1))/DimValue(idim);
1894                else
1895                    DCoord=diff(Coord{idim});%array of coordinate derivatives for the input field
1896                    DCoord_min(idim)=min(DCoord);
1897                    DCoord_max=max(DCoord);
1898                %    test_direct(idim)=DCoord_max>0;% =1 for increasing values, 0 otherwise
1899                    if abs(DCoord_max-DCoord_min(idim))>abs(DCoord_max/1000)
1900                        msgbox_uvmat('ERROR',['non monotonic dimension variable # ' num2str(idim)  ' in proj_field.m'])
1901                                return
1902                    end               
1903                    test_interp(idim)=(DCoord_max-DCoord_min(idim))> 0.0001*abs(DCoord_max);% test grid regularity
1904                end
1905                test_direct(idim)=(DCoord_min(idim)>0);
1906            else  % no variable associated with the  dimension #idim, the coordinate value is set equal to the matrix index by default
1907                Coord_i_str=['Coord_' num2str(idim)];
1908                DCoord_min(idim)=1;%default
1909                Coord{idim}=[0.5 DimValue(idim)-0.5];
1910                test_direct(idim)=1;
1911            end
1912        end
1913        if DY==0
1914            DY=abs(DCoord_min(NbDim-1));
1915        end
1916        npY=1+round(abs(Coord{NbDim-1}(end)-Coord{NbDim-1}(1))/DY);%nbre of points after interpol
1917        if DX==0
1918            DX=abs(DCoord_min(NbDim));
1919        end
1920        npX=1+round(abs(Coord{NbDim}(end)-Coord{NbDim}(1))/DX);%nbre of points after interpol
1921        for idim=1:NbDim
1922            if test_interp(idim)
1923                DimValue(idim)=1+round(abs(Coord{idim}(end)-Coord{idim}(1))/abs(DCoord_min(idim)));%nbre of points after possible interpolation on a regular gri
1924            end
1925        end       
1926        Coord_y=linspace(Coord{NbDim-1}(1),Coord{NbDim-1}(end),npY);
1927        test_direct_y=test_direct(NbDim-1);
1928        Coord_x=linspace(Coord{NbDim}(1),Coord{NbDim}(end),npX);
1929        test_direct_x=test_direct(NbDim);
1930        DAX=DCoord_min(NbDim);
1931        DAY=DCoord_min(NbDim-1); 
1932        minAX=min(Coord_x);
1933        maxAX=max(Coord_x);
1934        minAY=min(Coord_y);
1935        maxAY=max(Coord_y);
1936        xcorner=[minAX maxAX minAX maxAX]-ObjectData.Coord(1,1);
1937        ycorner=[maxAY maxAY minAY minAY]-ObjectData.Coord(1,2);
1938        xcor_new=xcorner*cos(Phi)+ycorner*sin(Phi);%coord new frame
1939        ycor_new=-xcorner*sin(Phi)+ycorner*cos(Phi);
1940        if ~testXMax
1941            XMax=max(xcor_new);
1942        end
1943        if ~testXMin
1944            XMin=min(xcor_new);
1945        end
1946        if ~testYMax
1947            YMax=max(ycor_new);
1948        end
1949        if ~testYMin
1950            YMin=min(ycor_new);
1951        end
1952        DXinit=(maxAX-minAX)/(DimValue(NbDim)-1);
1953        DYinit=(maxAY-minAY)/(DimValue(NbDim-1)-1);
1954        if DX==0
1955            DX=DXinit;
1956        end
1957        if DY==0
1958            DY=DYinit;
1959        end
1960        if NbDim==3
1961            DZ=(Coord{1}(end)-Coord{1}(1))/(DimValue(1)-1);
1962            if ~test_direct(1)
1963                DZ=-DZ;
1964            end
1965            Coord_z=linspace(Coord{1}(1),Coord{1}(end),DimValue(1));
1966            test_direct_z=test_direct(1);
1967        end
1968        npX=floor((XMax-XMin)/DX+1);
1969        npY=floor((YMax-YMin)/DY+1);   
1970        if test_direct_y
1971            coord_y_proj=linspace(YMin,YMax,npY);%abscissa of the new pixels along the line
1972        else
1973            coord_y_proj=linspace(YMax,YMin,npY);%abscissa of the new pixels along the line
1974        end
1975        if test_direct_x
1976            coord_x_proj=linspace(XMin,XMax,npX);%abscissa of the new pixels along the line
1977        else
1978            coord_x_proj=linspace(XMax,XMin,npX);%abscissa of the new pixels along the line
1979        end
1980       
1981        % case with no rotation and interpolation
1982        if isequal(ProjMode,'projection') && isequal(Phi,0) && isequal(Theta,0) && isequal(Psi,0)
1983            if ~testXMin && ~testXMax && ~testYMin && ~testYMax && NbDim==2
1984                ProjData=FieldData;
1985            else
1986                indY=NbDim-1;
1987                if test_direct(indY)
1988                    min_indy=ceil((YMin-Coord{indY}(1))/DYinit)+1;
1989                    max_indy=floor((YMax-Coord{indY}(1))/DYinit)+1;
1990                    Ybound(1)=Coord{indY}(1)+DYinit*(min_indy-1);
1991                    Ybound(2)=Coord{indY}(1)+DYinit*(max_indy-1);
1992                else
1993                    min_indy=ceil((Coord{indY}(1)-YMax)/DYinit)+1;
1994                    max_indy=floor((Coord{indY}(1)-YMin)/DYinit)+1;
1995                    Ybound(2)=Coord{indY}(1)-DYinit*(max_indy-1);
1996                    Ybound(1)=Coord{indY}(1)-DYinit*(min_indy-1);
1997                end   
1998                if test_direct(NbDim)==1
1999                    min_indx=ceil((XMin-Coord{NbDim}(1))/DXinit)+1;
2000                    max_indx=floor((XMax-Coord{NbDim}(1))/DXinit)+1;
2001                    Xbound(1)=Coord{NbDim}(1)+DXinit*(min_indx-1);
2002                    Xbound(2)=Coord{NbDim}(1)+DXinit*(max_indx-1);
2003                else
2004                    min_indx=ceil((Coord{NbDim}(1)-XMax)/DXinit)+1;
2005                    max_indx=floor((Coord{NbDim}(1)-XMin)/DXinit)+1;
2006                    Xbound(2)=Coord{NbDim}(1)+DXinit*(max_indx-1);
2007                    Xbound(1)=Coord{NbDim}(1)+DXinit*(min_indx-1);
2008                end
2009                if NbDim==3
2010                    DimCell(1)=[]; %suppress z variable
2011                    DimValue(1)=[];
2012                                        %structured coordinates
2013                    if test_direct(1)
2014                        iz=ceil((ObjectData.Coord(1,3)-Coord{1}(1))/DZ)+1;
2015                    else
2016                        iz=ceil((Coord{1}(1)-ObjectData.Coord(1,3))/DZ)+1;
2017                    end
2018                end
2019                min_indy=max(min_indy,1);% deals with margin (bound lower than the first index)
2020                min_indx=max(min_indx,1);
2021                max_indy=min(max_indy,DimValue(1));
2022                max_indx=min(max_indx,DimValue(2));
2023                for ivar=VarIndex% loop on non coordinate variables
2024                    VarName=FieldData.ListVarName{ivar};
2025                    ProjData.ListVarName=[ProjData.ListVarName VarName];
2026                    ProjData.VarDimName=[ProjData.VarDimName {DimCell}];
2027                    if isfield(FieldData,'VarAttribute') && length(FieldData.VarAttribute)>=ivar
2028                        ProjData.VarAttribute{length(ProjData.ListVarName)}=FieldData.VarAttribute{ivar};
2029                    end
2030                    if NbDim==3
2031                        eval(['ProjData.' VarName '=squeeze(FieldData.' VarName '(iz,min_indy:max_indy,min_indx:max_indx));']);
2032                    else
2033                        eval(['ProjData.' VarName '=FieldData.' VarName '(min_indy:max_indy,min_indx:max_indx,:);']);
2034                    end
2035                end 
2036                eval(['ProjData.' AYName '=[Ybound(1) Ybound(2)];']) %record the new (projected ) y coordinates
2037                eval(['ProjData.' AXName '=[Xbound(1) Xbound(2)];']) %record the new (projected ) x coordinates
2038            end
2039        else       % case with rotation and/or interpolation
2040            if NbDim==2 %2D case
2041                [X,Y]=meshgrid(coord_x_proj,coord_y_proj);%grid in the new coordinates
2042                XIMA=ObjectData.Coord(1,1)+(X)*cos(Phi)-Y*sin(Phi);%corresponding coordinates in the original image
2043                YIMA=ObjectData.Coord(1,2)+(X)*sin(Phi)+Y*cos(Phi);
2044                XIMA=(XIMA-minAX)/DXinit+1;% image index along x
2045                YIMA=(-YIMA+maxAY)/DYinit+1;% image index along y
2046                XIMA=reshape(round(XIMA),1,npX*npY);%indices reorganized in 'line'
2047                YIMA=reshape(round(YIMA),1,npX*npY);
2048                flagin=XIMA>=1 & XIMA<=DimValue(2) & YIMA >=1 & YIMA<=DimValue(1);%flagin=1 inside the original image
2049                if isequal(ObjectData.ProjMode,'filter')
2050                    npx_filter=ceil(abs(DX/DAX));
2051                    npy_filter=ceil(abs(DY/DAY));
2052                    Mfilter=ones(npy_filter,npx_filter)/(npx_filter*npy_filter);
2053                    test_filter=1;
2054                else
2055                    test_filter=0;
2056                end
2057                eval(['ProjData.' AYName '=[coord_y_proj(1) coord_y_proj(end)];']) %record the new (projected ) y coordinates
2058                eval(['ProjData.' AXName '=[coord_x_proj(1) coord_x_proj(end)];']) %record the new (projected ) x coordinates
2059                for ivar=VarIndex
2060                    VarName=FieldData.ListVarName{ivar};
2061                    if test_interp(1) || test_interp(2)%interpolate on a regular grid       
2062                          eval(['ProjData.' VarName '=interp2(Coord{2},Coord{1},FieldData.' VarName ',Coord_x,Coord_y'');']) %TO TEST
2063                    end
2064                    %filter the field (image) if option 'filter' is used
2065                    if test_filter 
2066                         Aclass=class(FieldData.A);
2067                         eval(['ProjData.' VarName '=filter2(Mfilter,FieldData.' VarName ',''valid'');'])
2068                         if ~isequal(Aclass,'double')
2069                             eval(['ProjData.' VarName '=' Aclass '(FieldData.' VarName ');'])%revert to integer values
2070                         end
2071                    end
2072                    eval(['vec_A=reshape(FieldData.' VarName ',[],nbcolor);'])%put the original image in line             
2073                    %ind_in=find(flagin);
2074                    ind_out=find(~flagin);
2075                    ICOMB=(XIMA-1)*DimValue(1)+YIMA;
2076                    ICOMB=ICOMB(flagin);%index corresponding to XIMA and YIMA in the aligned original image vec_A
2077                    vec_B(flagin,1:nbcolor)=vec_A(ICOMB,:);
2078                    for icolor=1:nbcolor
2079                        vec_B(ind_out,icolor)=zeros(size(ind_out));
2080                    end
2081                    ProjData.ListVarName=[ProjData.ListVarName VarName];
2082                    ProjData.VarDimName=[ProjData.VarDimName {DimCell}];
2083                    if isfield(FieldData,'VarAttribute')&&length(FieldData.VarAttribute)>=ivar
2084                        ProjData.VarAttribute{length(ProjData.ListVarName)+nbcoord}=FieldData.VarAttribute{ivar};
2085                    end     
2086                    eval(['ProjData.' VarName '=reshape(vec_B,npY,npX,nbcolor);']);
2087                end
2088                ProjData.FF=reshape(~flagin,npY,npX);%false flag A FAIRE: tenir compte d'un flga antérieur 
2089                ProjData.ListVarName=[ProjData.ListVarName 'FF'];
2090                ProjData.VarDimName=[ProjData.VarDimName {DimCell}];
2091                ProjData.VarAttribute{length(ProjData.ListVarName)}.Role='errorflag';
2092            else %3D case
2093                if ~testangle     
2094                    % unstructured z coordinate
2095                    test_sup=(Coord{1}>=ObjectData.Coord(1,3));
2096                    iz_sup=find(test_sup);
2097                    iz=iz_sup(1);
2098                    if iz>=1 & iz<=npz
2099                        %ProjData.ListDimName=[ProjData.ListDimName ListDimName(2:end)];
2100                        %ProjData.DimValue=[ProjData.DimValue npY npX];
2101                        for ivar=VarIndex
2102                            VarName=FieldData.ListVarName{ivar};
2103                            ProjData.ListVarName=[ProjData.ListVarName VarName];
2104                            ProjData.VarAttribute{length(ProjData.ListVarName)}=FieldData.VarAttribute{ivar}; %reproduce the variable attributes 
2105                            eval(['ProjData.' VarName '=squeeze(FieldData.' VarName '(iz,:,:));'])% select the z index iz
2106                            %TODO : do a vertical average for a thick plane
2107                            if test_interp(2) || test_interp(3)
2108                                eval(['ProjData.' VarName '=interp2(Coord{3},Coord{2},ProjData.' VarName ',Coord_x,Coord_y'');'])
2109                            end
2110                        end
2111                    end
2112                else
2113                    errormsg='projection of structured coordinates on oblique plane not yet implemented';
2114                    %TODO: use interp3
2115                    return
2116                end
2117            end
2118        end
2119    end
2120
2121    %% projection of  velocity components in the rotated coordinates
2122    if testangle
2123        if isempty(ivar_V)
2124            msgbox_uvmat('ERROR','v velocity component missing in proj_field.m')
2125            return
2126        end
2127        UName=FieldData.ListVarName{ivar_U};
2128        VName=FieldData.ListVarName{ivar_V};   
2129        eval(['ProjData.' UName  '=cos(Phi)*ProjData.' UName '+ sin(Phi)*ProjData.' VName ';'])
2130        eval(['ProjData.' VName  '=cos(Theta)*(-sin(Phi)*ProjData.' UName '+ cos(Phi)*ProjData.' VName ');'])
2131        if ~isempty(ivar_W)
2132            WName=FieldData.ListVarName{ivar_W};
2133            eval(['ProjData.' VName '=ProjData.' VName '+ ProjData.' WName '*sin(Theta);'])%
2134            eval(['ProjData.' WName '=NormVec_X*ProjData.' UName '+ NormVec_Y*ProjData.' VName '+ NormVec_Z* ProjData.' WName ';']);
2135        end
2136        if ~isequal(Psi,0)
2137            eval(['ProjData.' UName '=cos(Psi)* ProjData.' UName '- sin(Psi)*ProjData.' VName ';']);
2138            eval(['ProjData.' VName '=sin(Psi)* ProjData.' UName '+ cos(Psi)*ProjData.' VName ';']);
2139        end
2140    end
2141end
2142
2143%------------------------------------------------------------------------
2144%--- transfer the global attributes
2145function [ProjData,errormsg]=proj_heading(FieldData,ObjectData)
2146%------------------------------------------------------------------------
2147ProjData=[];%default
2148errormsg='';%default
2149
2150%% transfer error
2151if isfield(FieldData,'Txt')
2152    errormsg=FieldData.Txt; %transmit erreur message
2153    return;
2154end
2155
2156%% transfer global attributes
2157if ~isfield(FieldData,'ListGlobalAttribute')
2158    ProjData.ListGlobalAttribute={};
2159else
2160    ProjData.ListGlobalAttribute=FieldData.ListGlobalAttribute;
2161end
2162for iattr=1:length(ProjData.ListGlobalAttribute)
2163    AttrName=ProjData.ListGlobalAttribute{iattr};
2164    if isfield(FieldData,AttrName)
2165        eval(['ProjData.' AttrName '=FieldData.' AttrName ';']);
2166    end
2167end
2168
2169%% transfer coordinate unit
2170if isfield(FieldData,'CoordUnit')
2171    if isfield(ObjectData,'CoordUnit') && ~strcmp(FieldData.CoordUnit,ObjectData.CoordUnit)
2172        errormsg=[ObjectData.Type ' in ' ObjectData.CoordUnit ' coordinates, while field in ' FieldData.CoordUnit ];
2173        return
2174    else
2175         ProjData.CoordUnit=FieldData.CoordUnit;
2176    end
2177end
2178
2179%% store the properties of the projection object
2180ListObject={'Type','ProjMode','RangeX','RangeY','RangeZ','Phi','Theta','Psi','Coord'};
2181for ilist=1:length(ListObject)
2182    if isfield(ObjectData,ListObject{ilist})
2183        eval(['val=ObjectData.' ListObject{ilist} ';'])
2184        if ~isempty(val)
2185            eval(['ProjData.Object' ListObject{ilist} '=val;']);
2186            ProjData.ListGlobalAttribute=[ProjData.ListGlobalAttribute {['Object' ListObject{ilist}]}];
2187        end
2188    end   
2189end
Note: See TracBrowser for help on using the repository browser.