matlab_class/gcmfaces_calc/calc_MeridionalTransport.m

function [FLD]=calc_MeridionalTransport(fldU,fldV,varargin);
%object:    compute net meridional transports of e.g. heat or fresh water
%inputs:    fldU and fldV are the fields of grid point transport
%optional:  doScaleWithArea, if 1 then multiply fldU by
%               dyg.*drf and accordingly for fldV.
%               If 0 (default) then it is assumed that those factors
%               have already been included (e.g. by pkg/diagnostics).
%output:    FLD is the integrated transport vector (one point per latitude).
%
%notes:     mygrid.LATS_MASKS is the set of quasi longitudinal lines along which
%               transports will integrated, as computed in gcmfaces_lines_zonal

global mygrid;

if nargin==3; doScaleWithArea=varargin{1}; else; doScaleWithArea=0; end;

%initialize output:
n3=max(size(fldU.f1,3),1); n4=max(size(fldV.f1,4),1);
FLD=NaN*squeeze(zeros(length(mygrid.LATS_MASKS),n4));

%prepare fldU/fldV:
fldU(isnan(fldU))=0; fldV(isnan(fldV))=0;

if doScaleWithArea;
   dxg=mk3D(mygrid.DXG,fldU); dyg=mk3D(mygrid.DYG,fldU); drf=mk3D(mygrid.DRF,fldU);
   for k4=1:n4;
   fldU(:,:,:,k4)=fldU(:,:,:,k4).*dyg.*drf;
   fldV(:,:,:,k4)=fldV(:,:,:,k4).*dxg.*drf;
   end;
end;

%use array format to speed up computation below:
fldU=convert2array(fldU); fldV=convert2array(fldV);

for iy=1:length(mygrid.LATS_MASKS); 

   %get list ofpoints that form a zonal band:
   mskW=mygrid.LATS_MASKS(iy).mskWedge;
   vecW=gcmfaces_subset(mskW,fldU);
   mskS=mygrid.LATS_MASKS(iy).mskSedge;
   vecS=gcmfaces_subset(mskS,fldV);
   
   %store vertically integrated transport:
   FLD(iy,:)=nansum(nansum(vecW,1)+nansum(vecS,1),2);

end; 


1	gforget	1.3	function [FLD]=calc_MeridionalTransport(fldU,fldV,varargin);
2	gforget	1.2	%object: compute net meridional transports of e.g. heat or fresh water
3			%inputs: fldU and fldV are the fields of grid point transport
4			%optional: doScaleWithArea, if 1 then multiply fldU by
5	gforget	1.4	% dyg.*drf and accordingly for fldV.
6	gforget	1.2	% If 0 (default) then it is assumed that those factors
7			% have already been included (e.g. by pkg/diagnostics).
8			%output: FLD is the integrated transport vector (one point per latitude).
9	gforget	1.3	%
10			%notes: mygrid.LATS_MASKS is the set of quasi longitudinal lines along which
11			% transports will integrated, as computed in gcmfaces_lines_zonal
12	gforget	1.1
13			global mygrid;
14
15	gforget	1.3	if nargin==3; doScaleWithArea=varargin{1}; else; doScaleWithArea=0; end;
16	gforget	1.1
17			%initialize output:
18			n3=max(size(fldU.f1,3),1); n4=max(size(fldV.f1,4),1);
19	gforget	1.3	FLD=NaN*squeeze(zeros(length(mygrid.LATS_MASKS),n4));
20	gforget	1.1
21			%prepare fldU/fldV:
22			fldU(isnan(fldU))=0; fldV(isnan(fldV))=0;
23
24			if doScaleWithArea;
25			dxg=mk3D(mygrid.DXG,fldU); dyg=mk3D(mygrid.DYG,fldU); drf=mk3D(mygrid.DRF,fldU);
26			for k4=1:n4;
27	gforget	1.4	fldU(:,:,:,k4)=fldU(:,:,:,k4).dyg.drf;
28			fldV(:,:,:,k4)=fldV(:,:,:,k4).dxg.drf;
29	gforget	1.1	end;
30			end;
31
32			%use array format to speed up computation below:
33			fldU=convert2array(fldU); fldV=convert2array(fldV);
34
35	gforget	1.3	for iy=1:length(mygrid.LATS_MASKS);
36	gforget	1.1
37			%get list ofpoints that form a zonal band:
38	gforget	1.5	mskW=mygrid.LATS_MASKS(iy).mskWedge;
39			vecW=gcmfaces_subset(mskW,fldU);
40			mskS=mygrid.LATS_MASKS(iy).mskSedge;
41			vecS=gcmfaces_subset(mskS,fldV);
42
43			%store vertically integrated transport:
44			FLD(iy,:)=nansum(nansum(vecW,1)+nansum(vecS,1),2);
45	gforget	1.1
46			end;
47
48