Skip to content

Commit e2febc1

Browse files
adding documentation
1 parent 27679c8 commit e2febc1

14 files changed

+255
-12
lines changed

cookbooks/continental_compression_with_imposed_faults/continental_compression_with_imposed_faults.prm

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Continental Compression with Imposed Faults Cookbooks
1+
# Continental Compression with Imposed Faults Cookbook
22
# This cookbook builds on the continental extension cookbook
33
# and a recent paper investigating rift inversion (Vasey et al., 2024,
44
# https://doi.org/10.1130/G51489.1) to demonstrate how to design
@@ -8,9 +8,11 @@
88
# Altai, which has experienced low magnitudes of compressional deformation
99
# since the onset of the India-Asia collision and contains evidence for
1010
# reactivation of normal faults formed during prior phases of deformation.
11+
# (Howard et al., 2003, https://doi.org/10.1046/j.1365-2117.2003.00198.x).
1112
# The faults locations and properties are defined using the Geodynamic
1213
# World Builder.
1314

15+
1416
#### Global parameters
1517
set World builder file = continental_compression_with_imposed_faults.wb
1618
set Dimension = 2
@@ -111,8 +113,8 @@ subsection Mesh deformation
111113
end
112114

113115
# Velocity on boundaries characterized by functions
114-
# The outward velocity (x-direction) on the left and right walls is 0.25 cm/year
115-
# The vertical velocity at the base is 0.25 cm/year (balances outflow on sides)
116+
# The combined horizontal velocity (x-direction) magnitude on the left and right walls is 0.2 cm/year
117+
# The vertical velocity at the base is 0.2 cm/year (balances outflow on sides)
116118
# Velocity components parallel to the base (x-velocity) and side walls (y-velocity)
117119
# are unconstrained (i.e. 'free').
118120
subsection Boundary velocity model
@@ -266,8 +268,7 @@ end
266268
# Values for most rheological parameters are specified for a background material and
267269
# each compositional field. Values for viscous deformation are based on dislocation
268270
# creep flow-laws, with distinct values for the upper crust (wet quartzite), lower
269-
# crust (wet anorthite) and mantle (dry olivine). Table 1 of Naliboff and Buiter (2015),
270-
# Earth Planet. Sci. Lett., v.421, p. 58-67 contains values for each of these flow laws.
271+
# crust (wet anorthite) and mantle (dry olivine).
271272
subsection Material model
272273
set Model name = visco plastic
273274

@@ -295,7 +296,8 @@ subsection Material model
295296
set Thermal conductivities = 2.5
296297
set Heat capacities = 750.
297298

298-
299+
# The densities below are set to achieve the following densities at the reference temperature (273 K):
300+
# upper_crust - 2700, lower_crust - 2900, background/mantle_lithosphere/asthenosphere - 3300.
299301
set Densities = background: 3216.374269005848, \
300302
crust_upper: 2729.044834307992, \
301303
crust_lower: 2826.510721247563, \
@@ -378,7 +380,9 @@ subsection Material model
378380
set Cohesions = 20.e6
379381

380382
# The parameters below weaken the friction and cohesion by a
381-
# a factor of 4 between plastic strain values of 0.5 and 1.5.
383+
# a factor of 4 between plastic strain values of 0.5 and 1.5,
384+
# and the pre-yield viscosity by a factor of 10 over the same
385+
# strain interval.
382386
set Strain weakening mechanism = plastic weakening with plastic strain and viscous weakening with viscous strain
383387
set Start plasticity strain weakening intervals = 0.5
384388
set End plasticity strain weakening intervals = 1.5

cookbooks/continental_compression_with_imposed_faults/continental_compression_with_imposed_faults.wb

