Changeset 27714

Timestamp:

04/27/23 14:08:32 (23 months ago)

Author:

badgeley

Message:

CHG: updated documentation for interpICESat2ATL1415.m

File:

• issm/trunk-jpl/src/m/contrib/badgeley/interpICESat2ATL1415.m (modified) (3 diffs)

issm/trunk-jpl/src/m/contrib/badgeley/interpICESat2ATL1415.m

@@ -1 @@
-function hout = interpICESat2ATL1415(X,Y)
+function hout = interpICESat2ATL1415(X,Y,ncfile14,ncfile15)
+%interpICESat2ATL1415 - interpolate ICESat2 ATL14 + ATL15 data onto X and Y
+%
+%   Input:
+%     - optional 3rd input argument: path to ATL14 dataset
+%     - optional 4th input argument: path to ATL15 dataset
+%
+%   Output: 
+%     - hout: matrix of size number_of_vertices+1 x ATL15_num_timesteps
+%             it is a P1 timeseries
+%     NOTE: The output does not include ATL14 directly. ATL14 is only used 
+%           as a reference for getting absolute surface values from ATL15.
+%
+%   Examples:
+%      surface = interpICESat2ATL1415(md.mesh.x,md.mesh.y);
+%      surface = interpICESat2ATL1415(md.mesh.x,md.mesh.y,'~/ATL14_GL_0314_100m_002_01.nc','~/ATL15_GL_0314_01km_002_01.nc');
+%
+% Version 04/27/2023 Jessica Badgeley jessica.a.badgeley@dartmouth.edu
 
-filename_h = '/totten_1/ModelData/Greenland/ICESat2_ATL1415/ATL14_GL_0314_100m_002_01.nc';
-filename_dh = '/totten_1/ModelData/Greenland/ICESat2_ATL1415/ATL15_GL_0314_01km_002_01.nc';
+if nargin==3
+   filename_h = ncfile14;
+else
+   filename_h = '/totten_1/ModelData/Greenland/ICESat2_ATL1415/ATL14_GL_0314_100m_002_01.nc';
+end
+if nargin==4
+        filename_dh = ncfile15;
+else
+   filename_dh = '/totten_1/ModelData/Greenland/ICESat2_ATL1415/ATL15_GL_0314_01km_002_01.nc';
+end
 
 xh = ncread(filename_h,'x');
@@ -10 +35 @@
 ydh = ncread(filename_dh,'delta_h/y');
 tdh = ncread(filename_dh,'delta_h/time');
+
+tref = datetime('2018-01-01-00-00-00','format','yyyy-MM-dd-hh-mm-ss');
+ths = datenum(tref + days(tdh))./365.25;
 
 offset=2;
@@ -39 +67 @@
 ydh = ydh(id1ydh:id2ydh);
 
+disp('   --ICESat2 ATL1415: loading surface elevations');
 h = double(ncread(filename_h,'h',[id1xh id1yh],[id2xh-id1xh+1 id2yh-id1yh+1],[1 1]));
 dh = double(ncread(filename_dh,'delta_h/delta_h',[id1xdh id1ydh 1],[id2xdh-id1xdh+1 id2ydh-id1ydh+1 length(tdh)],[1 1 1]));
 geoid = interpBedmachineGreenland(X,Y,'geoid');
 
-href = InterpFromGrid(xh,yh,h',X,Y) - geoid;
-%hout(end+1) = 2020.0; %Data is the 2020 DEM
-
-tref = datetime('2018-01-01-00-00-00','format','yyyy-MM-dd-hh-mm-ss');
-ths = datenum(tref + days(tdh))./365.25;
+disp('   --ICESat2 ATL1415: interpolating');
+href = InterpFromGrid(xh,yh,h',X,Y) - geoid; %this reference DEM is for 2020.0, but it is not currently included in hout
 
 hout = ones([length(Y)+1,length(tdh)]);