source: issm/trunk-jpl/src/m/classes/slr.m@ 24940

Last change on this file since 24940 was 24940, checked in by Eric.Larour, 5 years ago

CHG: replacing earth area computations with a constant coming from the
slr class.
File size: 13.6 KB
Line 
1%SLR class definition
2%
3% Usage:
4% slr=slr();
5
6classdef slr
7 properties (SetAccess=public)
8 deltathickness = NaN;
9 sealevel = NaN;
10 spcthickness = NaN;
11 maxiter = 0;
12 reltol = 0;
13 abstol = 0;
14 love_h = 0; %provided by PREM model
15 love_k = 0; %ideam
16 love_l = 0; %ideam
17 tide_love_k = 0; %ideam
18 tide_love_h = 0; %ideam
19 fluid_love = 0;
20 equatorial_moi = 0;
21 polar_moi = 0;
22 angular_velocity = 0;
23 rigid = 0;
24 elastic = 0;
25 rotation = 0;
26 ocean_area_scaling = 0;
27 hydro_rate = 0; %rate of steric expansion from hydrological effects.
28 geodetic_run_frequency = 1; %how many time steps we skip before we run the geodetic part of the solver during transient
29 geodetic = 0; %compute geodetic SLR? (in addition to steric?)
30 degacc = 0;
31 loop_increment = 0;
32 horiz = 0;
33 Ngia = NaN;
34 Ugia = NaN;
35 eartharea = 4*pi*planetradius('earth')^2;
36
37 requested_outputs = {};
38 transitions = {};
39 end
40 methods
41 function self = slr(varargin) % {{{
42 switch nargin
43 case 0
44 self=setdefaultparameters(self);
45 otherwise
46 error('constructor not supported');
47 end
48 end % }}}
49 function self = setdefaultparameters(self) % {{{
50
51 %Convergence criterion: absolute, relative and residual
52 self.reltol=0.01; % 1 per cent
53 self.abstol=NaN; % default
54
55 %maximum of non-linear iterations.
56 self.maxiter=5;
57 self.loop_increment=200;
58
59 %computational flags:
60 self.geodetic=0;
61 self.rigid=1;
62 self.elastic=1;
63 self.ocean_area_scaling=0;
64 self.rotation=1;
65
66 %tidal love numbers:
67 self.tide_love_h=0.6149; %degree 2
68 self.tide_love_k=0.3055; % degree 2
69
70 %secular fluid love number:
71 self.fluid_love=0.942;
72
73 %moment of inertia:
74 self.equatorial_moi=8.0077*10^37; % [kg m^2]
75 self.polar_moi =8.0345*10^37; % [kg m^2]
76
77 % mean rotational velocity of earth
78 self.angular_velocity=7.2921*10^-5; % [s^-1]
79
80 %numerical discretization accuracy
81 self.degacc=.01;
82
83 %hydro
84 self.hydro_rate=0;
85
86 %how many time steps we skip before we run SLR solver during transient
87 self.geodetic_run_frequency=1;
88
89 %output default:
90 self.requested_outputs={'default'};
91
92 %transitions should be a cell array of vectors:
93 self.transitions={};
94
95 %horizontal displacement? (not by default)
96 self.horiz=0;
97
98 end % }}}
99 function md = checkconsistency(self,md,solution,analyses) % {{{
100
101 if ~ismember('SealevelriseAnalysis',analyses) | (strcmp(solution,'TransientSolution') & md.transient.isslr==0),
102 return;
103 end
104
105 %md = checkfield(md,'fieldname','slr.deltathickness','NaN',1,'Inf',1,'size',[md.mesh.numberofelements 1]);
106 md = checkfield(md,'fieldname','slr.deltathickness','timeseries',1,'NaN',1,'Inf',1);
107 md = checkfield(md,'fieldname','slr.sealevel','NaN',1,'Inf',1,'size',[md.mesh.numberofvertices 1]);
108 md = checkfield(md,'fieldname','slr.spcthickness','Inf',1,'timeseries',1);
109 md = checkfield(md,'fieldname','slr.love_h','NaN',1,'Inf',1);
110 md = checkfield(md,'fieldname','slr.love_k','NaN',1,'Inf',1);
111 md = checkfield(md,'fieldname','slr.love_l','NaN',1,'Inf',1);
112 md = checkfield(md,'fieldname','slr.tide_love_h','NaN',1,'Inf',1);
113 md = checkfield(md,'fieldname','slr.tide_love_k','NaN',1,'Inf',1);
114 md = checkfield(md,'fieldname','slr.fluid_love','NaN',1,'Inf',1);
115 md = checkfield(md,'fieldname','slr.equatorial_moi','NaN',1,'Inf',1);
116 md = checkfield(md,'fieldname','slr.polar_moi','NaN',1,'Inf',1);
117 md = checkfield(md,'fieldname','slr.angular_velocity','NaN',1,'Inf',1);
118 md = checkfield(md,'fieldname','slr.reltol','size',[1 1]);
119 md = checkfield(md,'fieldname','slr.abstol','size',[1 1]);
120 md = checkfield(md,'fieldname','slr.maxiter','size',[1 1],'>=',1);
121 md = checkfield(md,'fieldname','slr.geodetic_run_frequency','size',[1 1],'>=',1);
122 md = checkfield(md,'fieldname','slr.hydro_rate','NaN',1,'Inf',1,'size',[md.mesh.numberofvertices 1]);
123 md = checkfield(md,'fieldname','slr.degacc','size',[1 1],'>=',1e-10);
124 md = checkfield(md,'fieldname','slr.requested_outputs','stringrow',1);
125 md = checkfield(md,'fieldname','slr.loop_increment','NaN',1,'Inf',1,'>=',1);
126 md = checkfield(md,'fieldname','slr.horiz','NaN',1,'Inf',1,'values',[0 1]);
127 md = checkfield(md,'fieldname','slr.Ngia','NaN',1,'Inf',1,'size',[md.mesh.numberofvertices 1]);
128 md = checkfield(md,'fieldname','slr.Ugia','NaN',1,'Inf',1,'size',[md.mesh.numberofvertices 1]);
129
130 %check that love numbers are provided at the same level of accuracy:
131 if (size(self.love_h,1)~=size(self.love_k,1) | size(self.love_h,1)~=size(self.love_l,1)),
132 error('slr error message: love numbers should be provided at the same level of accuracy');
133 end
134
135 %cross check that whereever we have an ice load, the mask is <0 on each vertex:
136 %pos=find(self.deltathickness);
137 %maskpos=md.mask.ice_levelset(md.mesh.elements(pos,:));
138 %[els,vertices]=find(maskpos>0);
139 %if length(els),
140 % warning('slr checkconsistency fail: there are elements with ice loads where some vertices are not on the ice!');
141 %end
142
143 %check that if geodetic is requested, we are a mesh3dsurface model (planet), or if we are not,
144 %a coupler to a planet model is provided.
145 if self.geodetic,
146 if md.transient.iscoupler,
147 %we are good;
148 else
149 if strcmpi(class(md.mesh),'mesh3dsurface'),
150 %we are good
151 else
152 error('model is requesting geodetic computations without being a mesh3dsurface, or being coupled to one!');
153 end
154 end
155 end
156
157 end % }}}
158 function list=defaultoutputs(self,md) % {{{
159 list = {'Sealevel'};
160 end % }}}
161 function disp(self) % {{{
162 disp(sprintf(' slr parameters:'));
163
164 fielddisplay(self,'deltathickness','thickness change: ice height equivalent [m]');
165 fielddisplay(self,'sealevel','current sea level (prior to computation) [m]');
166 fielddisplay(self,'spcthickness','thickness constraints (NaN means no constraint) [m]');
167 fielddisplay(self,'reltol','sea level rise relative convergence criterion, (default, NaN: not applied)');
168 fielddisplay(self,'abstol','sea level rise absolute convergence criterion, NaN: not applied');
169 fielddisplay(self,'maxiter','maximum number of nonlinear iterations');
170 fielddisplay(self,'love_h','load Love number for radial displacement');
171 fielddisplay(self,'love_k','load Love number for gravitational potential perturbation');
172 fielddisplay(self,'love_l','load Love number for horizontal displacements');
173 fielddisplay(self,'tide_love_k','tidal load Love number (deg 2)');
174 fielddisplay(self,'tide_love_h','tidal load Love number (deg 2)');
175 fielddisplay(self,'fluid_love','secular fluid Love number');
176 fielddisplay(self,'equatorial_moi','mean equatorial moment of inertia [kg m^2]');
177 fielddisplay(self,'polar_moi','polar moment of inertia [kg m^2]');
178 fielddisplay(self,'angular_velocity','mean rotational velocity of earth [per second]');
179 fielddisplay(self,'ocean_area_scaling','correction for model representation of ocean area [default: No correction]');
180 fielddisplay(self,'hydro_rate','rate of hydrological expansion (in mm/yr)');
181 fielddisplay(self,'Ngia','rate of viscous (GIA) geoid expansion (in mm/yr)');
182 fielddisplay(self,'Ugia','rate of viscous (GIA) bedrock uplift (in mm/yr)');
183 fielddisplay(self,'loop_increment','vector assembly (in the convolution) framentation');
184 fielddisplay(self,'geodetic','compute geodetic SLR? ( in addition to steric?) default 0');
185 fielddisplay(self,'geodetic_run_frequency','how many time steps we skip before we run SLR solver during transient (default: 1)');
186 fielddisplay(self,'rigid','rigid earth graviational potential perturbation');
187 fielddisplay(self,'elastic','elastic earth graviational potential perturbation');
188 fielddisplay(self,'rotation','earth rotational potential perturbation');
189 fielddisplay(self,'degacc','accuracy (default .01 deg) for numerical discretization of the Green''s functions');
190 fielddisplay(self,'transitions','indices into parts of the mesh that will be icecaps');
191 fielddisplay(self,'requested_outputs','additional outputs requested');
192
193 end % }}}
194 function marshall(self,prefix,md,fid) % {{{
195 %WriteData(fid,prefix,'object',self,'fieldname','deltathickness','format','DoubleMat','mattype',2);
196 WriteData(fid,prefix,'object',self,'fieldname','deltathickness','format','DoubleMat','mattype',2,'timeserieslength',md.mesh.numberofelements+1,'yts',md.constants.yts);
197 %WriteData(fid,prefix,'object',self,'fieldname','deltathickness','format','DoubleMat','mattype',1,'timeserieslength',md.mesh.numberofelements+1);
198 WriteData(fid,prefix,'object',self,'fieldname','sealevel','mattype',1,'format','DoubleMat','timeserieslength',md.mesh.numberofvertices+1,'yts',md.constants.yts);
199 WriteData(fid,prefix,'object',self,'fieldname','spcthickness','format','DoubleMat','mattype',1,'timeserieslength',md.mesh.numberofvertices+1,'yts',md.constants.yts);
200 WriteData(fid,prefix,'object',self,'fieldname','reltol','format','Double');
201 WriteData(fid,prefix,'object',self,'fieldname','abstol','format','Double');
202 WriteData(fid,prefix,'object',self,'fieldname','maxiter','format','Integer');
203 WriteData(fid,prefix,'object',self,'fieldname','love_h','format','DoubleMat','mattype',1);
204 WriteData(fid,prefix,'object',self,'fieldname','love_k','format','DoubleMat','mattype',1);
205 WriteData(fid,prefix,'object',self,'fieldname','love_l','format','DoubleMat','mattype',1);
206 WriteData(fid,prefix,'object',self,'fieldname','tide_love_h','format','Double');
207 WriteData(fid,prefix,'object',self,'fieldname','tide_love_k','format','Double');
208 WriteData(fid,prefix,'object',self,'fieldname','fluid_love','format','Double');
209 WriteData(fid,prefix,'object',self,'fieldname','equatorial_moi','format','Double');
210 WriteData(fid,prefix,'object',self,'fieldname','polar_moi','format','Double');
211 WriteData(fid,prefix,'object',self,'fieldname','angular_velocity','format','Double');
212 WriteData(fid,prefix,'object',self,'fieldname','rigid','format','Boolean');
213 WriteData(fid,prefix,'object',self,'fieldname','elastic','format','Boolean');
214 WriteData(fid,prefix,'object',self,'fieldname','rotation','format','Boolean');
215 WriteData(fid,prefix,'object',self,'fieldname','ocean_area_scaling','format','Boolean');
216 WriteData(fid,prefix,'object',self,'fieldname','geodetic_run_frequency','format','Integer');
217 WriteData(fid,prefix,'object',self,'fieldname','hydro_rate','format','DoubleMat','mattype',1,'timeserieslength',md.mesh.numberofvertices+1,'yts',md.constants.yts,'scale',1e-3/md.constants.yts);
218 WriteData(fid,prefix,'object',self,'fieldname','Ngia','format','DoubleMat','mattype',1,'scale',1e-3/md.constants.yts);
219 WriteData(fid,prefix,'object',self,'fieldname','Ugia','format','DoubleMat','mattype',1,'scale',1e-3/md.constants.yts);
220 WriteData(fid,prefix,'object',self,'fieldname','degacc','format','Double');
221 WriteData(fid,prefix,'object',self,'fieldname','transitions','format','MatArray');
222 WriteData(fid,prefix,'object',self,'fieldname','loop_increment','format','Integer');
223 WriteData(fid,prefix,'object',self,'fieldname','horiz','format','Integer');
224 WriteData(fid,prefix,'object',self,'fieldname','geodetic','format','Integer');
225 WriteData(fid,prefix,'object',self,'fieldname','eartharea','format','Double');
226
227 %process requested outputs
228 outputs = self.requested_outputs;
229 pos = find(ismember(outputs,'default'));
230 if ~isempty(pos),
231 outputs(pos) = []; %remove 'default' from outputs
232 outputs = [outputs defaultoutputs(self,md)]; %add defaults
233 end
234 WriteData(fid,prefix,'data',outputs,'name','md.slr.requested_outputs','format','StringArray');
235
236 end % }}}
237 function savemodeljs(self,fid,modelname) % {{{
238
239 writejs1Darray(fid,[modelname '.slr.deltathickness'],self.deltathickness);
240 writejs1Darray(fid,[modelname '.slr.sealevel'],self.sealevel);
241 writejs1Darray(fid,[modelname '.slr.spcthickness'],self.spcthickness);
242 writejsdouble(fid,[modelname '.slr.maxiter'],self.maxiter);
243 writejsdouble(fid,[modelname '.slr.reltol'],self.reltol);
244 writejsdouble(fid,[modelname '.slr.abstol'],self.abstol);
245 writejs1Darray(fid,[modelname '.slr.love_h'],self.love_h);
246 writejs1Darray(fid,[modelname '.slr.love_k'],self.love_k);
247 writejs1Darray(fid,[modelname '.slr.love_l'],self.love_l);
248 writejsdouble(fid,[modelname '.slr.tide_love_k'],self.tide_love_k);
249 writejsdouble(fid,[modelname '.slr.tide_love_h'],self.tide_love_h);
250 writejsdouble(fid,[modelname '.slr.fluid_love'],self.fluid_love);
251 writejsdouble(fid,[modelname '.slr.equatorial_moi'],self.equatorial_moi);
252 writejsdouble(fid,[modelname '.slr.polar_moi'],self.polar_moi);
253 writejsdouble(fid,[modelname '.slr.angular_velocity'],self.angular_velocity);
254 writejsdouble(fid,[modelname '.slr.rigid'],self.rigid);
255 writejsdouble(fid,[modelname '.slr.elastic'],self.elastic);
256 writejsdouble(fid,[modelname '.slr.rotation'],self.rotation);
257 writejsdouble(fid,[modelname '.slr.ocean_area_scaling'],self.ocean_area_scaling);
258 writejsdouble(fid,[modelname '.slr.geodetic_run_frequency'],self.geodetic_run_frequency);
259 writejs1Darray(fid,[modelname '.slr.hydro_rate'],self.hydro_rate);
260 writejsdouble(fid,[modelname '.slr.degacc'],self.degacc);
261 writejscellstring(fid,[modelname '.slr.requested_outputs'],self.requested_outputs);
262 writejscellarray(fid,[modelname '.slr.transitions'],self.transitions);
263 end % }}}
264 function self = extrude(self,md) % {{{
265 self.sealevel=project3d(md,'vector',self.sealevel,'type','node');
266 end % }}}
267 end
268end
Note: See TracBrowser for help on using the repository browser.