20 S Antilles#

Authors: Kidus Teshome, Cian Wilson

Steady state implementation#

Preamble#

Set some path information.

import sys, os
basedir = ''
if "__file__" in globals(): basedir = os.path.dirname(__file__)
sys.path.append(os.path.join(basedir, os.path.pardir))
sys.path.append(os.path.join(basedir, os.path.pardir, os.path.pardir, 'python'))

Loading everything we need from sz_problem and also set our default plotting and output preferences.

import utils
from sz_base import allsz_params
from sz_slab import create_slab, plot_slab
from sz_geometry import create_sz_geometry
from sz_problem import SubductionProblem
import numpy as np
import dolfinx as df
import pyvista as pv
if __name__ == "__main__" and "__file__" in globals():
    pv.OFF_SCREEN = True
import pathlib
output_folder = pathlib.Path(os.path.join(basedir, "output"))
output_folder.mkdir(exist_ok=True, parents=True)
import hashlib
import zipfile
import requests

Parameters#

We first select the name and resolution scale, resscale of the model.

Resolution

By default the resolution is low to allow for a quick runtime and smaller website size. If sufficient computational resources are available set a lower resscale to get higher resolutions and results with sufficient accuracy.

name = "20_S_Antilles"
resscale = 3.0

Then load the remaining parameters from the global suite.

szdict = allsz_params[name]
print("{}:".format(name))
print("{:<20} {:<10}".format('Key','Value'))
print("-"*85)
for k, v in allsz_params[name].items():
    if v is not None and k not in ['z0', 'z15']: print("{:<20} {}".format(k, v))
20_S_Antilles:
Key                  Value     
-------------------------------------------------------------------------------------
coast_distance       220
extra_width          14
lc_depth             30
io_depth             165
dirname              20_S_Antilles
As                   40.0
Ac                   90.0
A                    85
sztype               oceanic
Vs                   17.9
xs                   [0, 24.5, 64.0, 163.0, 179.5, 183.2, 204.0, 278.0, 306.0]
ys                   [-6, -15.0, -30.0, -70.0, -80.0, -82.5, -100.0, -200.0, -240.0]

Any of these can be modified in the dictionary.

Several additional parameters can be modified, for details see the documentation for the SubductionProblem class.

if __name__ == "__main__" and "__file__" not in globals():
    SubductionProblem?

The if __name__ == "__main__" and "__file__" not in globals(): logic above is only necessary to make sure that this only runs in the Jupyter notebook version of this code and not the python version. It is not generally necessary when getting the docstring of a function or class in Jupyter.

Setup#

Setup a slab.

slab = create_slab(szdict['xs'], szdict['ys'], resscale, szdict['lc_depth'])
_ = plot_slab(slab)
../../_images/4f64e15e098add019ed33dfc65342686714f2dde3ee22681cbf4767a7dbd4eab.png

Create the subduction zome geometry around the slab.

geom = create_sz_geometry(slab, resscale, szdict['sztype'], szdict['io_depth'], szdict['extra_width'], 
                             szdict['coast_distance'], szdict['lc_depth'], szdict['uc_depth'])
_ = geom.plot()
../../_images/eac5f8a7f3d625068361178ba9e6a3f4c827bcc617ee5979674f049d84ecd6c9.png

Finally, declare the SubductionZone problem class using the dictionary of parameters.

sz = SubductionProblem(geom, **szdict)

Solve#

Solve using a dislocation creep rheology and assuming a steady state.

sz.solve_steadystate_dislocationcreep()
Iteration   Residual     Relative Residual
------------------------------------------
0           3419.29      1           
1           2103.36      0.615144    
2           237.32       0.069406    
3           75.5205      0.0220866   
4           40.5745      0.0118664   
5           23.9037      0.00699084  
6           15.2892      0.00447144  
7           10.4347      0.00305171  
8           7.51317      0.00219729  
9           5.633        0.00164742  
10          4.33413      0.00126755  
11          3.38232      0.000989187 
12          2.65625      0.000776842 
13          2.08945      0.000611078 
14          1.64137      0.000480031 
15          1.28548      0.00037595  
16          1.00289      0.000293303 
17          0.77913      0.000227863 
18          0.602685     0.00017626  
19          0.464183     0.000135754 
20          0.35598      0.000104109 
21          0.271866     7.95094e-05 
22          0.206805     6.04817e-05 
23          0.156727     4.58362e-05 
24          0.118362     3.4616e-05  
25          0.0890979    2.60574e-05 
26          0.0668663    1.95556e-05 
27          0.050041     1.46349e-05 
28          0.0373518    1.09239e-05 
29          0.0278133    8.13423e-06 
30          0.0206649    6.04361e-06 
31          0.0153226    4.48123e-06 

Plot#

Plot the solution.

