source: trunk/src/proj_field.m @ 204

Last change on this file since 204 was 204, checked in by sommeria, 13 years ago

put back deleted files

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