Skip to content

Commit 6005eb0

Browse files
EbEb
authored andcommitted
[ci skip] add colorbar label to plots and tweak changelog
1 parent eb7e42a commit 6005eb0

File tree

4 files changed

+6
-7
lines changed

4 files changed

+6
-7
lines changed

docs/source/changelog.rst

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ options for :ref:`kap/defaults:kap_lowT_prefix`:
6767
**Opacity interpolation**
6868

6969
MESA interpolates across opacity tables in the :math:`X–Z` plane through the use of two consequtive 1D splines.
70-
Previous versions of MESA have offered the users the ability to choose linear or cubic interpolation for these splines,
70+
Previous versions of MESA have offered users the ability to choose linear or cubic interpolation for these splines,
7171
while leaving the default as linear interpolation::
7272

7373
cubic_interpolation_in_X = .false.
@@ -81,21 +81,20 @@ derivatives and blue indicates high quality derivatives.
8181
.. figure:: changelog_plots/cubic_dfridr_dkapdT.png
8282
:alt: old cubic relative kap derivative error
8383

84-
This figure shows the relative error in the derivative :math:`\partial \kappa / \partial T` (:math:`X` = 0.625, :math:`Z` = 0.015),
84+
This figure shows the logarithmic relative error in the derivative :math:`\partial \kappa / \partial T` (:math:`X` = 0.625, :math:`Z` = 0.015),
8585
for an OPAL opacity table grid using Grevesse & Sauval (1998) abundances, generated from MESA’s kap module, using cubic interpolation.
8686
The OPLIB log(:math:`R`) = −8, 1.5 table boundaries are marked with a solid black line and the OPAL/OP log(:math:`R`) = 1.0 boundary is shown with a dashed line.
8787
The approximate location of the Z-dependent transition to an electron conduction dominated opacity is marked with dot-dash blue curve. Regions for Atomic, molecular,
8888
and compton scattering opacity are labeled and presented with their associated blending regions.
8989

9090

91-
While the opacity derivatives do not directly appear in the canonical equations of stellar structure, they do appear in the Jacobian matrix for the MESA implicit solver.
92-
The opacity derivatives are used to implicitly solve the stellar structure equations and reach a converged solution. Numerically unstable opacity derivatives can
93-
halt the progress of the solver and ultimately crash a calculation.
91+
While the opacity derivatives do not directly appear in the canonical equations of stellar structure, they do appear in the Jacobian matrix for MESA's implicit solver.
92+
Numerically unstable opacity derivatives can halt the progress of the solver and ultimately crash a calculation.
9493

9594
To improve the numerical stability of MESA's cubic opacity interpolation routines, we have implemented
9695
automatic differentiation into the opacity interpolating functions. Now, when using cubic interpolation, the opacity derivatives for an arbitrary mixture
9796
in the :math:`X–Z` plane are computed by taking the derivative of the interpolating function as opposed to the interpolant of the derivatives. This improvement
98-
has resulted in a significant reduction in the relative derivative error and results in an increase in the numerical accuracy of opacity derivatives computed with cubic interpolation.
97+
has lead to a significant reduction in the relative derivative error and an increase in the numerical accuracy of opacity derivatives computed with cubic interpolation.
9998

10099
.. figure:: changelog_plots/cubic_dfridr_dkapdT_ad.png
101100
:alt: new cubic relative kap derivative error
@@ -114,7 +113,7 @@ option (shown below), while also providing more accurate opacity physics between
114113

115114
For this MESA release, linear interpolation remains the default method for interpolating in composition between opacity tables
116115
while we continue to investigate the residual areas where cubic interpolation appears to occasionally produce lower quality derivatives.
117-
However, we recommend users experiment with cubic interpolation, as it has been shown to consistently increase the overall
116+
However, adopting cubic interpolation has been shown to consistently increase the overall
118117
opacity of a model, and can directly effect the structure of solar models, see Appendix B & C in Farag et al. 2024.
119118
We anticipate making cubic interpolation the default in a future MESA release version.
120119
We encourage users to experiment with these different opacity interpolation routines and be mindful of the effect they can have on their stellar models.
18.1 KB
Loading
18.4 KB
Loading
17.8 KB
Loading

0 commit comments

Comments
 (0)