plotter = pv.Plotter()
utils.plot_scalar(sz.T_i, plotter=plotter, scale=sz.T0, gather=True, cmap='coolwarm', scalar_bar_args={'title': 'Temperature (deg C)', 'bold':True})
utils.plot_vector_glyphs(sz.vw_i, plotter=plotter, gather=True, factor=0.1, color='k', scale=utils.mps_to_mmpyr(sz.v0))
utils.plot_vector_glyphs(sz.vs_i, plotter=plotter, gather=True, factor=0.1, color='k', scale=utils.mps_to_mmpyr(sz.v0))
utils.plot_geometry(geom, plotter=plotter, color='green', width=2)
utils.plot_couplingdepth(slab, plotter=plotter, render_points_as_spheres=True, point_size=10.0, color='green')
utils.plot_show(plotter)
utils.plot_save(plotter, output_folder / "{}_ss_solution_resscale_{:.2f}.png".format(name, resscale))

Save it to disk so that it can be examined with other visualization software (e.g. Paraview).

filename = output_folder / "{}_ss_solution_resscale_{:.2f}.bp".format(name, resscale)
with df.io.VTXWriter(sz.mesh.comm, filename, [sz.T_i, sz.vs_i, sz.vw_i]) as vtx:
    vtx.write(0.0)
# zip the .bp folder so that it can be downloaded from Jupyter lab
if __name__ == "__main__" and "__file__" not in globals():
    zipfilename = filename.with_suffix(".zip")
    !zip -r $zipfilename $filename
  adding: output/20_S_Antilles_ss_solution_resscale_3.00.bp/ (stored 0%)
  adding: output/20_S_Antilles_ss_solution_resscale_3.00.bp/md.idx (deflated 59%)
  adding: output/20_S_Antilles_ss_solution_resscale_3.00.bp/profiling.json (deflated 59%)
  adding: output/20_S_Antilles_ss_solution_resscale_3.00.bp/mmd.0 (deflated 64%)
  adding: output/20_S_Antilles_ss_solution_resscale_3.00.bp/data.0
 (deflated 64%)
  adding: output/20_S_Antilles_ss_solution_resscale_3.00.bp/md.0 (deflated 75%)

Comparison#

Compare to the published result from Wilson & van Keken, PEPS, 2023 (II) and van Keken & Wilson, PEPS, 2023 (III). The original models used in these papers are also available as open-source repositories on github and zenodo.

First download the minimal necessary data from zenodo and check it is the right version.

zipfilename = pathlib.Path(os.path.join(basedir, os.path.pardir, os.path.pardir, "data", "vankeken_wilson_peps_2023_TF_lowres_minimal.zip"))
if not zipfilename.is_file():
    zipfileurl = 'https://zenodo.org/records/13234021/files/vankeken_wilson_peps_2023_TF_lowres_minimal.zip'
    r = requests.get(zipfileurl, allow_redirects=True)
    open(zipfilename, 'wb').write(r.content)
assert hashlib.md5(open(zipfilename, 'rb').read()).hexdigest() == 'a8eca6220f9bee091e41a680d502fe0d'
tffilename = os.path.join('vankeken_wilson_peps_2023_TF_lowres_minimal', 'sz_suite_ss', szdict['dirname']+'_minres_2.00.vtu')
tffilepath = os.path.join(os.pardir, os.pardir, 'data')
with zipfile.ZipFile(zipfilename, 'r') as z:
    z.extract(tffilename, path=tffilepath)
fxgrid = utils.grids_scalar(sz.T_i)[0]

tfgrid = pv.get_reader(os.path.join(tffilepath, tffilename)).read()

diffgrid = utils.pv_diff(fxgrid, tfgrid, field_name_map={'T':'Temperature::PotentialTemperature'}, pass_point_data=True)
diffgrid.set_active_scalars('T')
plotter_diff = pv.Plotter()
clim = None
plotter_diff.add_mesh(diffgrid, cmap='coolwarm', clim=clim, scalar_bar_args={'title': 'Temperature Difference (deg C)', 'bold':True})
utils.plot_geometry(geom, plotter=plotter_diff, color='green', width=2)
utils.plot_couplingdepth(slab, plotter=plotter_diff, render_points_as_spheres=True, point_size=5.0, color='green')
plotter_diff.enable_parallel_projection()
plotter_diff.view_xy()
plotter_diff.show()
integrated_data = diffgrid.integrate_data()
error = integrated_data['T'][0]/integrated_data['Area'][0]
print("Average error = {}".format(error,))
assert np.abs(error) < 5
Average error = 0.2689568213792986

Finish up#

Convert this notebook to a python script (making sure to save first)

if __name__ == "__main__" and "__file__" not in globals():
    from ipylab import JupyterFrontEnd
    app = JupyterFrontEnd()
    app.commands.execute('docmanager:save')
    !jupyter nbconvert --NbConvertApp.export_format=script --ClearOutputPreprocessor.enabled=True 20_S_Antilles.ipynb
[NbConvertApp] Converting notebook 20_S_Antilles.ipynb to script
[NbConvertApp] Writing 7034 bytes to 20_S_Antilles.py