function [lat,lon,mask,pv]=oct_get_pv(hisfile,gridfile,tindex,vlevel,coef)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
%  Compute the potential vorticity
%
%  Further Information:  
%  http://www.croco-ocean.org
%  
%  This file is part of CROCOTOOLS
%
%  CROCOTOOLS is free software; you can redistribute it and/or modify
%  it under the terms of the GNU General Public License as published
%  by the Free Software Foundation; either version 2 of the License,
%  or (at your option) any later version.
%
%  CROCOTOOLS is distributed in the hope that it will be useful, but
%  WITHOUT ANY WARRANTY; without even the implied warranty of
%  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
%  GNU General Public License for more details.
%
%  You should have received a copy of the GNU General Public License
%  along with this program; if not, write to the Free Software
%  Foundation, Inc., 59 Temple Place, Suite 330, Boston,
%  MA  02111-1307  USA
%
%  Copyright (c) 2002-2006 by Pierrick Penven 
%  e-mail:Pierrick.Penven@ird.fr  
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

[lat,lon,mask]=read_latlonmask(gridfile,'r');
mask(2:end-1,2:end-1)=mask(1:end-2,1:end-2).*...
                      mask(1:end-2,2:end-1).*...
                      mask(1:end-2,3:end).*...
                      mask(2:end-1,1:end-2).*...
                      mask(2:end-1,2:end-1).*...
                      mask(2:end-1,3:end).*...
                      mask(3:end,1:end-2).*...
                      mask(3:end,2:end-1).*...
                      mask(3:end,3:end);
if vlevel==0
%
% [xi+f]/(h+zeta)
%
  ncid = oct_netcdf.open(hisfile, 'NC_NOWRITE');
  ubar(:,:)=oct_netcdf.getVar(ncid, oct_netcdf.inqVarID(ncid, 'ubar'));
  vbar(:,:)=oct_netcdf.getVar(ncid, oct_netcdf.inqVarID(ncid, 'vbar'));
  zeta(:,:)=oct_netcdf.getVar(ncid, oct_netcdf.inqVarID(ncid, 'zeta'));
  oct_netcdf.close(ncid);
  ncid = oct_netcdf.open(gridfile, 'NC_NOWRITE');
  f=oct_netcdf.getVar(ncid, oct_netcdf.inqVarID(ncid, 'f'));
  h=oct_netcdf.getVar(ncid, oct_netcdf.inqVarID(ncid, 'h'));
  pm=oct_netcdf.getVar(ncid, oct_netcdf.inqVarID(ncid, 'pm'));
  pn=oct_netcdf.getVar(ncid, oct_netcdf.inqVarID(ncid, 'pn'));
  oct_netcdf.close(ncid);
  xi=psi2rho(vorticity(ubar,vbar,pm,pn)); 
  pv=mask.*coef.*(xi+f)./(h+zeta);
else
  epv = oct_ertel(hisfile,gridfile,'rho',tindex);  
  if vlevel >0
    pv=coef.*mask.*squeeze(epv(vlevel,:,:));
  else
    z=get_depths(hisfile,gridfile,tindex,'w');
    pv = coef.*mask.*vinterp(epv,z,vlevel);
  end
end
