1 | %SLR class definition
|
---|
2 | %
|
---|
3 | % Usage:
|
---|
4 | % slr=slr();
|
---|
5 |
|
---|
6 | classdef slr
|
---|
7 | properties (SetAccess=public)
|
---|
8 | deltathickness = NaN;
|
---|
9 | sealevel = NaN;
|
---|
10 | maxiter = 0;
|
---|
11 | reltol = 0;
|
---|
12 | abstol = 0;
|
---|
13 | love_h = 0; %provided by PREM model
|
---|
14 | love_k = 0; %ideam
|
---|
15 | love_l = 0; %ideam
|
---|
16 | tide_love_k = 0; %ideam
|
---|
17 | tide_love_h = 0; %ideam
|
---|
18 | fluid_love = 0;
|
---|
19 | equatorial_moi = 0;
|
---|
20 | polar_moi = 0;
|
---|
21 | angular_velocity = 0;
|
---|
22 | rigid = 0;
|
---|
23 | elastic = 0;
|
---|
24 | rotation = 0;
|
---|
25 | ocean_area_scaling = 0;
|
---|
26 | degacc = 0;
|
---|
27 | requested_outputs = {};
|
---|
28 | transitions = {};
|
---|
29 | end
|
---|
30 | methods
|
---|
31 | function self = slr(varargin) % {{{
|
---|
32 | switch nargin
|
---|
33 | case 0
|
---|
34 | self=setdefaultparameters(self);
|
---|
35 | otherwise
|
---|
36 | error('constructor not supported');
|
---|
37 | end
|
---|
38 | end % }}}
|
---|
39 | function self = setdefaultparameters(self) % {{{
|
---|
40 |
|
---|
41 | %Convergence criterion: absolute, relative and residual
|
---|
42 | self.reltol=NaN; %default
|
---|
43 | self.abstol=0.001; %1 mm of sea level rise
|
---|
44 |
|
---|
45 | %maximum of non-linear iterations.
|
---|
46 | self.maxiter=10;
|
---|
47 |
|
---|
48 | %computational flags:
|
---|
49 | self.rigid=1;
|
---|
50 | self.elastic=1;
|
---|
51 | self.rotation=0;
|
---|
52 | self.ocean_area_scaling=0;
|
---|
53 |
|
---|
54 | %tidal love numbers:
|
---|
55 | self.tide_love_h=0.6149; %degree 2
|
---|
56 | self.tide_love_k=0.3055; % degree 2
|
---|
57 |
|
---|
58 | %secular fluid love number:
|
---|
59 | self.fluid_love=0.942;
|
---|
60 |
|
---|
61 | %moment of inertia:
|
---|
62 | self.equatorial_moi=8.0077*10^37; % [kg m^2]
|
---|
63 | self.polar_moi =8.0345*10^37; % [kg m^2]
|
---|
64 |
|
---|
65 | % mean rotational velocity of earth
|
---|
66 | self.angular_velocity=7.2921*10^-5; % [s^-1]
|
---|
67 |
|
---|
68 | %numerical discretization accuracy
|
---|
69 | self.degacc=.01;
|
---|
70 |
|
---|
71 | %output default:
|
---|
72 | self.requested_outputs={'default'};
|
---|
73 |
|
---|
74 | %transitions should be a cell array of vectors:
|
---|
75 | self.transitions={};
|
---|
76 |
|
---|
77 | end % }}}
|
---|
78 | function md = checkconsistency(self,md,solution,analyses) % {{{
|
---|
79 |
|
---|
80 | if ~ismember('SealevelriseAnalysis',analyses), return; end
|
---|
81 | md = checkfield(md,'fieldname','slr.deltathickness','NaN',1,'Inf',1,'size',[md.mesh.numberofelements 1]);
|
---|
82 | md = checkfield(md,'fieldname','slr.sealevel','NaN',1,'Inf',1,'size',[md.mesh.numberofvertices 1]);
|
---|
83 | md = checkfield(md,'fieldname','slr.love_h','NaN',1,'Inf',1);
|
---|
84 | md = checkfield(md,'fieldname','slr.love_k','NaN',1,'Inf',1);
|
---|
85 | md = checkfield(md,'fieldname','slr.love_l','NaN',1,'Inf',1);
|
---|
86 | md = checkfield(md,'fieldname','slr.tide_love_h','NaN',1,'Inf',1);
|
---|
87 | md = checkfield(md,'fieldname','slr.tide_love_k','NaN',1,'Inf',1);
|
---|
88 | md = checkfield(md,'fieldname','slr.fluid_love','NaN',1,'Inf',1);
|
---|
89 | md = checkfield(md,'fieldname','slr.equatorial_moi','NaN',1,'Inf',1);
|
---|
90 | md = checkfield(md,'fieldname','slr.polar_moi','NaN',1,'Inf',1);
|
---|
91 | md = checkfield(md,'fieldname','slr.angular_velocity','NaN',1,'Inf',1);
|
---|
92 | md = checkfield(md,'fieldname','slr.reltol','size',[1 1]);
|
---|
93 | md = checkfield(md,'fieldname','slr.abstol','size',[1 1]);
|
---|
94 | md = checkfield(md,'fieldname','slr.maxiter','size',[1 1],'>=',1);
|
---|
95 | md = checkfield(md,'fieldname','slr.degacc','size',[1 1],'>=',1e-10);
|
---|
96 | md = checkfield(md,'fieldname','slr.requested_outputs','stringrow',1);
|
---|
97 |
|
---|
98 | %check that love numbers are provided at the same level of accuracy:
|
---|
99 | if (size(self.love_h,1)~=size(self.love_k,1) | size(self.love_h,1)~=size(self.love_l,1)),
|
---|
100 | error('slr error message: love numbers should be provided at the same level of accuracy');
|
---|
101 | end
|
---|
102 |
|
---|
103 | %cross check that whereever we have an ice load, the mask is <0 on each vertex:
|
---|
104 | pos=find(self.deltathickness);
|
---|
105 | maskpos=md.mask.ice_levelset(md.mesh.elements(pos,:));
|
---|
106 | [els,vertices]=find(maskpos>0);
|
---|
107 | if length(els),
|
---|
108 | error('slr checkconsistency fail: there are elements with ice loads where some vertices are not on the ice!');
|
---|
109 | end
|
---|
110 |
|
---|
111 | end % }}}
|
---|
112 | function list=defaultoutputs(self,md) % {{{
|
---|
113 | list = {'Sealevel'};
|
---|
114 | end % }}}
|
---|
115 | function disp(self) % {{{
|
---|
116 | disp(sprintf(' slr parameters:'));
|
---|
117 |
|
---|
118 | fielddisplay(self,'deltathickness','thickness change (main loading of the slr solution core [m]');
|
---|
119 | fielddisplay(self,'sealevel','current sea level (prior to computation) [m]');
|
---|
120 | fielddisplay(self,'reltol','sea level rise relative convergence criterion, (default, NaN: not applied)');
|
---|
121 | fielddisplay(self,'abstol','sea level rise absolute convergence criterion, NaN: not applied');
|
---|
122 | fielddisplay(self,'maxiter','maximum number of nonlinear iterations');
|
---|
123 | fielddisplay(self,'love_h','load Love number for radial displacement');
|
---|
124 | fielddisplay(self,'love_k','load Love number for gravitational potential perturbation');
|
---|
125 | fielddisplay(self,'love_l','load Love number for horizontal displacements');
|
---|
126 | fielddisplay(self,'tide_love_k','tidal load Love number (deg 2)');
|
---|
127 | fielddisplay(self,'tide_love_h','tidal load Love number (deg 2)');
|
---|
128 | fielddisplay(self,'fluid_love','secular fluid Love number');
|
---|
129 | fielddisplay(self,'equatorial_moi','mean equatorial moment of inertia [kg m^2]');
|
---|
130 | fielddisplay(self,'polar_moi','polar moment of inertia [kg m^2]');
|
---|
131 | fielddisplay(self,'angular_velocity','mean rotational velocity of earth [per second]');
|
---|
132 | fielddisplay(self,'rigid','rigid earth graviational potential perturbation');
|
---|
133 | fielddisplay(self,'elastic','elastic earth graviational potential perturbation');
|
---|
134 | fielddisplay(self,'rotation','earth rotational potential perturbation');
|
---|
135 | fielddisplay(self,'ocean_area_scaling','correction for model representation of ocean area [default: No correction]');
|
---|
136 | fielddisplay(self,'degacc','accuracy (default .01 deg) for numerical discretization of the Green''s functions');
|
---|
137 | fielddisplay(self,'transitions','indices into parts of the mesh that will be icecaps');
|
---|
138 | fielddisplay(self,'requested_outputs','additional outputs requested');
|
---|
139 |
|
---|
140 | end % }}}
|
---|
141 | function marshall(self,prefix,md,fid) % {{{
|
---|
142 | WriteData(fid,prefix,'object',self,'fieldname','deltathickness','format','DoubleMat','mattype',2);
|
---|
143 | %WriteData(fid,prefix,'object',self,'fieldname','deltathickness','format','DoubleMat','mattype',1,'timeserieslength',md.mesh.numberofelements+1);
|
---|
144 | WriteData(fid,prefix,'object',self,'fieldname','sealevel','mattype',1,'format','DoubleMat','timeserieslength',md.mesh.numberofvertices+1,'yts',md.constants.yts);
|
---|
145 | WriteData(fid,prefix,'object',self,'fieldname','reltol','format','Double');
|
---|
146 | WriteData(fid,prefix,'object',self,'fieldname','abstol','format','Double');
|
---|
147 | WriteData(fid,prefix,'object',self,'fieldname','maxiter','format','Integer');
|
---|
148 | WriteData(fid,prefix,'object',self,'fieldname','love_h','format','DoubleMat','mattype',1);
|
---|
149 | WriteData(fid,prefix,'object',self,'fieldname','love_k','format','DoubleMat','mattype',1);
|
---|
150 | WriteData(fid,prefix,'object',self,'fieldname','love_l','format','DoubleMat','mattype',1);
|
---|
151 | WriteData(fid,prefix,'object',self,'fieldname','tide_love_h','format','Double');
|
---|
152 | WriteData(fid,prefix,'object',self,'fieldname','tide_love_k','format','Double');
|
---|
153 | WriteData(fid,prefix,'object',self,'fieldname','fluid_love','format','Double');
|
---|
154 | WriteData(fid,prefix,'object',self,'fieldname','equatorial_moi','format','Double');
|
---|
155 | WriteData(fid,prefix,'object',self,'fieldname','polar_moi','format','Double');
|
---|
156 | WriteData(fid,prefix,'object',self,'fieldname','angular_velocity','format','Double');
|
---|
157 | WriteData(fid,prefix,'object',self,'fieldname','rigid','format','Boolean');
|
---|
158 | WriteData(fid,prefix,'object',self,'fieldname','elastic','format','Boolean');
|
---|
159 | WriteData(fid,prefix,'object',self,'fieldname','rotation','format','Boolean');
|
---|
160 | WriteData(fid,prefix,'object',self,'fieldname','ocean_area_scaling','format','Boolean');
|
---|
161 | WriteData(fid,prefix,'object',self,'fieldname','degacc','format','Double');
|
---|
162 | WriteData(fid,prefix,'object',self,'fieldname','transitions','format','MatArray');
|
---|
163 |
|
---|
164 | %process requested outputs
|
---|
165 | outputs = self.requested_outputs;
|
---|
166 | pos = find(ismember(outputs,'default'));
|
---|
167 | if ~isempty(pos),
|
---|
168 | outputs(pos) = []; %remove 'default' from outputs
|
---|
169 | outputs = [outputs defaultoutputs(self,md)]; %add defaults
|
---|
170 | end
|
---|
171 | WriteData(fid,prefix,'data',outputs,'name','md.slr.requested_outputs','format','StringArray');
|
---|
172 |
|
---|
173 | end % }}}
|
---|
174 | function savemodeljs(self,fid,modelname) % {{{
|
---|
175 |
|
---|
176 | writejs1Darray(fid,[modelname '.slr.deltathickness'],self.deltathickness);
|
---|
177 | writejs1Darray(fid,[modelname '.slr.sealevel'],self.sealevel);
|
---|
178 | writejsdouble(fid,[modelname '.slr.maxiter'],self.maxiter);
|
---|
179 | writejsdouble(fid,[modelname '.slr.reltol'],self.reltol);
|
---|
180 | writejsdouble(fid,[modelname '.slr.abstol'],self.abstol);
|
---|
181 | writejs1Darray(fid,[modelname '.slr.love_h'],self.love_h);
|
---|
182 | writejs1Darray(fid,[modelname '.slr.love_k'],self.love_k);
|
---|
183 | writejs1Darray(fid,[modelname '.slr.love_l'],self.love_l);
|
---|
184 | writejsdouble(fid,[modelname '.slr.tide_love_k'],self.tide_love_k);
|
---|
185 | writejsdouble(fid,[modelname '.slr.tide_love_h'],self.tide_love_h);
|
---|
186 | writejsdouble(fid,[modelname '.slr.fluid_love'],self.fluid_love);
|
---|
187 | writejsdouble(fid,[modelname '.slr.equatorial_moi'],self.equatorial_moi);
|
---|
188 | writejsdouble(fid,[modelname '.slr.polar_moi'],self.polar_moi);
|
---|
189 | writejsdouble(fid,[modelname '.slr.angular_velocity'],self.angular_velocity);
|
---|
190 | writejsdouble(fid,[modelname '.slr.rigid'],self.rigid);
|
---|
191 | writejsdouble(fid,[modelname '.slr.elastic'],self.elastic);
|
---|
192 | writejsdouble(fid,[modelname '.slr.rotation'],self.rotation);
|
---|
193 | writejsdouble(fid,[modelname '.slr.ocean_area_scaling'],self.ocean_area_scaling);
|
---|
194 | writejsdouble(fid,[modelname '.slr.degacc'],self.degacc);
|
---|
195 | writejscellstring(fid,[modelname '.slr.requested_outputs'],self.requested_outputs);
|
---|
196 | writejscellarray(fid,[modelname '.slr.transitions'],self.transitions);
|
---|
197 | end % }}}
|
---|
198 | end
|
---|
199 | end
|
---|