Add orogenic setup cookbook with documentation

[Kaili270]

This PR adds a new cookbook demonstrating an orogenic setup using WorldBuilder.

The example includes:

• A layered crust–mantle structure
• Pre-defined lithospheric and asthenospheric domains
• A figure illustrating the model setup
• Documentation for reproducibility

This setup can serve as a starting point for studies on lithospheric inheritance.

I would appreciate any feedback or suggestions.

Kai

[coveralls]

Pull Request Test Coverage Report for Build 23756492231

Details

• 0 of 0 changed or added relevant lines in 0 files are covered.
• No unchanged relevant lines lost coverage.
• Overall coverage remained the same at 98.34%

---

Totals
Change from base Build 23754203769:	0.0%
Covered Lines:	9894
Relevant Lines:	10061

---

💛 - Coveralls

[alarshi]

@Kaili270 : Thank you for contributing this, is this ready for review?

[Kaili270]

This is ready for review. Thank you so much.

[Kaili270]

@Kaili270 : Thank you for contributing this, is this ready for review?

Hi Alarshi,
It's ready for review. Thanks a lot.

Cheers,
Kai

[github-actions]

Benchmark	Main	Feature	Difference (99.9% CI)
Slab interpolation simple none	1.159 ± 0.007 (s=375)	1.159 ± 0.009 (s=404)	-0.2% .. +0.1%
Slab interpolation curved simple none	1.278 ± 0.012 (s=376)	1.279 ± 0.012 (s=330)	-0.1% .. +0.4%
Spherical slab interpolation simple none	1.262 ± 0.007 (s=382)	1.262 ± 0.006 (s=334)	-0.1% .. +0.1%
Slab interpolation simple curved CMS	1.325 ± 0.009 (s=347)	1.324 ± 0.008 (s=335)	-0.2% .. +0.1%
Spherical slab interpolation simple CMS	1.610 ± 0.011 (s=280)	1.610 ± 0.010 (s=282)	-0.2% .. +0.2%
Spherical fault interpolation simple none	1.268 ± 0.010 (s=333)	1.274 ± 0.014 (s=378)	+0.3% .. +0.7%
Cartesian min max surface	3.068 ± 0.014 (s=148)	3.065 ± 0.021 (s=148)	-0.3% .. +0.1%
Spherical min max surface	8.578 ± 0.099 (s=57)	8.575 ± 0.112 (s=50)	-0.9% .. +0.8%

[alarshi]

@Kaili270 : Thank you for adding this cookbook, this is cool! I just one comment and a few minor comments after which I can take another look.

Could you explain to me why you wanted to separate the compositional fields of the upper crust, lower crust, lithosphere, and asthenosphere between domain 1 and 2 for the stable continental region? Are you planning to use different properties? Since, world builder automatically replaces the previously computed values for a given region, you could also simply your input files by first specifying the horizontally uniform layers and then adding the orogen? Here is the file for reference (github does not allow .wb attachment). This approach would reduce the number of your compositional fields from 12 to 7, and even more if you decide to use the same compositional value for the layers within the orogens. Feel free to structure your .wb file different, I am just interested in your reasoning.

orogeny-test.wb.txt

[alarshi]

This includes the complete .wb file. Is there a specific section you want to add? Maybe you can just add one of the layers and describe in the text as "The relevant part of the World Builder file describing the upper crust is shown below:" and then you would add the specific lines as:

Suggested change

	:::{literalinclude} ../3d_cartesian_orogenic_setup.wb
	:language: json
	:lineno-start: 1
	:::
	:::{literalinclude} ../3d_cartesian_orogenic_setup.wb
	:language: json
	:lineno-start: 1
	:lines: 10-32
	:::

You could also make the file compact by including the coordinates in a single line.

[alarshi]

Could you add the model figure here. i.e., Figure_1_setup.png? I have some recommendation for modifying your figure as well. Could you rotate the view so that it looks similarly to the temperature figure? Please remove the axes grid labels as well as it is a bit hard to read, but you can annotate the axes separately using an external software (e.g., paint, photoshop etc. ). It would also be nice to see the different layers if you annotate the layers, i.e., upper crust, lower, crust, mantle lithosphere, asthenosphere, instead of reading it in the figure label.

[alarshi]

Could you add some motivation here? Something like "Earth’s lithospheric thickness varies spatially depending on the tectonic setting. In this cookbook, we describe the implementation of a thickened lithospheric root beneath an orogen due to isostasy."