Skip to content

Commit

Permalink
Refs and docs
Browse files Browse the repository at this point in the history
  • Loading branch information
nichollsh committed Sep 8, 2024
1 parent ad8f644 commit 9201aa6
Show file tree
Hide file tree
Showing 2 changed files with 25 additions and 8 deletions.
27 changes: 22 additions & 5 deletions docs/src/assets/refs.bib
Original file line number Diff line number Diff line change
Expand Up @@ -562,6 +562,22 @@ @article{gordon_hitran_2022
pages = {107949},
}

@article{lee_dynamically_2024,
author = {Lee, Elspeth K H and Tan, Xianyu and Tsai, Shang-Min},
title = "{Dynamically coupled kinetic chemistry in brown dwarf atmospheres – II. Cloud and chemistry connections in directly imaged sub-Jupiter exoplanets}",
journal = {Monthly Notices of the Royal Astronomical Society},
volume = {529},
number = {3},
pages = {2686-2701},
year = {2024},
month = {02},
issn = {0035-8711},
doi = {10.1093/mnras/stae537},
url = {https://doi.org/10.1093/mnras/stae537},
eprint = {https://academic.oup.com/mnras/article-pdf/529/3/2686/57055458/stae537.pdf},
}


@BOOK{JANAF,
author = {{Chase}, M.~W.},
title = "{JANAF thermochemical tables}",
Expand Down Expand Up @@ -609,9 +625,10 @@ @ARTICLE{feistel_ice_2006
adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}






@techreport{manners_socrates_2017,
title={SOCRATES Technical Guide: Suite Of Community RAdiative Transfer Codes Based on Edwards and Slingo},
author={Manners, James and others},
year={2017},
institution={Met Office, Exeter, UK}
}

6 changes: 3 additions & 3 deletions docs/src/model/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,7 @@ T_s
```
where $T_s$ is the surface temperature. Cell-edge temperatures in the bulk atmosphere are interpolated using the [PCHIP algorithm](https://epubs.siam.org/doi/10.1137/0905021), which avoids Runge's phenomenon and overshooting. The bottom- and top-most cell edge temperatures are extrapolated by estimation of $dT/d \log p$. Cell properties (heat capacity, gravity, density, average molecular weight, etc.) are consistently updated at each evaluation of $\bm{r}$. Condensation/rainout are also handled at each evaluation of $\bm{r}$ in order to avoid supersaturation.

The model converges when the cost function $c(\bm{x}) = \sqrt[6]{\sum_i |r_i|^6}$ satisfies the condition
The model converges when the cost function $c(\bm{x}) = \sqrt{\sum_i |r_i|}$ satisfies the condition
```math
c(\bm{x}) < c_a + c_r \cdot \underset{i}{\max} \text{ } |F_i|
```
Expand All @@ -113,7 +113,7 @@ With a Jacobian constructed, we can calculate an update $\bm{d}$ to the solution
```
but can alternatively be performed via the Gauss-Newton and Levenberg–Marquardt methods.

It is possible for the model to become stuck on a plateau or in a local minimum, leading to very small values of $|\bm{d}|$. This is identified when $c(\bm{x})$ has seen little change over the last few iterations. When this occurs, the model is 'nudged' by scaling the update via
It is possible for the model to become stuck in a local minimum, leading to very small values of $|\bm{d}|$. This is identified when $c(\bm{x})$ has seen little change over the last few iterations. When this occurs, the model is 'nudged' by scaling the update via
```math
\bm{d} \rightarrow 3 \bm{d}
```
Expand All @@ -132,4 +132,4 @@ on $\alpha$. This is applied if the full step $\bm{d}$ would increase the cost b
AGNI can calculate emission spectra, provided with T(p) and the volume mixing ratios of the gases. This is performed using the same RT as the RCE calculations, so is limited in resolution by the choice of correlated-k bands. Similarly, the longwave contribution function can also be calculated.

## Julia and Fortran
AGNI is primarily written in Julia, while SOCRATES itself is written in Fortran. Julia was chosen because it allows the SOCRATES binaries to be included in the precompiled code, which significantly improves performance.
AGNI is primarily written in Julia, while SOCRATES itself is written in Fortran. Julia was chosen because it allows the SOCRATES binaries to be included in the precompiled code, which significantly improves performance.

0 comments on commit 9201aa6

Please sign in to comment.