Skip to content

Commit

Permalink
interlink with kimmdy docs
Browse files Browse the repository at this point in the history
  • Loading branch information
jmbuhr committed Sep 5, 2024
1 parent 9ba49b5 commit 043222f
Show file tree
Hide file tree
Showing 19 changed files with 1,147 additions and 63 deletions.
3 changes: 2 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,8 @@

## Documentation

See [KIMMDY documentation](https://graeter-group.github.io/kimmdy/).
See [KIMMDY documentation](https://graeter-group.github.io/kimmdy/)
and [documentation for these reactions](https://graeter-group.github.io/kimmdy-reactions/).

## Installation

Expand Down
12 changes: 12 additions & 0 deletions _freeze/config/execute-results/html.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
{
"hash": "80e294a73e06e47b40b43cfdbb332c36",
"result": {
"engine": "jupyter",
"markdown": "---\ntitle: All Options\n---\n\n\n\nFor all KIMMDY options see [here](https://graeter-group.github.io/kimmdy/guide/references/input.html#all-options).\n\n\n\n\n## Homolysis\n\n```yaml\nreactions:\n homolysis: ...\n```\n\n### edis\n\nDissociation energies data file\n\n\n**Type**: Path\n\n\n**Default**: edissoc.dat\n\n\n### itp\n\nAdditional itp file with bonded parameters\n\n\n**Type**: Path\n\n\n**Default**: ffbonded.itp\n\n\n### kmc\n\nKMC algorithm for this reaction.\n\n\n**Type**: str\n\n\n**Options**: ['rfkmc', 'frm', 'extrande', 'extrande_mod']\n\n\n**Default**: rfkmc\n\n\n### check_bound\n\nCheck the topology for bonds between plumed atom pairs\n\n\n**Type**: bool\n\n\n**Default**: False\n\n\n### arrhenius_equation\n\nFor setting values in the arrhenius equation\n\n\n\n\n## Dummy Reaction\n\n```yaml\nreactions:\n dummyreaction: ...\n```\n\n### example\n\nThis is an example of an option for a reaction.\n\n\n**Type**: float\n\n\n**Default**: 0.0\n\n\n### example2\n\nThis is another example of an option for a reaction.\n\n\n**Type**: str\n\n\n**Default**: hello\n\n\n### kmc\n\nKMC algorithm for this reaction.\n\n\n**Type**: str\n\n\n**Options**: ['rfkmc', 'frm', 'extrande', 'extrande_mod']\n\n\n**Default**: extrande_mod\n\n\n\n\n## Naive HAT\n\n```yaml\nreactions:\n hat_naive: ...\n```\n\n### frequency_factor\n\nFrequency factor\n\n\n**Type**: float\n\n\n**Default**: 1\n\n\n### h_cutoff\n\nCutoff for H atom\n\n\n**Type**: float\n\n\n**Default**: 4\n\n\n### polling_rate\n\nPolling rate\n\n\n**Type**: float\n\n\n**Default**: 1\n\n\n### kmc\n\nKMC algorithm for this reaction.\n\n\n**Type**: str\n\n\n**Options**: ['rfkmc', 'frm', 'extrande', 'extrande_mod']\n\n\n**Default**: extrande_mod\n\n\n\n\n",
"supporting": [
"config_files"
],
"filters": [],
"includes": {}
}
}
7 changes: 7 additions & 0 deletions _freeze/site_libs/clipboard/clipboard.min.js

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

1 change: 1 addition & 0 deletions _inv/kimmdy_objects.json

Large diffs are not rendered by default.

9 changes: 8 additions & 1 deletion _quarto.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ project:
render:
- index.qmd
- _reference

- config.qmd

website:
page-navigation: true
Expand All @@ -24,8 +24,12 @@ website:
- text: Report a Bug
url: https://github.com/graeter-group/kimmdy-reactions/issues/new
left:
- file: index.qmd
text: Readme
- file: _reference/index.qmd
text: Reference
- file: config.qmd
text: Options

metadata-files:
- _sidebar.yml
Expand Down Expand Up @@ -60,6 +64,9 @@ interlinks:
url: https://numpy.org/doc/stable/
python:
url: https://docs.python.org/3.10/
kimmdy:
url: https://graeter-group.github.io/kimmdy/
inv: objects.txt

quartodoc:
sidebar: "_sidebar.yml"
Expand Down
68 changes: 68 additions & 0 deletions config.qmd
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
## All Options

For all KIMMDY options see [here](https://graeter-group.github.io/kimmdy/guide/references/input.html#all-options).

```{python}
#| echo: false
from kimmdy.schema import get_combined_scheme, flatten_scheme, generate_markdown_table, convert_schema_to_dict
from pathlib import Path
import json
def cat_options(reaction: str):
path = Path(f"./src/{reaction}/kimmdy-yaml-schema.json")
with path.open("r") as f:
schema = json.load(f)
scheme = convert_schema_to_dict(schema)
flat_scheme = flatten_scheme(scheme)
for item in flat_scheme:
print(f"### {item['key']}\n")
print(f"{item['desc']}\n\n")
if item['type'] != "":
print(f"**Type**: {item['type']}\n\n")
if item['enum'] != "":
print(f"**Options**: {item['enum']}\n\n")
if item['default'] != "":
print(f"**Default**: {item['default']}\n\n")
```

## Homolysis

```yaml
reactions:
homolysis: ...
```
```{python}
#| echo: false
#| output: asis
cat_options("homolysis")
```

## Dummy Reaction

```yaml
reactions:
dummyreaction: ...
```
```{python}
#| output: asis
#| echo: false
cat_options("dummyreaction")
```

## Naive HAT

```yaml
reactions:
hat_naive: ...
```
```{python}
#| output: asis
#| echo: false
cat_options("hat_naive")
```

8 changes: 8 additions & 0 deletions docs/_reference/dummyreaction.reaction.html
Original file line number Diff line number Diff line change
Expand Up @@ -90,10 +90,18 @@
</button>
<div class="collapse navbar-collapse" id="navbarCollapse">
<ul class="navbar-nav navbar-nav-scroll me-auto">
<li class="nav-item">
<a class="nav-link" href="../index.html">
<span class="menu-text">Readme</span></a>
</li>
<li class="nav-item">
<a class="nav-link active" href="../_reference/index.html" aria-current="page">
<span class="menu-text">Reference</span></a>
</li>
<li class="nav-item">
<a class="nav-link" href="../config.html">
<span class="menu-text">Options</span></a>
</li>
</ul>
</div> <!-- /navcollapse -->
<div class="quarto-navbar-tools tools-wide">
Expand Down
8 changes: 8 additions & 0 deletions docs/_reference/hat_naive.reaction.html
Original file line number Diff line number Diff line change
Expand Up @@ -91,10 +91,18 @@
</button>
<div class="collapse navbar-collapse" id="navbarCollapse">
<ul class="navbar-nav navbar-nav-scroll me-auto">
<li class="nav-item">
<a class="nav-link" href="../index.html">
<span class="menu-text">Readme</span></a>
</li>
<li class="nav-item">
<a class="nav-link active" href="../_reference/index.html" aria-current="page">
<span class="menu-text">Reference</span></a>
</li>
<li class="nav-item">
<a class="nav-link" href="../config.html">
<span class="menu-text">Options</span></a>
</li>
</ul>
</div> <!-- /navcollapse -->
<div class="quarto-navbar-tools tools-wide">
Expand Down
8 changes: 8 additions & 0 deletions docs/_reference/homolysis.reaction.html
Original file line number Diff line number Diff line change
Expand Up @@ -91,10 +91,18 @@
</button>
<div class="collapse navbar-collapse" id="navbarCollapse">
<ul class="navbar-nav navbar-nav-scroll me-auto">
<li class="nav-item">
<a class="nav-link" href="../index.html">
<span class="menu-text">Readme</span></a>
</li>
<li class="nav-item">
<a class="nav-link active" href="../_reference/index.html" aria-current="page">
<span class="menu-text">Reference</span></a>
</li>
<li class="nav-item">
<a class="nav-link" href="../config.html">
<span class="menu-text">Options</span></a>
</li>
</ul>
</div> <!-- /navcollapse -->
<div class="quarto-navbar-tools tools-wide">
Expand Down
8 changes: 8 additions & 0 deletions docs/_reference/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -90,10 +90,18 @@
</button>
<div class="collapse navbar-collapse" id="navbarCollapse">
<ul class="navbar-nav navbar-nav-scroll me-auto">
<li class="nav-item">
<a class="nav-link" href="../index.html">
<span class="menu-text">Readme</span></a>
</li>
<li class="nav-item">
<a class="nav-link active" href="../_reference/index.html" aria-current="page">
<span class="menu-text">Reference</span></a>
</li>
<li class="nav-item">
<a class="nav-link" href="../config.html">
<span class="menu-text">Options</span></a>
</li>
</ul>
</div> <!-- /navcollapse -->
<div class="quarto-navbar-tools tools-wide">
Expand Down
8 changes: 8 additions & 0 deletions docs/_reference/reaction.DummyReaction.html
Original file line number Diff line number Diff line change
Expand Up @@ -89,10 +89,18 @@
</button>
<div class="collapse navbar-collapse" id="navbarCollapse">
<ul class="navbar-nav navbar-nav-scroll me-auto">
<li class="nav-item">
<a class="nav-link" href="../index.html">
<span class="menu-text">Readme</span></a>
</li>
<li class="nav-item">
<a class="nav-link" href="../_reference/index.html">
<span class="menu-text">Reference</span></a>
</li>
<li class="nav-item">
<a class="nav-link" href="../config.html">
<span class="menu-text">Options</span></a>
</li>
</ul>
</div> <!-- /navcollapse -->
<div class="quarto-navbar-tools tools-wide">
Expand Down
8 changes: 8 additions & 0 deletions docs/_reference/reaction.Homolysis.html
Original file line number Diff line number Diff line change
Expand Up @@ -89,10 +89,18 @@
</button>
<div class="collapse navbar-collapse" id="navbarCollapse">
<ul class="navbar-nav navbar-nav-scroll me-auto">
<li class="nav-item">
<a class="nav-link" href="../index.html">
<span class="menu-text">Readme</span></a>
</li>
<li class="nav-item">
<a class="nav-link" href="../_reference/index.html">
<span class="menu-text">Reference</span></a>
</li>
<li class="nav-item">
<a class="nav-link" href="../config.html">
<span class="menu-text">Options</span></a>
</li>
</ul>
</div> <!-- /navcollapse -->
<div class="quarto-navbar-tools tools-wide">
Expand Down
8 changes: 8 additions & 0 deletions docs/_reference/reaction.NaiveHAT.html
Original file line number Diff line number Diff line change
Expand Up @@ -89,10 +89,18 @@
</button>
<div class="collapse navbar-collapse" id="navbarCollapse">
<ul class="navbar-nav navbar-nav-scroll me-auto">
<li class="nav-item">
<a class="nav-link" href="../index.html">
<span class="menu-text">Readme</span></a>
</li>
<li class="nav-item">
<a class="nav-link" href="../_reference/index.html">
<span class="menu-text">Reference</span></a>
</li>
<li class="nav-item">
<a class="nav-link" href="../config.html">
<span class="menu-text">Options</span></a>
</li>
</ul>
</div> <!-- /navcollapse -->
<div class="quarto-navbar-tools tools-wide">
Expand Down
8 changes: 8 additions & 0 deletions docs/_reference/reaction.html
Original file line number Diff line number Diff line change
Expand Up @@ -89,10 +89,18 @@
</button>
<div class="collapse navbar-collapse" id="navbarCollapse">
<ul class="navbar-nav navbar-nav-scroll me-auto">
<li class="nav-item">
<a class="nav-link" href="../index.html">
<span class="menu-text">Readme</span></a>
</li>
<li class="nav-item">
<a class="nav-link" href="../_reference/index.html">
<span class="menu-text">Reference</span></a>
</li>
<li class="nav-item">
<a class="nav-link" href="../config.html">
<span class="menu-text">Options</span></a>
</li>
</ul>
</div> <!-- /navcollapse -->
<div class="quarto-navbar-tools tools-wide">
Expand Down
Loading

0 comments on commit 043222f

Please sign in to comment.