-
Notifications
You must be signed in to change notification settings - Fork 251
Cookbook for Continental Compression with Fault Inheritance #6476
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Cookbook for Continental Compression with Fault Inheritance #6476
Conversation
5d884aa
to
4466490
Compare
672ef4e
to
b7ef3c3
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@PrajaktaPMohite - Nice work, this is a great start! I've left a few initial comments to address.
.../continental_compression_with_imposed_faults/continental_compression_with_imposed_faults.prm
Outdated
Show resolved
Hide resolved
.../continental_compression_with_imposed_faults/continental_compression_with_imposed_faults.prm
Outdated
Show resolved
Hide resolved
.../continental_compression_with_imposed_faults/continental_compression_with_imposed_faults.prm
Outdated
Show resolved
Hide resolved
...ntinental_compression_with_imposed_faults/doc/continental_compression_with_imposed_faults.md
Outdated
Show resolved
Hide resolved
...ntinental_compression_with_imposed_faults/doc/continental_compression_with_imposed_faults.md
Outdated
Show resolved
Hide resolved
...ntinental_compression_with_imposed_faults/doc/continental_compression_with_imposed_faults.md
Outdated
Show resolved
Hide resolved
...ntinental_compression_with_imposed_faults/doc/continental_compression_with_imposed_faults.md
Outdated
Show resolved
Hide resolved
...ntinental_compression_with_imposed_faults/doc/continental_compression_with_imposed_faults.md
Show resolved
Hide resolved
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would add another panel to this figure that shows the density distribution.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I propose zooming into the region of interest (upper 100 km, x=100 km to x=400 km) in both this figure and the next figure.
58481d9
to
1a1d8ce
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@PrajaktaPMohite - Thank you for the updates! I've provided another round of revisions, and after these suggestions are addressed I would remove the [WIP] label so others can jump in and review. Additional next steps could also include (1) adding a corresponding test case and (2) change log file.
.../continental_compression_with_imposed_faults/continental_compression_with_imposed_faults.prm
Show resolved
Hide resolved
...s/continental_compression_with_imposed_faults/continental_compression_with_imposed_faults.wb
Show resolved
Hide resolved
...ntinental_compression_with_imposed_faults/doc/continental_compression_with_imposed_faults.md
Outdated
Show resolved
Hide resolved
...ntinental_compression_with_imposed_faults/doc/continental_compression_with_imposed_faults.md
Outdated
Show resolved
Hide resolved
.../continental_compression_with_imposed_faults/continental_compression_with_imposed_faults.prm
Show resolved
Hide resolved
```{literalinclude} strain_weakening_mechanism.part.prm | ||
``` | ||
|
||
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. Plastic strain within the faults is limited to the upper 40 km where brittle deformation occurs, while viscous strain within the faults extends to the base of the lithosphere. In addition to defined fault locations with constant strain values, randomized zones of plastic and brittle strain 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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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. Plastic strain within the faults is limited to the upper 40 km where brittle deformation occurs, while viscous strain within the faults extends to the base of the lithosphere. In addition to defined fault locations with constant strain values, randomized zones of plastic and brittle strain 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. | |
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 fault width is constant at 5 km. Plastic strain within the faults is limited to the upper 40 km where brittle deformation occurs, while viscous strain within the faults extends to the base of the lithosphere. In addition to defined fault locations with constant strain values, randomized zones of plastic and brittle strain 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. |
cookbooks/continental_compression_with_imposed_faults/doc/strain_rate_and_density_0_myr.svg
Show resolved
Hide resolved
```{figure-md} fig:strain_rate_and_density_0_myr | ||
<img src="strain_rate_and_density_0_myr.svg" style="width:50.0%" /> | ||
|
||
Strain rate (left) and density distribution (right) at 0 Myr in a 2D continental compression model. 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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Strain rate (left) and density distribution (right) at 0 Myr in a 2D continental compression model. 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. | |
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. |
@PrajaktaPMohite - You will need to update the figure caption to incorporate the correct values for the height and width of the images.
Strain rate (left) and density (rigth) distributions with temperature contours after 35 Myr of deformation. | ||
``` | ||
|
||
Deformation preferentially localizes along the two pre-existing shear zones forming a grabben-like geometry (Figure 2), which reflects their optimal orientation and position within the model domain to accommodate the imposed convergence. While additional smaller-structures develop after 35 Myr of convergence (Figure 3), deformation remains strongly localized along these faults with crustal shortening and thickening occurring between them. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Deformation preferentially localizes along the two pre-existing shear zones forming a grabben-like geometry (Figure 2), which reflects their optimal orientation and position within the model domain to accommodate the imposed convergence. While additional smaller-structures develop after 35 Myr of convergence (Figure 3), deformation remains strongly localized along these faults with crustal shortening and thickening occurring between them. | |
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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@PrajaktaPMohite - Can you address this comment when you have a chance?
```{literalinclude} strain_weakening_mechanism.part.prm | ||
``` | ||
|
||
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. Plastic strain within the faults is limited to the upper 40 km where brittle deformation occurs, while viscous strain within the faults extends to the base of the lithosphere. In addition to defined fault locations with constant strain values, randomized zones of plastic and brittle strain 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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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. Plastic strain within the faults is limited to the upper 40 km where brittle deformation occurs, while viscous strain within the faults extends to the base of the lithosphere. In addition to defined fault locations with constant strain values, randomized zones of plastic and brittle strain 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. | |
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. |
I have addressed all of your comment. The PR is ready for another round of review. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@PrajaktaPMohite - Thanks for the updates to the figures and text. I've made a few additional minor comments and noted where old comments still need to be addressed.
.../continental_compression_with_imposed_faults/continental_compression_with_imposed_faults.prm
Show resolved
Hide resolved
.../continental_compression_with_imposed_faults/continental_compression_with_imposed_faults.prm
Show resolved
Hide resolved
...s/continental_compression_with_imposed_faults/continental_compression_with_imposed_faults.wb
Outdated
Show resolved
Hide resolved
...ntinental_compression_with_imposed_faults/doc/continental_compression_with_imposed_faults.wb
Outdated
Show resolved
Hide resolved
...ntinental_compression_with_imposed_faults/doc/continental_compression_with_imposed_faults.md
Show resolved
Hide resolved
I think I have addressed all the comments now. |
...s/continental_compression_with_imposed_faults/continental_compression_with_imposed_faults.wb
Show resolved
Hide resolved
Strain rate (left) and density (rigth) distributions with temperature contours after 35 Myr of deformation. | ||
``` | ||
|
||
Deformation preferentially localizes along the two pre-existing shear zones forming a grabben-like geometry (Figure 2), which reflects their optimal orientation and position within the model domain to accommodate the imposed convergence. While additional smaller-structures develop after 35 Myr of convergence (Figure 3), deformation remains strongly localized along these faults with crustal shortening and thickening occurring between them. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@PrajaktaPMohite - Can you address this comment when you have a chance?
ff071ba
to
6dfecb0
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@PrajaktaPMohite - Thanks for keeping at this :-) A few more comments on my end, but after that I think someone else should take a look (@danieldouglas92?).
In addition to addressing the last comments, you will need to:
- Update the test results
- Squash the commits.
.../continental_compression_with_imposed_faults/continental_compression_with_imposed_faults.prm
Outdated
Show resolved
Hide resolved
.../continental_compression_with_imposed_faults/continental_compression_with_imposed_faults.prm
Outdated
Show resolved
Hide resolved
.../continental_compression_with_imposed_faults/continental_compression_with_imposed_faults.prm
Outdated
Show resolved
Hide resolved
|
||
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. | ||
|
||
The cookbook builds directly on components of the continental extension cookbook, and the primary goal here is to: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The cookbook builds directly on components of the continental extension cookbook, and the primary goal here is to: | |
The cookbook builds directly on components of the {ref}`sec:cookbooks:continental-extension` cookbook, and the primary goal here is to: |
{ref}sec:cookbooks:crustal-deformation
@@ -0,0 +1,4 @@ | |||
New: A cookbook for continental compression that shows how to include pre-existing faults to help localize strain during continental convergence. It uses strain weakening and visco-plastic behavior to simulate how faults can influence the deformation. The model is based on earlier extension models and focuses on adding fault zones from the start of the simulation to study how they affect the patterns of strain during compression. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
New: A cookbook for continental compression that shows how to include pre-existing faults to help localize strain during continental convergence. It uses strain weakening and visco-plastic behavior to simulate how faults can influence the deformation. The model is based on earlier extension models and focuses on adding fault zones from the start of the simulation to study how they affect the patterns of strain during compression. | |
New: A cookbook for continental compression that shows how to integrate faults into the initial conditions using the Geodynamic World Builder. |
I tried updating test results but test is failing. |
584917a
to
cfc3117
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The figures are super cool!! I think that this is great and my comments are very minor. Thanks for working on this!
# A test to check whether the continental compression with imposed faults cookbook | ||
# at low resolutions for a single time step with one nonlinear iteration. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This text would be ok in the test .prm file that you've made, but since this .prm file is the actual cookbook .prm file, I would make sure to put a more detail about what this parameter file does. How big are the faults, how much weaker are they, where are they located, dip, etc. would be good to put here. These are just some ideas but anything else that you think is important for a broad overview of the model would be great
subsection Adiabatic conditions model | ||
subsection Compute profile | ||
set Composition reference profile = function | ||
set Function expression = \ | ||
0; \ | ||
0; \ | ||
0; \ | ||
if( x<=20.e3, 1, 0); \ | ||
if( x>20.e3 && x<=40.e3, 1, 0); \ | ||
if( x>40.e3 && x<=80.e3, 1, 0); \ | ||
if( x>80.e3, 1, 0); \ | ||
|
||
end | ||
end |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would add a couple lines of documentation explaining what this subsection is doing (i.e. what the function is actually constraining). You already do this really well in a lot of the sections of the input file below.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@PrajaktaPMohite - Some minor suggestion for rephrasing on this section below:
# Specify the reference depth-dependent compositional profile used when
# computing the adiabatic conditions. A function is required for each compositional
# field, and the order of the functions should correspond to the same order of in
# which the fields were listed under "set Names of fields". As such, the first
# three fields correspond to various types of "strain", and should be set to
# 0, while the remaining fields correspond to fields representing chemical
# compositions. Note that in the function expression "x" refers to depth.
subsection Discretization | ||
set Composition polynomial degree = 2 | ||
set Stokes velocity polynomial degree = 2 | ||
set Temperature polynomial degree = 2 | ||
set Use discontinuous composition discretization = true | ||
end |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would add a comment describing why you are setting these, notably what advantage using discontinuous composition discretization gives.
end | ||
|
||
# Velocity on boundaries characterized by functions | ||
# The combined horizontal velocity (x-direction) magnitude on the left and right walls is 0.2 cm/year |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
A horizontal velocity (x-direction) of 0.1 cm/year is applied to the left and right walls resulting in inflow, which is balanced by the 0.2 cm/yr vertical (y-direction) outflow on the bottom boundary.
|
||
# Velocity on boundaries characterized by functions | ||
# The combined horizontal velocity (x-direction) magnitude on the left and right walls is 0.2 cm/year | ||
# The vertical velocity at the base is 0.2 cm/year (balances outflow on sides) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
# The vertical velocity at the base is 0.2 cm/year (balances outflow on sides) |
```{figure-md} fig:initial_plastic_and_viscous_strain_and_density | ||
<img src="initial_plastic_and_viscous_strain_and_density.svg" style="width:50.0%" /> | ||
|
||
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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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. | |
Initial plastic (top left), viscous strain (top right) and density (bottom) highlighting the location of defined fault zones and randomized strain across a broader region in the upper 100 km. |
Strain rate (left) and density (right) distributions with temperature contours after 35 Myr of deformation. | ||
``` | ||
|
||
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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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. | |
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 an 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. |
|
||
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. | ||
|
||
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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The first sentence in this paragraph is duplicated from the previous paragraph
|
||
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. | ||
|
||
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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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. | |
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 X km. 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. |
I deleted the duplicate text, and I think you meant to put the resolution of the mesh instead of the damper viscosity.
# Continental Compression with Imposed Faults Cookbook | ||
# This cookbook builds on the continental extension cookbook | ||
# and a recent paper investigating rift inversion (Vasey et al., 2024, | ||
# https://doi.org/10.1130/G51489.1) to demonstrate how to design | ||
# models of continental compression that extend into the asthenosphere | ||
# and include faults as zones of weakness in the initial conditions. | ||
# The setup is motivated by observed deformation patterns in the Mongolian | ||
# Altai, which has experienced low magnitudes of compressional deformation | ||
# since the onset of the India-Asia collision and contains evidence for | ||
# reactivation of normal faults formed during prior phases of deformation | ||
# The faults locations and properties are defined using the Geodynamic | ||
# World Builder. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Refer to my top comment, this is what I wanted to see at the top of the cookbooks/.prm file.
The documentation in this cookbooks/.prm and the tests/.prm file should just be switched. I would still add a little more detail based on my comment on the test .prm file though
2d07bf2
to
f71bf86
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@PrajaktaPMohite - Nice work, this is now very close from my side, just a few more minor comments.
@gassmoeller - I think it would be good if you or another maintainer did a review before we merged.
subsection Adiabatic conditions model | ||
subsection Compute profile | ||
set Composition reference profile = function | ||
set Function expression = \ | ||
0; \ | ||
0; \ | ||
0; \ | ||
if( x<=20.e3, 1, 0); \ | ||
if( x>20.e3 && x<=40.e3, 1, 0); \ | ||
if( x>40.e3 && x<=80.e3, 1, 0); \ | ||
if( x>80.e3, 1, 0); \ | ||
|
||
end | ||
end |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@PrajaktaPMohite - Some minor suggestion for rephrasing on this section below:
# Specify the reference depth-dependent compositional profile used when
# computing the adiabatic conditions. A function is required for each compositional
# field, and the order of the functions should correspond to the same order of in
# which the fields were listed under "set Names of fields". As such, the first
# three fields correspond to various types of "strain", and should be set to
# 0, while the remaining fields correspond to fields representing chemical
# compositions. Note that in the function expression "x" refers to depth.
set Composition polynomial degree = 2 | ||
set Stokes velocity polynomial degree = 2 | ||
set Temperature polynomial degree = 2 | ||
# The gradient at quadrature points will not be a precise approximation of the true gradient |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would remove these lines of documentation.
# since it excludes the contribution of jumps in the compositional field between cells. | ||
# Even though the finite element solution varies from cell to cell, the gradient of the | ||
# solution at quadrature locations inside each cell will always be precisely zero. | ||
set Use discontinuous composition discretization = true |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Do you recall why this was set to true? It may be a relict from a PRM file that was setup for use with viscoelasticity, where discontinuous compositional fields are required. It is not necessarily a problem, but we should provide some documentation for what the effects are.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yes, setting Use discontinuous composition discretization = true
is often necessary when employing viscoelastic rheology. This is because viscoelastic formulations rely on the stress tensor evolving as a function of spatially localized material properties and deformation over time.
|
||
# Initial values of different compositional fields | ||
# The upper crust (20 km thick), lower crust (20 km thick) | ||
# and mantle lithosphere(40 km thick) and asthenosphere (320 km thick )are continuous |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
# and mantle lithosphere(40 km thick) and asthenosphere (320 km thick )are continuous | |
# and mantle lithosphere (40 km thick) and asthenosphere (320 km thick ) are continuous |
|
||
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. | ||
|
||
The cookbook builds directly on components of the {ref}`sec:cookbooks:crustal-deformation` cookbook, and the primary goal here is to: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The cookbook builds directly on components of the {ref}`sec:cookbooks:crustal-deformation` cookbook, and the primary goal here is to: | |
The cookbook builds directly on components of the {ref}`sec:cookbooks:continental-extension` cookbook, and the primary goal here is to: |
Strain rate (left) and density (right) distributions with temperature contours after 35 Myr of deformation. | ||
``` | ||
|
||
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 an 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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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 an 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. | |
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 an 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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks pretty good, thanks @PrajaktaPMohite. I have some comments on the text and one or two questions about the model setup, see my questions below.
Let me know when you want me to take another look.
Strain rate (left) and density (right) distributions with temperature contours after 35 Myr of deformation. | ||
``` | ||
|
||
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 an 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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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 an 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. | |
Deformation preferentially localizes along the two pre-existing shear zones forming a graben-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 an 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. |
# Model geometry (400x400 km, 20 km spacing) | ||
subsection Geometry model | ||
set Model name = box | ||
subsection Box |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
if a subsection starts inside another subsection it is often easier to read to insert an empty line here:
subsection Box | |
subsection Box |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Okay.
set Initial global refinement = 3 | ||
set Time steps between mesh refinement = 0 | ||
set Strategy = minimum refinement function | ||
subsection Minimum refinement function |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
subsection Minimum refinement function | |
subsection Minimum refinement function |
subsection Mesh deformation | ||
set Mesh deformation boundary indicators = top: free surface, top: diffusion | ||
set Additional tangential mesh velocity boundary indicators = left, right | ||
subsection Free surface |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
subsection Free surface | |
subsection Free surface |
subsection Free surface | ||
set Surface velocity projection = normal | ||
end | ||
subsection Diffusion |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
subsection Diffusion | |
subsection Diffusion |
2. Demonstrate their effect on the evolution of deformation patterns. | ||
|
||
# Model Design | ||
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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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. | |
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 geotherm 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. |
# Model Design | ||
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. | ||
|
||
Deformation is driven by horizontal velocity applied at the model sides (1 mm/yr), which are balanced by outflow at the model base (2 mm/yr). 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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The current parameter file sets different values. Please check which values were used for the figures.
Deformation is driven by horizontal velocity applied at the model sides (1 mm/yr), which are balanced by outflow at the model base (2 mm/yr). 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. | |
Deformation is driven by horizontal velocity applied at the model sides (0.1 mm/yr), which are balanced by outflow at the model base (0.2 mm/yr). 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. |
```{literalinclude} strain_weakening_mechanism.part.prm | ||
``` | ||
|
||
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 faults are setting in the middle of the randomized strain zones, fault1 in wb file is located at x = 250km. 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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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 faults are setting in the middle of the randomized strain zones, fault1 in wb file is located at x = 250km. 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. | |
Faults are 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 faults are prescribed in the middle of the randomized strain zones, fault1 in wb file is located at x = 250km. The plastic and viscous strain composition values within the faults is the sum of the value defined in the world builder and the randomized values defined in these zones. |
Strain rate (left) and density (right) distributions with temperature contours after 35 Myr of deformation. | ||
``` | ||
|
||
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 an 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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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 an 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. | |
Deformation preferentially localizes along the two pre-existing shear zones forming a graben-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 an 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. |
|
||
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. | ||
|
||
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 2.5 km. 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. No newline at end of file |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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 2.5 km. 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. | |
Similarly, changing the numerical resolution is likely to also affect the results, as the brittle shear band width introduced by the plastic damper (1e21 Pa s) is still likely not fully resolved at the maximum resolution of 2.5 km. Furthermore, 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 questions such as fault reactivation, inversion of rift basins, or the partitioning of strain in complex orogens. |
Also you will have to fix the indentation of your code, as described here |
0622209
to
db44490
Compare
db44490
to
8d8ea7b
Compare
@naliboff - This PR is ready for another look. |
This cookbook demonstrates the role of pre-existing faults in localizing strain during continental convergence using strain weakening and plasticity.