Context Navigation

source: trunk/src/proj_field.m @ 1134

Last change on this file since 1134 was 1127, checked in by g7moreau, 12 months ago
Update Joel email
File size: 118.1 KB

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

Note: See TracBrowser for help on using the repository browser.

Download in other formats: