Context Navigation

← Previous Revision
Next Revision →
Blame
Revision Log

proj_field.m

Last change on this file was 1135, checked in by sommeria, 3 days ago
fct for python added
File size: 118.2 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	ProjData.(FieldData.ListVarName{ivar}) =mean(A_out,1,'omitnan');
942	elseif nbcolor==3
943	vec_B(ind_in,1:3)=vec_A(ICOMB,:);
944	vec_B(ind_out,1)=zeros(size(ind_out));
945	vec_B(ind_out,2)=zeros(size(ind_out));
946	vec_B(ind_out,3)=zeros(size(ind_out));
947	A_out=reshape(vec_B,npY,npX,nbcolor);
948	ProjData.(FieldData.ListVarName{ivar})=squeeze(sum(A_out,1)/npY);
949	end
950	ProjData.ListVarName=[ProjData.ListVarName FieldData.ListVarName{ivar}];
951	ProjData.VarDimName=[ProjData.VarDimName {AXName}];%to generalize with the initial name of the x coordinate
952	nbvar_proj=numel(ProjData.ListVarName);
953	if isfield(FieldData.VarAttribute{ivar},'Role')
954	if strcmp(FieldData.VarAttribute{ivar}.Role,'vector_x')
955	ivar_U=nbvar_proj;
956	elseif strcmp(FieldData.VarAttribute{ivar}.Role,'vector_y')
957	ivar_V=nbvar_proj;
958	end
959	end
960	if isequal(ProjMode,'projection')
961	ProjData.VarAttribute{nbvar_proj}.Role='discrete';
962	else
963	ProjData.VarAttribute{nbvar_proj}.Role='coord_y';
964	end
965	end
966
967	if nbcolor==3
968	ProjData.VarDimName{end}={AXName,'rgb'};
969	end
970	end
971
972	end
973	% for vector fields, take the components longitudinal and tranverse to the projection line
974	if ~isempty(ivar_U) && ~isempty(ivar_V)
975	vector_x =ProjData.(ProjData.ListVarName{ivar_U});
976	ProjData.(ProjData.ListVarName{ivar_U}) =cos(theta)vector_x+sin(theta)ProjData.(ProjData.ListVarName{ivar_V});
977	ProjData.(ProjData.ListVarName{ivar_V}) =-sin(theta)vector_x+cos(theta)ProjData.(ProjData.ListVarName{ivar_V});
978	end
979	end
980
981	% %shotarter case for horizontal or vertical line (A FAIRE
982	% % Rangx=[0.5 npx-0.5];%image coordiantes of corners
983	% % Rangy=[npy-0.5 0.5];
984	% % if isfield(Calib,'Pxcmx')&isfield(Calib,'Pxcmy')%old calib
985	% % Rangx=Rangx/Calib.Pxcmx;
986	% % Rangy=Rangy/Calib.Pxcmy;
987	% % else
988	% % [Rangx]=phys_XYZ(Calib,Rangx,[0.5 0.5],[0 0]);%case of translations without rotation and quadratic deformation
989	% % [xx,Rangy]=phys_XYZ(Calib,[0.5 0.5],Rangy,[0 0]);
990	% % end
991	%
992	% % test_scal=0;%default% 3- 'UserData':(get(handles.Tag,'UserData')
993
994
995	%-----------------------------------------------------------------
996	% proj_plane: project on a plane defined by the structure ObjectData containing:
997	% .Type : = 'plane'
998	% .ProjMode (mode of projection) = 'projection'\|'interp_lin'\|'interp_tps' ;
999	% .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)
1000	% .Angle : angles of rotation of the plane expressed in degrees. The first element
1001	% ObjectData.Angle(1) represents a rotation in the plane (x,y) (around the
1002	% vertical axis), which can be followed by a rotation with angle ObjectData.Angle(2) around the new (rotated) x axis.
1003	% .Coord(1,3): coordinates (x,y,z) of the origin of the new coordinates in the projection plane;
1004	% .DX,.DY,.DZ : increments along each coordinate for the projected data (for 'interp_lin' and 'interp_tps')
1005	% .RangeX,RangeY: vectors with two elements defining the lower and upper bounds of the respectively X and Y coordinates in the projection plane
1006	% .RangeInterp: maximum distance of interpolation from the known data. Interpolation yields NaN beyond this distance.
1007
1008	% TODO: AJOUTER flux,circul,error
1009	function [ProjData,errormsg] = proj_plane(FieldData, ObjectData)
1010	%-----------------------------------------------------------------
1011
1012	%% rotation matrix
1013	PlaneAngle=[0 0 0];
1014	norm_plane=[0 0 1];
1015	testangle=0;
1016	test90x=0;
1017	test90y=0;
1018	if isfield(ObjectData,'Angle') && size(ObjectData.Angle,2)==3
1019	test90x=isequal(ObjectData.Angle,[90 0 0]);%=1 for 90 degree rotation alround x axis
1020	test90y=isequal(ObjectData.Angle,[0 90 0]);%=1 for 90 degree rotation alround y axis
1021	%test90z=isequal(PlaneAngle,[90 0 0]);%=1 for 90 degree rotation alround x axis
1022	PlaneAngle=(pi/180)*ObjectData.Angle;
1023	M=rodrigues(PlaneAngle);
1024	norm_plane=M*[0 0 1]';
1025	testangle= (~isequal(PlaneAngle,[0 0 0]) && ~test90x && ~test90y);%=1 for slanted plane
1026	end
1027
1028	%% mesh sizes DX and DY
1029	DX=[];
1030	DY=[];%default
1031	if isfield(ObjectData,'DX') && ~isempty(ObjectData.DX)
1032	DX=abs(ObjectData.DX);%mesh of interpolation points
1033	elseif isfield(FieldData,'CoordMesh')
1034	DX=FieldData.CoordMesh;
1035	end
1036	if isfield(ObjectData,'DY') && ~isempty(ObjectData.DY)
1037	DY=abs(ObjectData.DY);%mesh of interpolation points
1038	elseif isfield(FieldData,'CoordMesh')
1039	DY=FieldData.CoordMesh;
1040	end
1041	if ~strcmp(ObjectData.ProjMode,'projection') && (isempty(DX)\|\|isempty(DY))
1042	errormsg='DX or DY not defined';
1043	return
1044	end
1045	InterpMesh=min(DX,DY);%mesh used for interpolation in a slanted plane
1046
1047	%% extrema along each axis
1048	testXMin=0;% test if min of X coordinates defined on the projection object, =0 by default
1049	testXMax=0;% test if max of X coordinates defined on the projection object, =0 by default
1050	testYMin=0;% test if min of Y coordinates defined on the projection object, =0 by default
1051	testYMax=0;% test if max of Y coordinates defined on the projection object, =0 by default
1052	if isfield(ObjectData,'RangeX') % rangeX defined by the projection object
1053	XMin=min(ObjectData.RangeX);
1054	XMax=max(ObjectData.RangeX);
1055	testXMin=XMax>XMin;%=1 if XMin defined (i.e. RangeY has two distinct elements)
1056	testXMax=1;% max of X coordinates defined on the projection object
1057	end
1058	if isfield(ObjectData,'RangeY') % rangeY defined by the projection object
1059	YMin=min(ObjectData.RangeY);
1060	YMax=max(ObjectData.RangeY);
1061	testYMin=YMax>YMin;%=1 if YMin defined (i.e. RangeY has tow distinct elements)
1062	testYMax=1;% max of Y coordinates defined on the projection object
1063	end
1064	width=0;%default width of the projection band
1065	if isfield(ObjectData,'RangeZ')
1066	width=max(ObjectData.RangeZ);
1067	end
1068
1069	%% interpolation range
1070	thresh2=[];
1071	if isfield(ObjectData,'RangeInterp')
1072	thresh2=ObjectData.RangeInterp*ObjectData.RangeInterp;%square of interpolation range (do not interpolate beyond this range)
1073	end
1074
1075	%% initiate Matlab structure for physical field
1076	[ProjData,errormsg]=proj_heading(FieldData,ObjectData);
1077	if ~isempty(errormsg)
1078	return
1079	end
1080
1081	%% reproduce initial plane position and angle
1082	if isfield(FieldData,'PlaneCoord')&&length(FieldData.PlaneCoord)==3&& isfield(ProjData,'ProjObjectCoord')
1083	if length(ProjData.ProjObjectCoord)==3% if the projection plane has a z coordinate
1084	if isfield(ProjData,'.PlaneCoord') && ~isequal(ProjData.PlaneCoord(3),ProjData.ProjObjectCoord) %check the consistency with the z coordinate of the field plane (set by calibration)
1085	errormsg='inconsistent z position for field and projection plane';
1086	return
1087	end
1088	else % the z coordinate is set only by the field plane (by calibration)
1089	ProjData.ProjObjectCoord=FieldData.PlaneCoord;
1090	end
1091	if isfield(FieldData,'PlaneAngle')
1092	if isfield(ProjData,'ProjObjectAngle')
1093	if ~isequal(FieldData.PlaneAngle,ProjData.ProjObjectAngle) %check the consistency with the z coordinate of the field plane (set by calibration)
1094	errormsg='inconsistent plane angle for field and projection plane';
1095	return
1096	end
1097	else
1098	ProjData.ProjObjectAngle=FieldData.PlaneAngle;
1099	end
1100	end
1101	end
1102	ProjData.NbDim=2;
1103	ProjData.ListVarName={};
1104	ProjData.VarDimName={};
1105	ProjData.VarAttribute={};
1106	if ~isempty(DX) && ~isempty(DY)
1107	ProjData.CoordMesh=sqrt(DX*DY);%define typical data mesh, useful for mouse selection in plots
1108	elseif isfield(FieldData,'CoordMesh')
1109	ProjData.CoordMesh=FieldData.CoordMesh;
1110	end
1111	%error=0;%default
1112	%flux=0;
1113
1114	%% group the variables (fields of 'FieldData') in cells of variables with the same dimensions
1115
1116	[CellInfo,NbDimArray,errormsg]=find_field_cells(FieldData);
1117
1118	if ~isempty(errormsg)
1119	errormsg=['error in proj_field/proj_plane:' errormsg];
1120	return
1121	end
1122
1123	check_grid=zeros(size(CellInfo));% =1 if a grid is needed , =0 otherwise, for each field cell
1124	ProjMode=num2cell(blanks(numel(CellInfo)));
1125	ProjMode=regexprep(ProjMode,' ',ObjectData.ProjMode);
1126	icell_grid=[];% field cell index which defines the grid
1127	icell_scattered=[];% field cell index which defines fields with scattered coordinates
1128	% for icell=1:numel(CellInfo)
1129	% if strcmp(ObjectData.ProjMode,'interp_lin')&& ~strcmp(ProjMode{icell},'interp_tps')
1130	% errormsg='ProjMode interp_tps needed ';
1131	% return
1132	% end
1133	% end
1134	if strcmp(ObjectData.ProjMode,'projection')
1135	%% case of a grid requested by the input field
1136	for icell=1:numel(CellInfo)% TODO: recalculate coordinates here to get the bounds in the rotated coordinates
1137	if isfield(CellInfo{icell},'ProjModeRequest')
1138	switch CellInfo{icell}.ProjModeRequest
1139	case 'interp_lin'
1140	ProjMode{icell}='interp_lin';
1141	case 'interp_tps'
1142	ProjMode{icell}='interp_tps';
1143	end
1144	end
1145	if strcmp(ProjMode{icell},'interp_lin')\|\|strcmp(ProjMode{icell},'interp_tps')
1146	check_grid(icell)=1;
1147	end
1148	if strcmp(CellInfo{icell}.CoordType,'grid') && NbDimArray(icell)>=2
1149	if ~testangle && isempty(icell_grid)% if the input gridded data is not modified, choose the first one in case of multiple gridded field cells
1150	icell_grid=icell;
1151	ProjMode{icell}='projection';
1152	end
1153	check_grid(icell)=1;
1154	elseif strcmp(CellInfo{icell}.CoordType,'scattered')
1155	icell_scattered=icell;
1156	end
1157	end
1158	if ~isempty(find(check_grid,1))% if a grid is requested by the input field
1159	if isempty(icell_grid)% if the grid is not given by cell #icell_grid
1160	if ~isfield(FieldData,'XMax')
1161	FieldData=find_field_bounds(FieldData);
1162	end
1163	end
1164	end
1165	else
1166	%% define the new coordinates in case of interpolation on a imposed grid
1167	if ~testYMin
1168	errormsg='min Y value not defined for the projection grid';return% %%%%%%%%%%%%%%%% A REVOIR
1169
1170	end
1171	if ~testYMax
1172	errormsg='max Y value not defined for the projection grid';return
1173	end
1174	if ~testXMin
1175	errormsg='min X value not defined for the projection grid';return
1176	end
1177	if ~testXMax
1178	errormsg='max X value not defined for the projection grid';return
1179	end
1180	end
1181	if ~isempty(find(check_grid,1))\|\|~strcmp(ObjectData.ProjMode,'projection')%no existing gridded data used
1182	if isempty(icell_grid)\|\|~strcmp(ObjectData.ProjMode,'projection')%no existing gridded data used
1183	AYName='coord_y';
1184	AXName='coord_x';
1185	if strcmp(ObjectData.ProjMode,'projection')%\|\|strcmp(ObjectData.Type,'plane')
1186	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
1187	ProjData.coord_x=[FieldData.XMin FieldData.XMax];
1188	coord_x_proj=FieldData.XMin:FieldData.CoordMesh:FieldData.XMax;
1189	coord_y_proj=FieldData.YMin:FieldData.CoordMesh:FieldData.YMax;
1190	else
1191	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
1192	ProjData.coord_x=[ObjectData.RangeX(1) ObjectData.RangeX(2)];
1193	coord_x_proj=ObjectData.RangeX(1):ObjectData.DX:ObjectData.RangeX(2);
1194	coord_y_proj=ObjectData.RangeY(1):ObjectData.DY:ObjectData.RangeY(2);
1195	end
1196	[XI,YI]=meshgrid(coord_x_proj,coord_y_proj);%grid in the new coordinates
1197	ProjData.VarDimName={AYName,AXName};
1198	else% we use the existing grid from field cell #icell_grid
1199	NbDim=NbDimArray(icell_grid);
1200	AYName=FieldData.ListVarName{CellInfo{icell_grid}.CoordIndex(NbDim-1)};%name of input x coordinate (name preserved on projection)
1201	AXName=FieldData.ListVarName{CellInfo{icell_grid}.CoordIndex(NbDim)};%name of input y coordinate (name preserved on projection)
1202	AYDimName=FieldData.VarDimName{CellInfo{icell_grid}.CoordIndex(NbDim-1)};%
1203	AXDimName=FieldData.VarDimName{CellInfo{icell_grid}.CoordIndex(NbDim)};%
1204	ProjData.VarDimName={AYDimName,AXDimName};
1205	ProjData.(AYName)=FieldData.(AYName); % new (projected ) y coordinates
1206	ProjData.(AXName)=FieldData.(AXName); % new (projected ) y coordinates
1207	end
1208	ProjData.ListVarName={AYName,AXName};
1209	ProjData.VarAttribute{1}.Role='coord_y';
1210	ProjData.VarAttribute{2}.Role='coord_x';
1211	YAttribute=[];
1212	XAttribute=[];
1213	if ~isempty(icell_grid)
1214	YAttribute=FieldData.VarAttribute{CellInfo{icell_grid}.CoordIndex(NbDim-1)};
1215	XAttribute=FieldData.VarAttribute{CellInfo{icell_grid}.CoordIndex(NbDim)};
1216	elseif ~isempty(icell_scattered)
1217	NbDim=NbDimArray(icell_scattered);
1218	YAttribute=FieldData.VarAttribute{CellInfo{icell_scattered}.CoordIndex(NbDim-1)};
1219	XAttribute=FieldData.VarAttribute{CellInfo{icell_scattered}.CoordIndex(NbDim)};
1220	end
1221	if ~testangle
1222	if isfield(YAttribute,'units')
1223	ProjData.VarAttribute{1}.units=YAttribute.units;
1224	end
1225	if isfield(XAttribute,'units')
1226	ProjData.VarAttribute{2}.units=XAttribute.units;
1227	end
1228	end
1229	end
1230
1231	%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1232	% LOOP ON FIELD CELLS, PROJECT VARIABLES
1233	% CellVarIndex=cells of variable index arrays
1234	%ivar_new=0; % index of the current variable in the projected field
1235	% icoord=0;
1236	nbcoord=0;%number of added coordinate variables brought by projection
1237	%nbvar=0;
1238	vector_x_proj=[];
1239	vector_y_proj=[];
1240	for icell=1:length(CellInfo)
1241	NbDim=NbDimArray(icell);
1242	if NbDim<2
1243	continue % only cells represnting 2D or 3D fields are involved
1244	end
1245	% if isfield(CellInfo{icell},'ProjModeRequest') && ~strcmp(CellInfo{icell}.ProjModeRequest,ProjMode{icell})
1246	% msgbox_uvmat('ERROR',['ProjMode ' CellInfo{icell}.ProjModeRequest ' needed'])
1247	% return
1248	% end
1249	VarIndex= CellInfo{icell}.VarIndex;% indices of the selected variables in the list FieldData.ListVarName
1250	%dimensions
1251	DimCell=FieldData.VarDimName{VarIndex(1)};
1252	if ischar(DimCell)
1253	DimCell={DimCell};%name of dimensions
1254	end
1255	coord_z=0;%default
1256	ListVarName={};% initiate list of projected variables for cell # icell
1257	VarDimName={};% initiate coresponding list of dimensions for cell # icell
1258	VarAttribute={};% initiate coresponding list of var attributes for cell # icell
1259	%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1260	check3D=(numel(CellInfo{icell}.CoordIndex)==3);
1261	switch CellInfo{icell}.CoordType
1262	case 'scattered'
1263	%% case of input fields with unstructured coordinates (applies for projMode ='projection' or 'interp_lin')
1264	if strcmp(ProjMode{icell},'interp_tps')
1265	continue %skip for next cell (needs tps field cell)
1266	end
1267	coord_x=FieldData.(CellInfo{icell}.XName);% initial x coordinates
1268	coord_y=FieldData.(CellInfo{icell}.YName);% initial y coordinates
1269
1270	if check3D
1271	coord_z=FieldData.(CellInfo{icell}.ZName);
1272	end
1273
1274	% translate initial coordinates to account for the new origin
1275	coord_x=coord_x-ObjectData.Coord(1,1);
1276	coord_y=coord_y-ObjectData.Coord(1,2);
1277	if check3D
1278	coord_z=coord_z-ObjectData.Coord(1,3);
1279	end
1280
1281	% selection of the vectors in the projection range (3D case)
1282	if check3D && width > 0
1283	%components of the unitiy vector normal to the projection plane
1284	fieldZ=norm_plane(1)coord_x + norm_plane(2)coord_y+ norm_plane(3)*coord_z;% distance to the plane
1285	indcut=find(abs(fieldZ) <= width);
1286	for ivar=[CellInfo{icell}.CoordIndex CellInfo{icell}.VarIndex]
1287	VarName=FieldData.ListVarName{ivar};
1288	FieldData.(VarName)=FieldData.(VarName)(indcut);
1289	end
1290	coord_x=coord_x(indcut);
1291	coord_y=coord_y(indcut);
1292	coord_z=coord_z(indcut);
1293	end
1294
1295	%rotate coordinates if needed: coord_X,coord_Y= = coordinates in the new plane
1296
1297	Phi=PlaneAngle(3);
1298	if testangle
1299	if check3D
1300	[coord_X,coord_Y]=rotate_vector(PlaneAngle,coord_x,coord_y,coord_z);
1301	else
1302	coord_X=coord_x cos(Phi) + coord_y sin(Phi);
1303	coord_Y=-coord_x sin(Phi) + coord_y cos(Phi);
1304	end
1305	else
1306	coord_X=coord_x;
1307	coord_Y=coord_y;
1308	end
1309
1310	%restriction to the range of X and Y if imposed by the projection object
1311	testin=ones(size(coord_X)); %default
1312	testbound=0;
1313	if testXMin
1314	testin=testin & (coord_X >= XMin);
1315	testbound=1;
1316	end
1317	if testXMax
1318	testin=testin & (coord_X <= XMax);
1319	testbound=1;
1320	end
1321	if testYMin
1322	testin=testin & (coord_Y >= YMin);
1323	testbound=1;
1324	end
1325	if testYMin
1326	testin=testin & (coord_Y <= YMax);
1327	testbound=1;
1328	end
1329	if testbound
1330	indcut=find(testin);
1331	if isempty(indcut)
1332	errormsg='data outside the bounds of the projection object';
1333	return
1334	end
1335	for ivar=[CellInfo{icell}.CoordIndex CellInfo{icell}.VarIndex]
1336	VarName=FieldData.ListVarName{ivar};
1337	FieldData.(VarName)=FieldData.(VarName)(indcut);
1338	end
1339	coord_X=coord_X(indcut);
1340	coord_Y=coord_Y(indcut);
1341	if check3D
1342	coord_Z=coord_Z(indcut);
1343	end
1344	end
1345
1346	% two cases of projection for scattered coordinates
1347	switch ProjMode{icell}
1348	case 'projection'% ptoject scattered data without interpolation
1349	nbvar=0;
1350	%nbvar=numel(ProjData.ListVarName);
1351	for ivar=[CellInfo{icell}.CoordIndex CellInfo{icell}.VarIndex] %transfer variables to the projection plane
1352	VarName=FieldData.ListVarName{ivar};
1353	if ivar==CellInfo{icell}.CoordIndex(end)
1354	ProjData.(VarName)=coord_X;
1355	elseif ivar==CellInfo{icell}.CoordIndex(end-1) % y coordinate
1356	ProjData.(VarName)=coord_Y;
1357	elseif ~(check3D && ivar==CellInfo{icell}.CoordIndex(1)) % other variables (except Z coordinate wyhich is not reproduced)
1358	ProjData.(VarName)=FieldData.(VarName);
1359	end
1360	if ~(check3D && ivar==CellInfo{icell}.CoordIndex(1))
1361	ListVarName=[ListVarName VarName];
1362	VarDimName=[VarDimName DimCell];
1363	nbvar=nbvar+1;
1364	if isfield(FieldData,'VarAttribute') && length(FieldData.VarAttribute) >=ivar
1365	VarAttribute{nbvar}=FieldData.VarAttribute{ivar};
1366	end
1367	end
1368	end
1369	case 'interp_lin'%interpolate scattered data on a regular grid
1370	if isfield(CellInfo{icell},'VarIndex_errorflag')
1371	VarName_FF=FieldData.ListVarName{CellInfo{icell}.VarIndex_errorflag};
1372	indsel=find(FieldData.(VarName_FF)==0);
1373	if isempty(indsel)
1374	errormsg='bad projection plane: no data found in the projection domain';
1375	return
1376	end
1377	coord_X=coord_X(indsel);
1378	coord_Y=coord_Y(indsel);
1379	for ivar=1:numel(CellInfo{icell}.VarIndex)
1380	VarName=FieldData.ListVarName{CellInfo{icell}.VarIndex(ivar)};
1381	FieldData.(VarName)=FieldData.(VarName)(indsel);
1382	end
1383	end
1384	% interpolate and calculate field on the grid
1385
1386	[VarVal,ListVarName,VarAttribute,errormsg]=calc_field_interp([coord_X coord_Y],FieldData,CellInfo{icell}.FieldName,XI,YI);
1387
1388	% set to NaN interpolation points which are too far from any initial data (more than 2 CoordMesh)
1389	if exist('scatteredInterpolant','file')%recent Matlab versions
1390	F=scatteredInterpolant(coord_X, coord_Y,coord_X,'nearest');
1391	G=scatteredInterpolant(coord_X, coord_Y,coord_Y,'nearest');
1392	else
1393	F=TriScatteredInterp([coord_X coord_Y],coord_X,'nearest');
1394	G=TriScatteredInterp([coord_X coord_Y],coord_Y,'nearest');
1395	end
1396	Distx=F(XI,YI)-XI;% diff of x coordinates with the nearest measurement point
1397	Disty=G(XI,YI)-YI;% diff of y coordinates with the nearest measurement point
1398	Dist=Distx.Distx+Disty.Disty;
1399	if ~isempty(thresh2)
1400	for ivar=1:numel(VarVal)
1401	VarVal{ivar}(Dist>thresh2)=NaN;% % put to NaN interpolated positions further than 4 meshes from initial data
1402	end
1403	end
1404	if isfield(CellInfo{icell},'CheckSub') && CellInfo{icell}.CheckSub && ~isempty(vector_x_proj)
1405	ProjData.(FieldData.ListVarName{vector_x_proj})=ProjData.(FieldData.ListVarName{vector_x_proj})-VarVal{1};
1406	ProjData.(FieldData.ListVarName{vector_y_proj})=ProjData.(FieldData.ListVarName{vector_y_proj})-VarVal{2};
1407	ListVarName={};% no new variable
1408	VarAttribute={};
1409	else
1410	VarDimName=cell(size(ListVarName));
1411	for ilist=1:numel(ListVarName)% reshape data, excluding coordinates (ilist=1-2), TODO: rationalise
1412	ListVarName{ilist}=regexprep(ListVarName{ilist},'(.+','');
1413	if ~isempty(find(strcmp(ListVarName{ilist},ProjData.ListVarName)))
1414	ListVarName{ilist}=[ListVarName{ilist} '_1'];
1415	end
1416	ProjData.(ListVarName{ilist})=VarVal{ilist};
1417	VarDimName{ilist}={'coord_y','coord_x'};
1418	end
1419	end
1420	if isfield (CellInfo{icell},'VarIndex_vector_x')&& isfield (CellInfo{icell},'VarIndex_vector_y')
1421	vector_x_proj=CellInfo{icell}.VarIndex_vector_x; %preserve for next cell
1422	vector_y_proj=CellInfo{icell}.VarIndex_vector_y; %preserve for next cell
1423	end
1424	end
1425
1426	case 'tps'
1427	%% case of tps data (applies only in interp_tps mode)
1428	if strcmp(ProjMode{icell},'interp_tps')
1429	Coord=FieldData.(FieldData.ListVarName{CellInfo{icell}.CoordIndex});
1430
1431
1432	NbCentres=FieldData.(FieldData.ListVarName{CellInfo{icell}.NbCentres_tps});
1433	SubRange=FieldData.(FieldData.ListVarName{CellInfo{icell}.SubRange_tps});
1434	checkUV=0;
1435	if strcmp(CellInfo{icell}.VarType,'vector')
1436	FieldVar=cat(3,FieldData.(FieldData.ListVarName{CellInfo{icell}.VarIndex_vector_x}),FieldData.(FieldData.ListVarName{CellInfo{icell}.VarIndex_vector_y}));
1437	checkUV=1;
1438	end
1439
1440	%rotate coordinates if needed: coord_X,coord_Y= = coordinates in the new plane
1441	Phi=PlaneAngle(3);
1442	if testangle && ~test90y && ~test90x %=1 for slanted plane
1443	new_XI=XI cos(Phi) - YI sin(Phi)+ObjectData.Coord(1);
1444	YI=XI sin(Phi) + YI cos(Phi)+ObjectData.Coord(2);
1445	XI=new_XI;
1446	end
1447
1448	% interpolate data using thin plate spline
1449	[DataOut,VarAttribute,errormsg]=calc_field_tps(Coord,NbCentres,SubRange,FieldVar,CellInfo{icell}.FieldName,cat(3,XI,YI));
1450
1451	% set to NaN interpolation points which are too far from any initial data (more than 2 CoordMesh)
1452	Coord=permute(Coord,[1 3 2]);
1453	Coord=reshape(Coord,size(Coord,1)*size(Coord,2),2);
1454	if exist('scatteredInterpolant','file')%recent Matlab versions
1455	F=scatteredInterpolant(Coord,Coord(:,1),'nearest');
1456	G=scatteredInterpolant(Coord,Coord(:,2),'nearest');
1457	else
1458	F=TriScatteredInterp(Coord,Coord(:,1),'nearest');
1459	G=TriScatteredInterp(Coord,Coord(:,2),'nearest');
1460	end
1461	Distx=F(XI,YI)-XI;% diff of x coordinates with the nearest measurement point
1462	Disty=G(XI,YI)-YI;% diff of y coordinates with the nearest measurement point
1463	Dist=Distx.Distx+Disty.Disty;
1464	ListVarName=(fieldnames(DataOut))';
1465	VarDimName=cell(size(ListVarName));
1466	for ilist=1:numel(ListVarName)% reshape data, excluding coordinates (ilist=1-2), TODO: rationalise
1467	VarName=ListVarName{ilist};
1468	VarDimName{ilist}={'coord_y','coord_x'};
1469	ProjData.(VarName)=DataOut.(VarName);
1470	if ~isempty(thresh2)
1471	ProjData.(VarName)(Dist>thresh2)=NaN;% put to NaN interpolated positions further than RangeInterp from initial data
1472	end
1473	end
1474	end
1475
1476	case 'grid'
1477	%% case of input fields defined on a structured grid
1478	VarName=FieldData.ListVarName{VarIndex(1)};%get the first variable of the cell to get the input matrix dimensions
1479	DimValue=size(FieldData.(VarName));%input matrix dimensions
1480	DimValue(DimValue==1)=[];%remove singleton dimensions
1481	NbDim=numel(DimValue);%update number of space dimensions
1482	% nbcolor=1; %default number of 'color' components: third matrix index without corresponding coordinate
1483	if NbDim>=3
1484	if NbDim>3
1485	errormsg='matrices with more than 3 dimensions not handled';
1486	return
1487	else
1488	if numel(CellInfo{icell}.CoordIndex)==2% the third matrix dimension does not correspond to a space coordinate
1489	nbcolor=DimValue(3);
1490	DimValue(3)=[]; %number of 'color' components updated
1491	NbDim=2;% space dimension set to 2
1492	end
1493	end
1494	end
1495	Coord_z=[];
1496	Coord_y=[];
1497	Coord_x=[];
1498
1499	if testangle
1500	ProjMode{icell}='interp_lin'; %request linear interpolation for projection on a tilted plane
1501	end
1502
1503	if strcmp(ProjMode{icell},'projection')% project gridded data without interpolation
1504	if NbDim==2 && ~testXMin && ~testXMax && ~testYMin && ~testYMax% no range restriction
1505	ListVarName=[ListVarName FieldData.ListVarName(VarIndex)];
1506	VarDimName=[VarDimName FieldData.VarDimName(VarIndex)];
1507	if isfield(FieldData,'VarAttribute')
1508	VarAttribute=[VarAttribute FieldData.VarAttribute(VarIndex)];
1509	end
1510	ProjData.(AYName)=FieldData.(AYName);
1511	ProjData.(AXName)=FieldData.(AXName);
1512	for ivar=VarIndex
1513	VarName=FieldData.ListVarName{ivar};
1514	ProjData.(VarName)=FieldData.(VarName);% no change by projection
1515	end
1516	else
1517	Coord{1}=FieldData.(FieldData.ListVarName{CellInfo{icell}.CoordIndex(1)});
1518	Coord{2}=FieldData.(FieldData.ListVarName{CellInfo{icell}.CoordIndex(2)});
1519	if NbDim==3
1520	Coord{3}=FieldData.(FieldData.ListVarName{CellInfo{icell}.CoordIndex(3)});
1521	end
1522	if numel(Coord{NbDim-1})==2% case of coordinate defined only by the first and last values
1523	DY=(Coord{NbDim-1}(2)-Coord{NbDim-1}(1))/(DimValue(1)-1);
1524	end
1525	if numel(Coord{NbDim})==2% case of coordinate defined only by the first and last values
1526	DX=(Coord{NbDim}(2)-Coord{NbDim}(1))/(DimValue(2)-1);
1527	end
1528	if testYMax
1529	YIndexMax=(YMax-Coord{NbDim-1}(1))/DY+1;% matrix index corresponding to the max y value for the new field
1530	if testYMin%test_direct(indY)
1531	YIndexMin=(YMin-Coord{NbDim-1}(1))/DY+1;% matrix index corresponding to the min x value for the new field
1532	else
1533	YIndexMin=1;
1534	end
1535	else
1536	YIndexMax=numel(Coord{NbDim-1});
1537	YIndexMin=1;
1538	end
1539	if testXMax
1540	XIndexMax=(XMax-Coord{NbDim}(1))/DX+1;% matrix index corresponding to the max y value for the new field
1541	if testYMin%test_direct(indY)
1542	XIndexMin=(XMin-Coord{NbDim}(1))/DX+1;% matrix index corresponding to the min x value for the new field
1543	else
1544	XIndexMin=1;
1545	end
1546	else
1547	XIndexMax=numel(Coord{NbDim});
1548	XIndexMin=1;
1549	end
1550	YIndexRange(1)=ceil(min(YIndexMin,YIndexMax));%first y index to select from the previous field
1551	YIndexRange(1)=max(YIndexRange(1),1);% avoid bound lower than the first index
1552	YIndexRange(2)=floor(max(YIndexMin,YIndexMax));%last y index to select from the previous field
1553	YIndexRange(2)=min(YIndexRange(2),DimValue(NbDim-1));% limit to the last available index
1554	XIndexRange(1)=ceil(min(XIndexMin,XIndexMax));%first x index to select from the previous field
1555	XIndexRange(1)=max(XIndexRange(1),1);% avoid bound lower than the first index
1556	XIndexRange(2)=floor(max(XIndexMin,XIndexMax));%last x index to select from the previous field
1557	XIndexRange(2)=min(XIndexRange(2),DimValue(NbDim));% limit to the last available index
1558	if test90y
1559	ind_new=[3 2 1];
1560	DimCell={AYProjName,AXProjName};
1561	iz=ceil((ObjectData.Coord(1,1)-Coord{3}(1))/DX)+1;
1562	for ivar=VarIndex
1563	VarName=FieldData.ListVarName{ivar};
1564	ListVarName=[ListVarName VarName];
1565	VarDimName=[VarDimName {DimCell}];
1566	VarAttribute{length(ListVarName)}=FieldData.VarAttribute{ivar}; %reproduce the variable attributes
1567	ProjData.(VarName)=permute(FieldData.(VarName),ind_new);% permute x and z indices for 90 degree rotation
1568	ProjData.(VarName)=squeeze(ProjData.(VarName)(iz,:,:));% select the z index iz
1569	end
1570	ProjData.(AYName)=[Ybound(1) Ybound(2)]; %record the new (projected ) y coordinates
1571	ProjData.(AXName)=[Coord{1}(end),Coord{1}(1)]; %record the new (projected ) x coordinates
1572	else
1573	if NbDim==3
1574	DZ=(Coord{1}(end)-Coord{1}(1))/(numel(Coord{1})-1);
1575	DimCell(1)=[]; %suppress z variable
1576	DimValue(1)=[];
1577	test_direct=1;%TOdo; GENERALIZE, SEE CASE OF points
1578	if test_direct(1)
1579	iz=ceil((ObjectData.Coord(1,3)-Coord{1}(1))/DZ)+1;
1580	else
1581	iz=ceil((Coord{1}(1)-ObjectData.Coord(1,3))/DZ)+1;
1582	end
1583	end
1584	for ivar=VarIndex% loop on non coordinate variables
1585	VarName=FieldData.ListVarName{ivar};
1586	ListVarName=[ListVarName VarName];
1587	VarDimName=[VarDimName {DimCell}];
1588	if isfield(FieldData,'VarAttribute') && length(FieldData.VarAttribute)>=ivar
1589	VarAttribute{length(ListVarName)}=FieldData.VarAttribute{ivar};
1590	end
1591	if NbDim==3
1592	ProjData.(VarName)=squeeze(FieldData.(VarName)(iz,YIndexRange(1):YIndexRange(end),XIndexRange(1):XIndexRange(end)));
1593	else
1594	ProjData.(VarName)=FieldData.(VarName)(YIndexRange(1):YIndexRange(end),XIndexRange(1):XIndexRange(end),:);
1595	end
1596	end
1597	if testXMax
1598	ProjData.(AXName)=Coord{NbDim}(1)+DX*(XIndexRange-1); %record the new (projected ) x coordinates
1599	else
1600	ProjData.(AXName)=FieldData.(AXName);
1601	end
1602	if testYMax
1603	ProjData.(AYName)=Coord{NbDim-1}(1)+DY*(YIndexRange-1); %record the new (projected ) x coordinates
1604	else
1605	ProjData.(AYName)=FieldData.(AYName);
1606	end
1607	end
1608	end
1609	else % project gridded data with interpolation on a grid
1610	if NbDim==2 %2D case
1611	if isequal(ProjMode{icell},'interp_tps')
1612	npx_interp_tps=ceil(abs(DX/DAX));
1613	npy_interp_tps=ceil(abs(DY/DAY));
1614	Minterp_tps=ones(npy_interp_tps,npx_interp_tps)/(npx_interp_tps*npy_interp_tps);
1615	test_interp_tps=1;
1616	else
1617	test_interp_tps=0;
1618	end
1619	Coord{1}=FieldData.(FieldData.ListVarName{CellInfo{icell}.CoordIndex(1)});
1620	Coord{2}=FieldData.(FieldData.ListVarName{CellInfo{icell}.CoordIndex(2)});
1621	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
1622	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
1623	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
1624	xcor_new=xcornercos(PlaneAngle(3))+ycornersin(PlaneAngle(3));%coordinates of the corners in new frame
1625	ycor_new=-xcornersin(PlaneAngle(3))+ycornercos(PlaneAngle(3));
1626	if ~testXMin
1627	XMin=min(xcor_new);
1628	end
1629	if ~testXMax
1630	XMax=max(xcor_new);
1631	end
1632	if ~testYMin
1633	YMin=min(ycor_new);
1634	end
1635	if ~testYMax
1636	YMax=max(ycor_new);
1637	end
1638	end
1639	coord_x_proj=XMin:DX:XMax;
1640	coord_y_proj=YMin:DY:YMax;
1641	ProjData.(AYName)=[coord_y_proj(1) coord_y_proj(end)]; %record the new (projected ) y coordinates
1642	ProjData.(AXName)=[coord_x_proj(1) coord_x_proj(end)]; %record the new (projected ) x coordinates
1643	[X,YI]=meshgrid(coord_x_proj,coord_y_proj);%grid in the new coordinates
1644	XI=ObjectData.Coord(1,1)+(X)cos(PlaneAngle(1))-YIsin(PlaneAngle(1));%corresponding coordinates in the original system
1645	YI=ObjectData.Coord(1,2)+(X)sin(PlaneAngle(1))+YIcos(PlaneAngle(1));
1646
1647	if numel(Coord{1})==2% x coordinate defined by its bounds, get the whole set
1648	Coord{1}=linspace(Coord{1}(1),Coord{1}(2),CellInfo{icell}.CoordSize(1));
1649	end
1650	if numel(Coord{2})==2% y coordiante defiend by its bounds, get the whole set
1651	Coord{2}=linspace(Coord{2}(1),Coord{2}(2),CellInfo{icell}.CoordSize(2));
1652	end
1653	[X,Y]=meshgrid(Coord{2},Coord{1});%initial coordinates
1654
1655	% project all variables in the cell
1656	for ivar=VarIndex
1657	VarName=FieldData.ListVarName{ivar};
1658	if size(FieldData.(VarName),3)==1
1659	ProjData.(VarName)=interp2(X,Y,double(FieldData.(VarName)),XI,YI,'*linear');%interpolation fct
1660	else
1661	ProjData.(VarName)=interp2(X,Y,double(FieldData.(VarName)(:,:,1)),XI,YI,'*linear');
1662	for icolor=2:size(FieldData.(VarName),3)% project 'color' components
1663	ProjData.(VarName)=cat(3,ProjData.(VarName),interp2(X,Y,double(FieldData.(VarName)(:,:,icolor)),XI,YI,'*linear'));
1664	end
1665	end
1666	if isa(FieldData.(VarName),'uint8')
1667	ProjData.(VarName)=uint8(ProjData.(VarName));%put result to integer 8 bits if the initial field is integer (image)
1668	elseif isa(FieldData.(VarName),'uint16')
1669	ProjData.(VarName)=uint16(ProjData.(VarName));%put result to integer 16 bits if the initial field is integer (image)
1670	end
1671	ListVarName=[ListVarName VarName];
1672	DimCell(1:2)={AYName,AXName};
1673	VarDimName=[VarDimName {DimCell}];
1674	if isfield(FieldData,'VarAttribute')&&length(FieldData.VarAttribute)>=ivar
1675	VarAttribute{length(ListVarName)+nbcoord}=FieldData.VarAttribute{ivar};
1676	end
1677	end
1678	elseif ~testangle % 3Dcase without change of angle
1679	% unstructured z coordinate
1680	test_sup=(Coord{1}>=ObjectData.Coord(1,3));
1681	iz_sup=find(test_sup);
1682	iz=iz_sup(1);
1683	if iz>=1 & iz<=npz
1684	%ProjData.ListDimName=[ProjData.ListDimName ListDimName(2:end)];
1685	%ProjData.DimValue=[ProjData.DimValue npY npX];
1686	for ivar=VarIndex
1687	VarName=FieldData.ListVarName{ivar};
1688	ListVarName=[ListVarName VarName];
1689	VarAttribute{length(ListVarName)}=FieldData.VarAttribute{ivar}; %reproduce the variable attributes
1690	ProjData.(VarName)=squeeze(FieldData.(VarName)(iz,:,:));% select the z index iz
1691	%TODO : do a vertical average for a thick plane
1692	if test_interp(2) \|\| test_interp(3)
1693	ProjData.(VarName)=interp2(Coord{3},Coord{2},ProjData.(VarName),Coord_x,Coord_y);
1694	end
1695	end
1696	end
1697	else %projection of structured coordinates on oblique plane
1698	% determine the boundaries of the projected field,
1699	% first find the 8 summits of the initial volume in the
1700	% PlaneAngle=[0 0 0];% default
1701	% PlaneAngle(1:numel(ObjectData.Angle))=ObjectData.Angle*pi/180;
1702	% new coordinates
1703	Coord{1}=FieldData.(FieldData.ListVarName{CellInfo{icell}.CoordIndex(1)});%initial z coordinates
1704	Coord{2}=FieldData.(FieldData.ListVarName{CellInfo{icell}.CoordIndex(2)});%initial y coordinates
1705	Coord{3}=FieldData.(FieldData.ListVarName{CellInfo{icell}.CoordIndex(3)});%initial x coordinates
1706	coord_x_proj=ObjectData.RangeX(1):InterpMesh:ObjectData.RangeX(2);% set of coordinates in the projection plane
1707	coord_y_proj=ObjectData.RangeY(1):InterpMesh:ObjectData.RangeY(2);
1708	%coord_z_proj=-floor(ObjectData.RangeInterp/InterpMesh):InterpMesh:floor(ObjectData.RangeInterp/InterpMesh);
1709	M=rodrigues(ObjectData.Angle);
1710	[XI,YI]=meshgrid(coord_x_proj,coord_y_proj);
1711	XI_proj=M(1,1)XI+M(2,1)YI+ObjectData.Coord(1,1);
1712	YI_proj=M(2,1)XI+M(2,2)YI+ObjectData.Coord(1,2);
1713	ZI_proj=M(3,1)XI+M(3,2)YI+ObjectData.Coord(1,3);
1714	for ivar=VarIndex
1715	VarName=FieldData.ListVarName{ivar};
1716	ListVarName=[ListVarName VarName];
1717	VarDimName=[VarDimName {{'coord_y','coord_x'}}];
1718	VarAttribute{length(ListVarName)}=FieldData.VarAttribute{ivar}; %reproduce the variable attributes
1719	FieldData.(VarName)=permute(FieldData.(VarName),[2 3 1]); %coordinate permutation needed to use interp3
1720	indexnan=isnan(FieldData.(VarName));
1721	FieldData.(VarName)(indexnan)=0;%set to zero the undefined values
1722	ProjData.coord_x=coord_x_proj;
1723	ProjData.coord_y=coord_y_proj;
1724	ProjData.(VarName)=interp3(Coord{3},Coord{2},Coord{1},double(FieldData.(VarName)),XI_proj,YI_proj,ZI_proj,'*linear');
1725	ProjData.(VarName)=nanmean(ProjData.(VarName),3);
1726	ProjData.(VarName)=squeeze(ProjData.(VarName));
1727	end
1728	end
1729	end
1730	end
1731	% update the global list of projected variables:
1732	ProjData.ListVarName=[ProjData.ListVarName ListVarName];
1733	ProjData.VarDimName=[ProjData.VarDimName VarDimName];
1734	ProjData.VarAttribute=[ProjData.VarAttribute VarAttribute];
1735
1736	%% projection of velocity components in the rotated coordinates
1737	if testangle
1738	ivar_U=[];ivar_V=[];ivar_W=[];
1739	for ivar=1:numel(VarAttribute)
1740	if isfield(VarAttribute{ivar},'Role')
1741	if strcmp(VarAttribute{ivar}.Role,'vector_x')
1742	ivar_U=ivar;
1743	elseif strcmp(VarAttribute{ivar}.Role,'vector_y')
1744	ivar_V=ivar;
1745	elseif strcmp(VarAttribute{ivar}.Role,'vector_z')
1746	ivar_W=ivar;
1747	end
1748	end
1749	end
1750	if ~isempty(ivar_U)
1751	if isempty(ivar_V)
1752	msgbox_uvmat('ERROR','v velocity component missing in proj_field.m')
1753	return
1754	else
1755	UName=ListVarName{ivar_U};
1756	VName=ListVarName{ivar_V};
1757	if check3D
1758	UValue=cos(PlaneAngle(1))ProjData.(UName)+ sin(PlaneAngle(1))ProjData.(VName);
1759	ProjData.(VName)=(-sin(PlaneAngle(1))ProjData.(UName)+ cos(PlaneAngle(1))ProjData.(VName));
1760	else
1761	UValue=cos(PlaneAngle(1))ProjData.(UName)+ sin(PlaneAngle(1))ProjData.(VName);
1762	ProjData.(VName)=(-sin(PlaneAngle(1))ProjData.(UName)+ cos(PlaneAngle(1))ProjData.(VName));
1763	end
1764	ProjData.(UName)=UValue;
1765	if ~isempty(ivar_W)
1766	WName=FieldData.ListVarName{ivar_W};
1767	VValue=ProjData.(VName)+ ProjData.(WName)*sin(Theta);%
1768	ProjData.(WName)=NormVec_XProjData.(UName)+ NormVec_YProjData.(VName)+ NormVec_Z* ProjData.(WName);
1769	ProjData.(VName)=VValue;
1770	end
1771	end
1772	end
1773	end
1774	end
1775
1776	%-----------------------------------------------------------------
1777	%projection in a volume
1778	function [ProjData,errormsg] = proj_volume(FieldData, ObjectData)
1779
1780	%-----------------------------------------------------------------
1781	ProjData=[];%default output
1782
1783	%% axis origin
1784	if isempty(ObjectData.Coord)
1785	ObjectData.Coord(1,1)=0;%origin of the plane set to [0 0] by default
1786	ObjectData.Coord(1,2)=0;
1787	ObjectData.Coord(1,3)=0;
1788	end
1789
1790	%% rotation angles
1791	VolumeAngle=[0 0 0];
1792	norm_plane=[0 0 1];
1793	if isfield(ObjectData,'Angle')&& isequal(size(ObjectData.Angle),[1 3])&& ~isequal(ObjectData.Angle,[0 0 0])
1794	PlaneAngle=ObjectData.Angle;
1795	VolumeAngle=ObjectData.Angle;
1796	om=norm(VolumeAngle);%norm of rotation angle in radians
1797	OmAxis=VolumeAngle/om; %unit vector marking the rotation axis
1798	cos_om=cos(pi*om/180);
1799	sin_om=sin(pi*om/180);
1800	coeff=OmAxis(3)*(1-cos_om);
1801	%components of the unity vector norm_plane normal to the projection plane
1802	norm_plane(1)=OmAxis(1)coeff+OmAxis(2)sin_om;
1803	norm_plane(2)=OmAxis(2)coeff-OmAxis(1)sin_om;
1804	norm_plane(3)=OmAxis(3)*coeff+cos_om;
1805	end
1806	testangle=~isequal(VolumeAngle,[0 0 0]);
1807
1808	%% mesh sizes DX, DY, DZ
1809	DX=0;
1810	DY=0; %default
1811	DZ=0;
1812	ProjMode=ObjectData.ProjMode;
1813	if isfield(ObjectData,'DX')&&~isempty(ObjectData.DX)
1814	DX=abs(ObjectData.DX);%mesh of interpolation points
1815	end
1816	if isfield(ObjectData,'DY')&&~isempty(ObjectData.DY)
1817	DY=abs(ObjectData.DY);%mesh of interpolation points
1818	end
1819	if isfield(ObjectData,'DZ')&&~isempty(ObjectData.DZ)
1820	DZ=abs(ObjectData.DZ);%mesh of interpolation points
1821	end
1822	if ~strcmp(ProjMode,'projection') && (DX==0\|\|DY==0\|\|DZ==0)
1823	errormsg='grid mesh DX , DY or DZ is missing';
1824	return
1825	end
1826
1827	%% extrema along each axis
1828	testXMin=0;
1829	testXMax=0;
1830	testYMin=0;
1831	testYMax=0;
1832	if isfield(ObjectData,'RangeX')
1833	XMin=min(ObjectData.RangeX);
1834	XMax=max(ObjectData.RangeX);
1835	testXMin=XMax>XMin;
1836	testXMax=1;
1837	end
1838	if isfield(ObjectData,'RangeY')
1839	YMin=min(ObjectData.RangeY);
1840	YMax=max(ObjectData.RangeY);
1841	testYMin=YMax>YMin;
1842	testYMax=1;
1843	end
1844	width=0;%default width of the projection band
1845	if isfield(ObjectData,'RangeZ')
1846	ZMin=min(ObjectData.RangeZ);
1847	ZMax=max(ObjectData.RangeZ);
1848	testZMin=ZMax>ZMin;
1849	testZMax=1;
1850	end
1851
1852	%% initiate Matlab structure for physical field
1853	[ProjData,errormsg]=proj_heading(FieldData,ObjectData);
1854	if ~isempty(errormsg)
1855	return
1856	end
1857
1858	ProjData.NbDim=3;
1859	ProjData.ListVarName={};
1860	ProjData.VarDimName={};
1861	if ~isequal(DX,0)&& ~isequal(DY,0)
1862	ProjData.CoordMesh=sqrt(DX*DY);%define typical data mesh, useful for mouse selection in plots
1863	elseif isfield(FieldData,'CoordMesh')
1864	ProjData.CoordMesh=FieldData.CoordMesh;
1865	end
1866
1867	error=0;%default
1868	flux=0;
1869	testfalse=0;
1870	ListIndex={};
1871
1872	%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1873	%% group the variables (fields of 'FieldData') in cells of variables with the same dimensions
1874	%-----------------------------------------------------------------
1875	idimvar=0;
1876
1877	[CellInfo,NbDimArray,errormsg]=find_field_cells(FieldData);
1878	% LOOP ON GROUPS OF VARIABLES SHARING THE SAME DIMENSIONS
1879	% CellVarIndex=cells of variable index arrays
1880	ivar_new=0; % index of the current variable in the projected field
1881	icoord=0;
1882	nbcoord=0;%number of added coordinate variables brought by projection
1883	nbvar=0;
1884	for icell=1:length(CellInfo)
1885	NbDim=NbDimArray(icell);
1886	if NbDim<3
1887	continue
1888	end
1889	VarIndex=CellInfo{icell}.VarIndex;% indices of the selected variables in the list FieldData.ListVarName
1890	VarType=CellInfo{icell}.VarType;
1891	ivar_X=VarType.coord_x;
1892	ivar_Y=VarType.coorCeld_y;
1893	ivar_Z=VarType.coord_z;
1894	ivar_U=VarType.vector_x;
1895	ivar_V=VarType.vector_y;
1896	ivar_W=VarType.vector_z;
1897	ivar_C=VarType.scalar ;
1898	ivar_Anc=VarType.ancillary;
1899	test_anc=zeros(size(VarIndex));
1900	test_anc(ivar_Anc)=ones(size(ivar_Anc));
1901	ivar_F=VarType.warnflag;
1902	ivar_FF=VarType.errorflag;
1903	%check_unstructured_coord=~isempty(ivar_X) && ~isempty(ivar_Y);
1904	DimCell=FieldData.VarDimName{VarIndex(1)};
1905	if ischar(DimCell)
1906	DimCell={DimCell};%name of dimensions
1907	end
1908
1909	%% case of input fields with unstructured coordinates
1910	if strcmp(CellInfo{icell}.CoordType,'scattered')
1911	XName=FieldData.ListVarName{ivar_X};
1912	YName=FieldData.ListVarName{ivar_Y};
1913	coord_x=FieldData.(XName);
1914	coord_y=FieldData.(YName);
1915	if length(ivar_Z)==1
1916	ZName=FieldData.ListVarName{ivar_Z};
1917	coord_z=FieldData.(ZName);
1918	end
1919	% translate initial coordinates
1920	coord_x=coord_x-ObjectData.Coord(1,1);
1921	coord_y=coord_y-ObjectData.Coord(1,2);
1922	if ~isempty(ivar_Z)
1923	coord_z=coord_z-ObjectData.Coord(1,3);
1924	end
1925
1926	% selection of the vectors in the projection range
1927	% if length(ivar_Z)==1 && width > 0
1928	% %components of the unitiy vector normal to the projection plane
1929	% fieldZ=NormVec_Xcoord_x + NormVec_Ycoord_y+ NormVec_Z*coord_z;% distance to the plane
1930	% indcut=find(abs(fieldZ) <= width);
1931	% for ivar=VarIndex
1932	% VarName=FieldData.ListVarName{ivar};
1933	% eval(['FieldData.' VarName '=FieldData.' VarName '(indcut);'])
1934	% % A VOIR : CAS DE VAR STRUCTUREE MAIS PAS GRILLE REGULIERE : INTERPOLER SUR GRILLE REGULIERE
1935	% end
1936	% coord_x=coord_x(indcut);
1937	% coord_y=coord_y(indcut);
1938	% coord_z=coord_z(indcut);
1939	% end
1940
1941	%rotate coordinates if needed: TODO modify
1942	if testangle
1943	coord_X=(coord_x cos(Phi) + coord_y sin(Phi));
1944	coord_Y=(-coord_x sin(Phi) + coord_y cos(Phi))*cos(Theta);
1945	if ~isempty(ivar_Z)
1946	coord_Y=coord_Y+coord_z *sin(Theta);
1947	end
1948
1949	coord_X=(coord_X cos(Psi) - coord_Y sin(Psi));%A VERIFIER
1950	coord_Y=(coord_X sin(Psi) + coord_Y cos(Psi));
1951
1952	else
1953	coord_X=coord_x;
1954	coord_Y=coord_y;
1955	coord_Z=coord_z;
1956	end
1957	%restriction to the range of x and y if imposed
1958	testin=ones(size(coord_X)); %default
1959	testbound=0;
1960	if testXMin
1961	testin=testin & (coord_X >= XMin);
1962	testbound=1;
1963	end
1964	if testXMax
1965	testin=testin & (coord_X <= XMax);
1966	testbound=1;
1967	end
1968	if testYMin
1969	testin=testin & (coord_Y >= YMin);
1970	testbound=1;
1971	end
1972	if testYMax
1973	testin=testin & (coord_Y <= YMax);
1974	testbound=1;
1975	end
1976	if testbound
1977	indcut=find(testin);
1978	for ivar=VarIndex
1979	VarName=FieldData.ListVarName{ivar};
1980	eval(['FieldData.' VarName '=FieldData.' VarName '(indcut);'])
1981	end
1982	coord_X=coord_X(indcut);
1983	coord_Y=coord_Y(indcut);
1984	if length(ivar_Z)==1
1985	coord_Z=coord_Z(indcut);
1986	end
1987	end
1988	% different cases of projection
1989	if isequal(ObjectData.ProjMode,'projection')%%%%%%% NOT USED %%%%%%%%%%
1990	for ivar=VarIndex %transfer variables to the projection plane
1991	VarName=FieldData.ListVarName{ivar};
1992	if ivar==ivar_X %x coordinate
1993	ProjData.(VarName)=coord_X;
1994	elseif ivar==ivar_Y % y coordinate
1995	ProjData.(VarName)=coord_Y;
1996	elseif isempty(ivar_Z) \|\| ivar~=ivar_Z % other variables (except Z coordinate wyhich is not reproduced)
1997	ProjData.(VarName)=FieldData.(VarName);
1998	end
1999	if isempty(ivar_Z) \|\| ivar~=ivar_Z
2000	ProjData.ListVarName=[ProjData.ListVarName VarName];
2001	ProjData.VarDimName=[ProjData.VarDimName DimCell];
2002	nbvar=nbvar+1;
2003	if isfield(FieldData,'VarAttribute') && length(FieldData.VarAttribute) >=ivar
2004	ProjData.VarAttribute{nbvar}=FieldData.VarAttribute{ivar};
2005	end
2006	end
2007	end
2008	elseif isequal(ObjectData.ProjMode,'interp_lin')\|\|isequal(ObjectData.ProjMode,'interp_tps')%interpolate data on a regular grid
2009	coord_x_proj=XMin:DX:XMax;
2010	coord_y_proj=YMin:DY:YMax;
2011	coord_z_proj=ZMin:DZ:ZMax;
2012	DimCell={'coord_z','coord_y','coord_x'};
2013	ProjData.ListVarName={'coord_z','coord_y','coord_x'};
2014	ProjData.VarDimName={'coord_z','coord_y','coord_x'};
2015	nbcoord=2;
2016	ProjData.coord_z=[ZMin ZMax];
2017	ProjData.coord_y=[YMin YMax];
2018	ProjData.coord_x=[XMin XMax];
2019	if isempty(ivar_X), ivar_X=0; end;
2020	if isempty(ivar_Y), ivar_Y=0; end;
2021	if isempty(ivar_Z), ivar_Z=0; end;
2022	if isempty(ivar_U), ivar_U=0; end;
2023	if isempty(ivar_V), ivar_V=0; end;
2024	if isempty(ivar_W), ivar_W=0; end;
2025	if isempty(ivar_F), ivar_F=0; end;
2026	if isempty(ivar_FF), ivar_FF=0; end;
2027	if ~isequal(ivar_FF,0)
2028	VarName_FF=FieldData.ListVarName{ivar_FF};
2029	eval(['indsel=find(FieldData.' VarName_FF '==0);'])
2030	coord_X=coord_X(indsel);
2031	coord_Y=coord_Y(indsel);
2032	end
2033	FF=zeros(1,length(coord_y_proj)*length(coord_x_proj));
2034	testFF=0;
2035	[X,Y,Z]=meshgrid(coord_y_proj,coord_z_proj,coord_x_proj);%grid in the new coordinates
2036	for ivar=VarIndex
2037	VarName=FieldData.ListVarName{ivar};
2038	if ~( ivar==ivar_X \|\| ivar==ivar_Y \|\| ivar==ivar_Z \|\| ivar==ivar_F \|\| ivar==ivar_FF \|\| test_anc(ivar)==1)
2039	ivar_new=ivar_new+1;
2040	ProjData.ListVarName=[ProjData.ListVarName {VarName}];
2041	ProjData.VarDimName=[ProjData.VarDimName {DimCell}];
2042	if isfield(FieldData,'VarAttribute') && length(FieldData.VarAttribute) >=ivar
2043	ProjData.VarAttribute{ivar_new+nbcoord}=FieldData.VarAttribute{ivar};
2044	end
2045	if ~isequal(ivar_FF,0)
2046	eval(['FieldData.' VarName '=FieldData.' VarName '(indsel);'])
2047	end
2048	% linear interpolation
2049	InterpFct=TriScatteredInterp(double(coord_X),double(coord_Y),double(coord_Z),double(FieldData.(VarName)));
2050	ProjData.(VarName)=InterpFct(X,Y,Z);
2051	% eval(['varline=reshape(ProjData.' VarName ',1,length(coord_y_proj)*length(coord_x_proj));'])
2052	% FFlag= isnan(varline); %detect undefined values NaN
2053	% indnan=find(FFlag);
2054	% if ~isempty(indnan)
2055	% varline(indnan)=zeros(size(indnan));
2056	% eval(['ProjData.' VarName '=reshape(varline,length(coord_y_proj),length(coord_x_proj));'])
2057	% FF(indnan)=ones(size(indnan));
2058	% testFF=1;
2059	% end
2060	if ivar==ivar_U
2061	ivar_U=ivar_new;
2062	end
2063	if ivar==ivar_V
2064	ivar_V=ivar_new;
2065	end
2066	if ivar==ivar_W
2067	ivar_W=ivar_new;
2068	end
2069	end
2070	end
2071	if testFF
2072	ProjData.FF=reshape(FF,length(coord_y_proj),length(coord_x_proj));
2073	ProjData.ListVarName=[ProjData.ListVarName {'FF'}];
2074	ProjData.VarDimName=[ProjData.VarDimName {DimCell}];
2075	ProjData.VarAttribute{ivar_new+1+nbcoord}.Role='errorflag';
2076	end
2077	end
2078
2079	%% case of input fields defined on a structured grid
2080	else
2081	VarName=FieldData.ListVarName{VarIndex(1)};%get the first variable of the cell to get the input matrix dimensions
2082	eval(['DimValue=size(FieldData.' VarName ');'])%input matrix dimensions
2083	DimValue(DimValue==1)=[];%remove singleton dimensions
2084	NbDim=numel(DimValue);%update number of space dimensions
2085	nbcolor=1; %default number of 'color' components: third matrix index without corresponding coordinate
2086	if NbDim>=3
2087	if NbDim>3
2088	errormsg='matrices with more than 3 dimensions not handled';
2089	return
2090	else
2091	if numel(find(VarType.coord))==2% the third matrix dimension does not correspond to a space coordinate
2092	nbcolor=DimValue(3);
2093	DimValue(3)=[]; %number of 'color' components updated
2094	NbDim=2;% space dimension set to 2
2095	end
2096	end
2097	end
2098	AYName=FieldData.ListVarName{VarType.coord(NbDim-1)};%name of input x coordinate (name preserved on projection)
2099	AXName=FieldData.ListVarName{VarType.coord(NbDim)};%name of input y coordinate (name preserved on projection)
2100	eval(['AX=FieldData.' AXName ';'])
2101	eval(['AY=FieldData.' AYName ';'])
2102	ListDimName=FieldData.VarDimName{VarIndex(1)};
2103	ProjData.ListVarName=[ProjData.ListVarName {AYName} {AXName}]; %TODO: check if it already exists in Projdata (several cells)
2104	ProjData.VarDimName=[ProjData.VarDimName {AYName} {AXName}];
2105
2106	% for idim=1:length(ListDimName)
2107	% DimName=ListDimName{idim};
2108	% if strcmp(DimName,'rgb')\|\|strcmp(DimName,'nb_coord')\|\|strcmp(DimName,'nb_coord_i')
2109	% nbcolor=DimValue(idim);
2110	% DimValue(idim)=[];
2111	% end
2112	% if isequal(DimName,'nb_coord_j')% NOTE: CASE OF TENSOR NOT TREATED
2113	% DimValue(idim)=[];
2114	% end
2115	% end
2116	Coord_z=[];
2117	Coord_y=[];
2118	Coord_x=[];
2119
2120	for idim=1:NbDim %loop on space dimensions
2121	test_interp(idim)=0;%test for coordiate interpolation (non regular grid), =0 by default
2122	ivar=VarType.coord(idim);% index of the variable corresponding to the current dimension
2123	if ~isequal(ivar,0)% a variable corresponds to the dimension #idim
2124	eval(['Coord{idim}=FieldData.' FieldData.ListVarName{ivar} ';']) ;% coord values for the input field
2125	if numel(Coord{idim})==2 %input array defined on a regular grid
2126	DCoord_min(idim)=(Coord{idim}(2)-Coord{idim}(1))/DimValue(idim);
2127	else
2128	DCoord=diff(Coord{idim});%array of coordinate derivatives for the input field
2129	DCoord_min(idim)=min(DCoord);
2130	DCoord_max=max(DCoord);
2131	% test_direct(idim)=DCoord_max>0;% =1 for increasing values, 0 otherwise
2132	if abs(DCoord_max-DCoord_min(idim))>abs(DCoord_max/1000)
2133	msgbox_uvmat('ERROR',['non monotonic dimension variable # ' num2str(idim) ' in proj_field.m'])
2134	return
2135	end
2136	test_interp(idim)=(DCoord_max-DCoord_min(idim))> 0.0001*abs(DCoord_max);% test grid regularity
2137	end
2138	test_direct(idim)=(DCoord_min(idim)>0);
2139	else % no variable associated with the dimension #idim, the coordinate value is set equal to the matrix index by default
2140	Coord_i_str=['Coord_' num2str(idim)];
2141	DCoord_min(idim)=1;%default
2142	Coord{idim}=[0.5 DimValue(idim)-0.5];
2143	test_direct(idim)=1;
2144	end
2145	end
2146	if DY==0
2147	DY=abs(DCoord_min(NbDim-1));
2148	end
2149	npY=1+round(abs(Coord{NbDim-1}(end)-Coord{NbDim-1}(1))/DY);%nbre of points after interpol
2150	if DX==0
2151	DX=abs(DCoord_min(NbDim));
2152	end
2153	npX=1+round(abs(Coord{NbDim}(end)-Coord{NbDim}(1))/DX);%nbre of points after interpol
2154	for idim=1:NbDim
2155	if test_interp(idim)
2156	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
2157	end
2158	end
2159	Coord_y=linspace(Coord{NbDim-1}(1),Coord{NbDim-1}(end),npY);
2160	test_direct_y=test_direct(NbDim-1);
2161	Coord_x=linspace(Coord{NbDim}(1),Coord{NbDim}(end),npX);
2162	test_direct_x=test_direct(NbDim);
2163	DAX=DCoord_min(NbDim);
2164	DAY=DCoord_min(NbDim-1);
2165	minAX=min(Coord_x);
2166	maxAX=max(Coord_x);
2167	minAY=min(Coord_y);
2168	maxAY=max(Coord_y);
2169	xcorner=[minAX maxAX minAX maxAX]-ObjectData.Coord(1,1);
2170	ycorner=[maxAY maxAY minAY minAY]-ObjectData.Coord(1,2);
2171	xcor_new=xcornercos(Phi)+ycornersin(Phi);%coord new frame
2172	ycor_new=-xcornersin(Phi)+ycornercos(Phi);
2173	if ~testXMax
2174	XMax=max(xcor_new);
2175	end
2176	if ~testXMin
2177	XMin=min(xcor_new);
2178	end
2179	if ~testYMax
2180	YMax=max(ycor_new);
2181	end
2182	if ~testYMin
2183	YMin=min(ycor_new);
2184	end
2185	DXinit=(maxAX-minAX)/(DimValue(NbDim)-1);
2186	DYinit=(maxAY-minAY)/(DimValue(NbDim-1)-1);
2187	if DX==0
2188	DX=DXinit;
2189	end
2190	if DY==0
2191	DY=DYinit;
2192	end
2193	if NbDim==3
2194	DZ=(Coord{1}(end)-Coord{1}(1))/(DimValue(1)-1);
2195	if ~test_direct(1)
2196	DZ=-DZ;
2197	end
2198	Coord_z=linspace(Coord{1}(1),Coord{1}(end),DimValue(1));
2199	test_direct_z=test_direct(1);
2200	end
2201	npX=floor((XMax-XMin)/DX+1);
2202	npY=floor((YMax-YMin)/DY+1);
2203	if test_direct_y
2204	coord_y_proj=linspace(YMin,YMax,npY);%abscissa of the new pixels along the line
2205	else
2206	coord_y_proj=linspace(YMax,YMin,npY);%abscissa of the new pixels along the line
2207	end
2208	if test_direct_x
2209	coord_x_proj=linspace(XMin,XMax,npX);%abscissa of the new pixels along the line
2210	else
2211	coord_x_proj=linspace(XMax,XMin,npX);%abscissa of the new pixels along the line
2212	end
2213
2214	% case with no rotation and interpolation
2215	if isequal(ProjMode,'projection') && isequal(Phi,0) && isequal(Theta,0) && isequal(Psi,0)
2216	if ~testXMin && ~testXMax && ~testYMin && ~testYMax && NbDim==2
2217	ProjData=FieldData;
2218	else
2219	indY=NbDim-1;
2220	if test_direct(indY)
2221	min_indy=ceil((YMin-Coord{indY}(1))/DYinit)+1;
2222	YIndexFirst=floor((YMax-Coord{indY}(1))/DYinit)+1;
2223	Ybound(1)=Coord{indY}(1)+DYinit*(min_indy-1);
2224	Ybound(2)=Coord{indY}(1)+DYinit*(YIndexFirst-1);
2225	else
2226	min_indy=ceil((Coord{indY}(1)-YMax)/DYinit)+1;
2227	max_indy=floor((Coord{indY}(1)-YMin)/DYinit)+1;
2228	Ybound(2)=Coord{indY}(1)-DYinit*(max_indy-1);
2229	Ybound(1)=Coord{indY}(1)-DYinit*(min_indy-1);
2230	end
2231	if test_direct(NbDim)==1
2232	min_indx=ceil((XMin-Coord{NbDim}(1))/DXinit)+1;
2233	max_indx=floor((XMax-Coord{NbDim}(1))/DXinit)+1;
2234	Xbound(1)=Coord{NbDim}(1)+DXinit*(min_indx-1);
2235	Xbound(2)=Coord{NbDim}(1)+DXinit*(max_indx-1);
2236	else
2237	min_indx=ceil((Coord{NbDim}(1)-XMax)/DXinit)+1;
2238	max_indx=floor((Coord{NbDim}(1)-XMin)/DXinit)+1;
2239	Xbound(2)=Coord{NbDim}(1)+DXinit*(max_indx-1);
2240	Xbound(1)=Coord{NbDim}(1)+DXinit*(min_indx-1);
2241	end
2242	if NbDim==3
2243	DimCell(1)=[]; %suppress z variable
2244	DimValue(1)=[];
2245	%structured coordinates
2246	if test_direct(1)
2247	iz=ceil((ObjectData.Coord(1,3)-Coord{1}(1))/DZ)+1;
2248	else
2249	iz=ceil((Coord{1}(1)-ObjectData.Coord(1,3))/DZ)+1;
2250	end
2251	end
2252	min_indy=max(min_indy,1);% deals with margin (bound lower than the first index)
2253	min_indx=max(min_indx,1);
2254	max_indy=min(max_indy,DimValue(1));
2255	max_indx=min(max_indx,DimValue(2));
2256	for ivar=VarIndex% loop on non coordinate variables
2257	VarName=FieldData.ListVarName{ivar};
2258	ProjData.ListVarName=[ProjData.ListVarName VarName];
2259	ProjData.VarDimName=[ProjData.VarDimName {DimCell}];
2260	if isfield(FieldData,'VarAttribute') && length(FieldData.VarAttribute)>=ivar
2261	ProjData.VarAttribute{length(ProjData.ListVarName)}=FieldData.VarAttribute{ivar};
2262	end
2263	if NbDim==3
2264	eval(['ProjData.' VarName '=squeeze(FieldData.' VarName '(iz,min_indy:max_indy,min_indx:max_indx));']);
2265	else
2266	eval(['ProjData.' VarName '=FieldData.' VarName '(min_indy:max_indy,min_indx:max_indx,:);']);
2267	end
2268	end
2269	eval(['ProjData.' AYName '=[Ybound(1) Ybound(2)];']) %record the new (projected ) y coordinates
2270	eval(['ProjData.' AXName '=[Xbound(1) Xbound(2)];']) %record the new (projected ) x coordinates
2271	end
2272	elseif isfield(FieldData,'A') %TO GENERALISE % case with rotation and/or interpolation
2273	if NbDim==2 %2D case
2274	[X,Y]=meshgrid(coord_x_proj,coord_y_proj);%grid in the new coordinates
2275	XIMA=ObjectData.Coord(1,1)+(X)cos(Phi)-Ysin(Phi);%corresponding coordinates in the original image
2276	YIMA=ObjectData.Coord(1,2)+(X)sin(Phi)+Ycos(Phi);
2277	XIMA=(XIMA-minAX)/DXinit+1;% image index along x
2278	YIMA=(-YIMA+maxAY)/DYinit+1;% image index along y
2279	XIMA=reshape(round(XIMA),1,npX*npY);%indices reorganized in 'line'
2280	YIMA=reshape(round(YIMA),1,npX*npY);
2281	flagin=XIMA>=1 & XIMA<=DimValue(2) & YIMA >=1 & YIMA<=DimValue(1);%flagin=1 inside the original image
2282	if isequal(ObjectData.ProjMode,'interp_tps')
2283	npx_interp_tps=ceil(abs(DX/DAX));
2284	npy_interp_tps=ceil(abs(DY/DAY));
2285	Minterp_tps=ones(npy_interp_tps,npx_interp_tps)/(npx_interp_tps*npy_interp_tps);
2286	test_interp_tps=1;
2287	else
2288	test_interp_tps=0;
2289	end
2290	ProjData.(AYName)=[coord_y_proj(1) coord_y_proj(end)]; %record the new (projected ) y coordinates
2291	ProjData.(AXName)=[coord_x_proj(1) coord_x_proj(end)]; %record the new (projected ) x coordinates
2292	for ivar=VarIndex
2293	VarName=FieldData.ListVarName{ivar};
2294	if test_interp(1) \|\| test_interp(2)%interpolate on a regular grid
2295	eval(['ProjData.' VarName '=interp2(Coord{2},Coord{1},FieldData.' VarName ',Coord_x,Coord_y'');']) %TO TEST
2296	end
2297	%filter the field (image) if option 'interp_tps' is used
2298	if test_interp_tps
2299	Aclass=class(FieldData.A);
2300	ProjData.(VarName)=interp_tps2(Minterp_tps,FieldData.(VarName),'valid');
2301	if ~isequal(Aclass,'double')
2302	ProjData.(VarName)=Aclass(FieldData.(VarName));%revert to integer values
2303	end
2304	end
2305	eval(['vec_A=reshape(FieldData.' VarName ',[],nbcolor);'])%put the original image in line
2306	%ind_in=find(flagin);
2307	ind_out=find(~flagin);
2308	ICOMB=(XIMA-1)*DimValue(1)+YIMA;
2309	ICOMB=ICOMB(flagin);%index corresponding to XIMA and YIMA in the aligned original image vec_A
2310	vec_B(flagin,1:nbcolor)=vec_A(ICOMB,:);
2311	for icolor=1:nbcolor
2312	vec_B(ind_out,icolor)=zeros(size(ind_out));
2313	end
2314	ProjData.ListVarName=[ProjData.ListVarName VarName];
2315	ProjData.VarDimName=[ProjData.VarDimName {DimCell}];
2316	if isfield(FieldData,'VarAttribute')&&length(FieldData.VarAttribute)>=ivar
2317	ProjData.VarAttribute{length(ProjData.ListVarName)+nbcoord}=FieldData.VarAttribute{ivar};
2318	end
2319	eval(['ProjData.' VarName '=reshape(vec_B,npY,npX,nbcolor);']);
2320	end
2321	ProjData.FF=reshape(~flagin,npY,npX);%false flag A FAIRE: tenir compte d'un flga ant???rieur
2322	ProjData.ListVarName=[ProjData.ListVarName 'FF'];
2323	ProjData.VarDimName=[ProjData.VarDimName {DimCell}];
2324	ProjData.VarAttribute{length(ProjData.ListVarName)}.Role='errorflag';
2325	else %3D case
2326	if ~testangle
2327	% unstructured z coordinate
2328	test_sup=(Coord{1}>=ObjectData.Coord(1,3));
2329	iz_sup=find(test_sup);
2330	iz=iz_sup(1);
2331	if iz>=1 & iz<=npz
2332	%ProjData.ListDimName=[ProjData.ListDimName ListDimName(2:end)];
2333	%ProjData.DimValue=[ProjData.DimValue npY npX];
2334	for ivar=VarIndex
2335	VarName=FieldData.ListVarName{ivar};
2336	ProjData.ListVarName=[ProjData.ListVarName VarName];
2337	ProjData.VarAttribute{length(ProjData.ListVarName)}=FieldData.VarAttribute{ivar}; %reproduce the variable attributes
2338	eval(['ProjData.' VarName '=squeeze(FieldData.' VarName '(iz,:,:));'])% select the z index iz
2339	%TODO : do a vertical average for a thick plane
2340	if test_interp(2) \|\| test_interp(3)
2341	eval(['ProjData.' VarName '=interp2(Coord{3},Coord{2},ProjData.' VarName ',Coord_x,Coord_y'');'])
2342	end
2343	end
2344	end
2345	else
2346	RotMatrix=rodrigues(om);
2347
2348	errormsg='projection of structured coordinates on oblique plane not yet implemented';
2349	%TODO: use interp3
2350	return
2351	end
2352	end
2353	end
2354	end
2355
2356	%% projection of velocity components in the rotated coordinates
2357	if testangle
2358	if isempty(ivar_V)
2359	errormsg='v velocity component missing in proj_field.m';
2360	return
2361	end
2362	UName=FieldData.ListVarName{ivar_U};
2363	VName=FieldData.ListVarName{ivar_V};
2364	eval(['ProjData.' UName '=cos(Phi)ProjData.' UName '+ sin(Phi)ProjData.' VName ';'])
2365	eval(['ProjData.' VName '=cos(Theta)(-sin(Phi)ProjData.' UName '+ cos(Phi)*ProjData.' VName ');'])
2366	if ~isempty(ivar_W)
2367	WName=FieldData.ListVarName{ivar_W};
2368	eval(['ProjData.' VName '=ProjData.' VName '+ ProjData.' WName '*sin(Theta);'])%
2369	eval(['ProjData.' WName '=NormVec_XProjData.' UName '+ NormVec_YProjData.' VName '+ NormVec_Z* ProjData.' WName ';']);
2370	end
2371	if ~isequal(Psi,0)
2372	eval(['ProjData.' UName '=cos(Psi)* ProjData.' UName '- sin(Psi)*ProjData.' VName ';']);
2373	eval(['ProjData.' VName '=sin(Psi)* ProjData.' UName '+ cos(Psi)*ProjData.' VName ';']);
2374	end
2375	end
2376	end
2377	if isempty(ProjData.ListVarName)
2378	errormsg='input field is not 3D, no volume projection';
2379	ProjData=[];
2380	end
2381
2382	%------------------------------------------------------------------------
2383	%--- transfer the global attributes
2384	function [ProjData,errormsg]=proj_heading(FieldData,ObjectData)
2385	%------------------------------------------------------------------------
2386	ProjData=[];%default
2387	errormsg='';%default
2388
2389	%% transfer error
2390	if isfield(FieldData,'Txt')
2391	errormsg=FieldData.Txt; %transmit erreur message
2392	return;
2393	end
2394
2395	%% transfer global attributes
2396	if ~isfield(FieldData,'ListGlobalAttribute')
2397	ProjData.ListGlobalAttribute={};
2398	else
2399	ProjData.ListGlobalAttribute=FieldData.ListGlobalAttribute;
2400	end
2401	for iattr=1:length(ProjData.ListGlobalAttribute)
2402	AttrName=ProjData.ListGlobalAttribute{iattr};
2403	if isfield(FieldData,AttrName)
2404	ProjData.(AttrName)=FieldData.(AttrName);
2405	end
2406	end
2407
2408	%% transfer coordinate unit
2409	if isfield(ProjData,'CoordUnit')
2410	ProjData=rmfield(ProjData,'CoordUnit');% do not transfer by default (to avoid x/y=1 for profiles)
2411	end
2412	if isfield(FieldData,'CoordUnit')
2413	if isfield(ObjectData,'CoordUnit') && ~strcmp(FieldData.CoordUnit,ObjectData.CoordUnit)
2414	errormsg=[ObjectData.Type ' in ' ObjectData.CoordUnit ' coordinates, while field in ' FieldData.CoordUnit ];
2415	return
2416	elseif strcmp(ObjectData.Type,'plane')\|\| strcmp(ObjectData.Type,'volume')
2417	ProjData.CoordUnit=FieldData.CoordUnit;
2418	end
2419	end
2420
2421	%% store the properties of the projection object
2422	ListObject={'Name','Type','ProjMode','angle','RangeX','RangeY','RangeZ','DX','DY','DZ','Coord'};
2423	for ilist=1:length(ListObject)
2424	if isfield(ObjectData,ListObject{ilist})
2425	val=ObjectData.(ListObject{ilist});
2426	if ~isempty(val)
2427	ProjData.(['ProjObject' ListObject{ilist}])=val;
2428	ProjData.ListGlobalAttribute=[ProjData.ListGlobalAttribute {['ProjObject' ListObject{ilist}]}];
2429	end
2430	end
2431	end
2432

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

Context Navigation

source: trunk/src/proj_field.m

Download in other formats: