add description of the plume feature

[jdannberg]

No description provided.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (4539ca8) 92.80% compared to head (031fd86) 92.78%.
Report is 67 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #642      +/-   ##
==========================================
- Coverage   92.80%   92.78%   -0.02%     
==========================================
  Files          92      105      +13     
  Lines        6474     7177     +703     
==========================================
+ Hits         6008     6659     +651     
- Misses        466      518      +52     

see 24 files with indirect coverage changes

---

Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 4539ca8...031fd86. Read the comment docs.

[github-actions]

Benchmark	Main	Feature	Difference (99.9% CI)
Slab interpolation simple none	1.015 ± 0.005 (s=468)	1.013 ± 0.006 (s=422)	-0.3% .. -0.0%
Slab interpolation curved simple none	1.017 ± 0.006 (s=464)	1.015 ± 0.006 (s=424)	-0.3% .. -0.1%
Spherical slab interpolation simple none	1.168 ± 0.006 (s=397)	1.165 ± 0.006 (s=377)	-0.4% .. -0.1%
Slab interpolation simple curved CMS	1.054 ± 0.004 (s=425)	1.060 ± 0.005 (s=429)	+0.5% .. +0.7%
Spherical slab interpolation simple CMS	1.549 ± 0.010 (s=289)	1.548 ± 0.010 (s=295)	-0.2% .. +0.1%
Spherical fault interpolation simple none	1.171 ± 0.008 (s=386)	1.171 ± 0.007 (s=385)	-0.1% .. +0.2%
Cartesian min max surface	2.293 ± 0.017 (s=201)	2.295 ± 0.017 (s=194)	-0.2% .. +0.3%
Spherical min max surface	7.212 ± 0.031 (s=53)	7.217 ± 0.032 (s=74)	-0.2% .. +0.3%

[gassmoeller]

All text and pictures look good to me. @MFraters can you check if the structure that is suggested looks ok to you?

[gassmoeller]

Not wrong, but I would prefer:

Suggested change

	The plume feature allows it to add a mantle plume to a GWB world. Specifically, the plume is described in terms of its centerline and a number of cross sections.
	The plume feature allows to add a mantle plume to a GWB world. Specifically, the plume is described in terms of its centerline and a number of cross sections.

[gassmoeller]

Easier to read:

Suggested change

At each point on the plume centerline defined in this way, the shape of the cross section of the plume needs to be described. We assume that the cross section has an elliptical shape, so it can be defined in terms of the length of the semi-major axis, the direction of the semi-major axis, and the eccentricity of the ellipse. This combination of parameter allows it to prescribe a pipe-like structure with changing cross-sections.

At each central point defined in this way, the shape of the cross section of the plume needs to be described. We assume that the cross section has an elliptical shape, so it can be defined in terms of the length of the semi-major axis, the direction of the semi-major axis, and the eccentricity of the ellipse. This combination of parameters allows it to prescribe a pipe-like structure with changing cross-sections.

[jdannberg]

I addressed your comments.

[MFraters]

Thanks for writing this up and creating this new part for the manual!