Lines changed: 19 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,10 @@
66
{
77
"model":"fault","name":"fault1","dip point":[0e5,2e5],
88
"min depth":0, "max depth":1e5,
9-
"coordinates":[[2.0e5,8e5],[2.0e5,0]],
9+
"coordinates":[[2.5e5,8e5],[2.5e5,0]],
1010
"segments":
1111
[
12-
{"length":2e5,"thickness":[5000],"angle":[60]}
12+
{"length":2e5,"thickness":[5000],"angle":[80]}
1313
],
1414
"temperature models":[{"model":"uniform","temperature":273}],
1515
"composition models":
@@ -23,7 +23,7 @@
2323
"coordinates":[[2.25e5,8e5],[2.25e5,0]],
2424
"segments":
2525
[
26-
{"length":2e5,"thickness":[5000],"angle":[60]}
26+
{"length":2e5,"thickness":[5000],"angle":[70]}
2727
],
2828
"temperature models":[{"model":"uniform","temperature":273}],
2929
"composition models":
@@ -34,10 +34,24 @@
3434
}, {
3535
"model":"fault","name":"fault3","dip point":[0e5,2e5],
3636
"min depth":0, "max depth":1e5,
37-
"coordinates":[[2.5e5,8e5],[2.5e5,0]],
37+
"coordinates":[[1.4e5,8e5],[1.4e5,0]],
38+
"segments":
39+
[
40+
{"length":2e5,"thickness":[5000],"angle":[110]}
41+
],
42+
"temperature models":[{"model":"uniform","temperature":273}],
43+
"composition models":
44+
[
45+
{"model":"smooth", "compositions":[0,2], "operation":"add", "side distance fault center":2500, "center fractions":[1.5,1.5],"side fractions":[0.5,0.5]}
46+
]
47+
48+
}, {
49+
"model":"fault","name":"fault4","dip point":[0e5,2e5],
50+
"min depth":0, "max depth":1e5,
51+
"coordinates":[[1.85e5,8e5],[1.85e5,0]],
3852
"segments":
3953
[
40-
{"length":2e5,"thickness":[5000],"angle":[60]}
54+
{"length":2e5,"thickness":[5000],"angle":[90]}
4155
],
4256
"temperature models":[{"model":"uniform","temperature":273}],
4357
"composition models":
Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
(sec:cookbooks:Continental-Compression-with-imposed-faults)=
2+
# Continental Compression with Pre-Existing Fault inheritance
3+
4+
*This section was contributed by Prajakta Mohite and John Naliboff.*
5+
6+
Recent numerical modeling investigations have demonstrated the influence of extensional phases of deformation on the subsequent evolution of continental collision zones (eg., {cite}`Vasey:etal:2024`,{cite}`Zwaan:etal:2025`). Motivated by these studies and a wide range of observations that highlight fault reactivation processes during the Wilson cycle, this cookbook implements a 2D visco-plastic model of continental compression that incorporates pre-existing fault zones into the initial conditions.
7+
8+
The cookbook builds directly on components of the {ref}`sec:cookbooks:crustal-deformation` cookbook, and the primary goal here is to:
9+
1. Highlight techniques for imposing fault zones in the initial conditions of a lithospheric deformation simulation and
10+
2. Demonstrate their effect on the evolution of deformation patterns.
11+
12+
# Model Design
13+
The model domain spans 400 km x 400 km and uses adaptive refinement to resolve deformation patterns in the regions where faults are imposed at the onset of deformation. The initial thermal structure follows a conductive, continental-style geothermal through the lithosphere and an initial adiabatic profile in the asthenosphere. The governing equations follow the extended Boussinesq approximation, which includes both adiabatic and shear heating.
14+
15+
Deformation is driven by horizontal velocity applied at the model sides (2 mm/yr), which are balanced by outflow at the model base. A free surface allows topography to develop through time, which is diffused at each time step to approximate landscape evolution processes and stabilize both linear and nonlinear solver behavior.
16+
17+
The initial lithological structure includes distinct layers representing the upper crust (20 km), lower crust (20 km), mantle lithosphere (40 km), and asthenosphere (320 km). Each layer is represented by a nonlinear viscoplastic rheology combining dislocation creep and pressure-dependent plasticity. Respectively, the pre-yield viscosity and brittle material parameters (cohesion, friction) weaken by a factor of 10 and 4 as a function of accumulated viscous and brittle strain over strain intervals of 0.5-1.5.
18+
19+
```{literalinclude} strain_weakening_mechanism.part.prm
20+
```
21+
22+
Faults are correspondingly integrated into the model initial conditions as zones of initial strain defined in the Geodynamic World Builder. Four faults extending to the base of the lithosphere with constant dip angles are included, two of which dip at 60 degrees toward each other in a style representing pre-existing normal faults. A third vertical fault (i.e., approximating a strike-slip fault) is centrally located between the two dipping faults, while the fourth fault is located to the right of two normal faults and dips at a higher angle. The faults maintain a constant width of 5 km and extend to a depth of 100 km. In addition to defined fault locations with constant strain values, randomized zones of plastic (0-40 km depth) and viscous strain (0-100 km depth) are imposed across a 300 km wide zone in the upper to approximate pervasive off-fault damage observed in many regions that have undergone significant tectonic deformation. The plastic and viscous strain compositions value within the faults is the sum of the value defined in the world builder and the randomized values defined in these zones.
23+
24+
Following Howard et al. (2003), the configuration of these faults is motivated by the inferred tectonic history of the Dzereg basin in the Mongolia Altai, which has been undergoing relatively slow compression since the onset of the India-Asia collision following a period of extensional deformation.
25+
26+
```{figure-md} fig:initial_plastic_and_viscous_strain_and_density
27+
<img src="initial_plastic_and_viscous_strain_and_density.svg" style="width:50.0%" />
28+
29+
Initial plastic (top left), viscous (top right) strain and density (bottom) highlighting the location of defined fault zones and randomized strain across a broader region in the upper 100 km.
30+
The density plot contains temperature contours at intervals of 200 K, beginning at 373 K and ending at 1573 K (LAB temperature).
31+
```
32+
33+
The position, dip angle and direction, thickness (5 km), and composition (plastic and viscous strain) of each fault are defined with the [Geodynamic World Builder fault feature](https://geodynamicworldbuilder.github.io), which is illustrated below for a single fault.
34+
35+
```{literalinclude} single_fault_imposed.part.wb
36+
```
37+
38+
# Model Evolution and Potential Expansion.
39+
40+
```{figure-md} fig:strain_rate_and_density_0_myr
41+
<img src="strain_rate_and_density_0_myr.svg" style="width:50.0%" />
42+
43+
Strain rate (left) and density distribution (right) at 0 Myr in the upper 100 km from x = 100 to 300 km. Strain localizes in the upper crust along pre-defined fault zones, while density increases with depth, reflecting the compositional and thermal stratification of the lithosphere.
44+
```
45+
46+
```{figure-md} fig:strain_rate_and_density_35_myr
47+
<img src="strain_rate_and_density_35_myr.svg" style="width:50.0%" />
48+
49+
Strain rate (left) and density (right) distributions with temperature contours after 35 Myr of deformation.
50+
```
51+
52+
Deformation preferentially localizes along the two pre-existing shear zones forming a grabben-like geometry ({numref}`fig:strain_rate_and_density_0_myr`), which reflects their optimal orientation and position within the model domain to accommodate the imposed convergence. After 35 Myr of convergence ({numref}`fig:strain_rate_and_density_35_myr`) deformation remains strongly localized along these faults, with crustal shortening and thickening occurring between them forming approximately symmetric orogenic wedge. Some degree of asymmetry develops on the right side of the wedge, where the fault farthest to the right remains active in the upper crust and connects to the fault bounding the wedge near the brittle-ductile transition zone.
53+
54+
Given the nonlinearity of the rheology and governing equations, minor variations in fault strength, geometry, lithospheric structure, and boundary velocities may lead to significant variations in the spatiotemporal evolution of deformation. This cookbook provides a flexible framework for exploring the effects of these parameters, and application to hypothesis-driven questions such as fault reactivation, inversion of rift basins, or the partitioning of strain in complex orogens.
55+
56+
These results demonstrate the potential key role of pre-existing faults in guiding the evolution of lithospheric deformation. However, given the nonlinearity of the rheology and governing equations, minor variations in fault strength, geometry, lithospheric structure, and boundary velocities may lead to significant variations in the spatiotemporal evolution of deformation. Similarly, changing the numerical resolution is likely to also affect the results, as the brittle shear band width by introduced by the plastic damper (1e21 Pa s) is still likely not fully resolved at the maximum resolution of 1e21 Pa s. Furthermore, varying degrees of minor variations in the model results will likely occur if a stricter nonlinear solver tolerance is selected. This cookbook provides a flexible framework for exploring the effects of these parameters, and application to hypothesis-driven questions such as fault reactivation, inversion of rift basins, or the partitioning of strain in complex orogens.

cookbooks/continental_compression_with_imposed_faults/doc/initial_plastic_and_viscous_strain_and_density.svg

Lines changed: 1 addition & 0 deletions
Loading
Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
{
2+
"version":"1.0",
3+
"cross section":[[0,4e5],[4.2e5,4e5]],
4+
"features":
5+
[
6+
{
7+
"model":"fault","name":"fault1","dip point":[0e5,2e5],
8+
"min depth":0, "max depth":1e5,
9+
"coordinates":[[2.0e5,8e5],[2.0e5,0]],
10+
"segments":
11+
[
12+
{"length":2e5,"thickness":[5000],"angle":[60]}
13+
],
14+
"temperature models":[{"model":"uniform","temperature":273}],
15+
"composition models":
16+
[
17+
{"model":"smooth", "compositions":[0,2], "operation":"add", "side distance fault center":2500, "center fractions":[1.5,1.5],"side fractions":[0.5,0.5]}
18+
]
19+
20+
}
21+
]
22+
23+
}

cookbooks/continental_compression_with_imposed_faults/doc/strain_rate_and_density_0_myr.svg

Lines changed: 1 addition & 0 deletions
Loading

cookbooks/continental_compression_with_imposed_faults/doc/strain_rate_and_density_35_myr.svg

Lines changed: 1 addition & 0 deletions
Loading
Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
set Strain weakening mechanism = plastic weakening with plastic strain and viscous weakening with viscous strain
2+
set Start plasticity strain weakening intervals = 0.5
3+
set End plasticity strain weakening intervals = 1.5
4+
set Cohesion strain weakening factors = 0.25
5+
set Friction strain weakening factors = 0.25
6+
set Start prefactor strain weakening intervals = 0.5
7+
set End prefactor strain weakening intervals = 1.5
8+
set Prefactor strain weakening factors = 0.1
Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
New: A cookbook for continental compression that shows how to integrate faults into the initial conditions using the Geodynamic World Builder.
2+
3+
<br>
4+
(Prajakta Mohite, John Naliboff, 2025/06/19)

doc/sphinx/references.bib

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12619,4 +12619,38 @@ @article{gleason:tullis:1995
1261912619
pages={1--23},
1262012620
year={1995},
1262112621
publisher={Elsevier B.V.}
12622+
}@Article{Vasey:etal:2024,
12623+
AUTHOR = {Vasey, Dylan A. and Naliboff, John B. and Cowgill, Eric and Brune, Sascha and Glerum, Anne and Zwaan, Frank},
12624+
TITLE = {Impact of rift history on the structural style of intracontinental rift-inversion orogens},
12625+
JOURNAL = {Geology},
12626+
VOLUME = {52},
12627+
YEAR = {2024},
12628+
NUMBER = {6},
12629+
PAGES = {429--434},
12630+
URL = {https://doi.org/10.1130/G51489.1},
12631+
DOI = {10.1130/G51489.1}
12632+
}
12633+
12634+
@Article{Zwaan:etal:2025,
12635+
AUTHOR = {Frank Zwaan and Sascha Brune and Anne C. Glerum and Dylan A. Vasey and John B. Naliboff and Gianreto Manatschal and Eric C. Gaucher},
12636+
TITLE = {Rift-inversion orogens are potential hot spots for natural H<sub>2</sub> generation },
12637+
JOURNAL = {Science Advances},
12638+
VOLUME = {11},
12639+
YEAR = {2025},
12640+
NUMBER = {8},
12641+
PAGES = {eadr3418},
12642+
URL = {https://www.science.org/doi/abs/10.1126/sciadv.adr3418},
12643+
DOI = {10.1126/sciadv.adr3418}
12644+
}
12645+
12646+
@Article{Howard:etal:2003,
12647+
AUTHOR = {Howard, J. and Cunningham, W. and Davies, S. and Dijkstra, Arjan and Badarch, G.},
12648+
TITLE = {The stratigraphic and structural evolution of the Dzereg Basin, western Mongolia: Clastic sedimentation, transpressional faulting and basin destruction in an intraplate, intracontinental setting},
12649+
JOURNAL = {Basin Research},
12650+
VOLUME = {15},
12651+
YEAR = {2003},
12652+
NUMBER = {},
12653+
PAGES = {45 - 72},
12654+
URL = {},
12655+
DOI = {10.1046/j.1365-2117.2003.00198.x}
1262212656
}

0 commit comments

Comments
 (0)