Skip to content

Commit

Permalink
[Doc] Improve wording about automatic third-body detection
Browse files Browse the repository at this point in the history
  • Loading branch information
speth committed Jan 9, 2024
1 parent b294740 commit fb53e96
Showing 1 changed file with 9 additions and 4 deletions.
13 changes: 9 additions & 4 deletions doc/sphinx/reference/kinetics/reaction-rates.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,9 +25,10 @@ parameterizations such as the [modified Arrhenius](sec-arrhenius-rate) form.
:class: tip
An elementary reaction with an Arrhenius reaction rate can be defined in the YAML format
using the [`elementary`](sec-yaml-elementary) reaction `type`, or by omitting the
reaction `type` entry, as it represents the default. In case the `type` entry is omitted
and a species occurs on both sides of the reaction equation, Cantera infers that the
reaction type is [`three-body`](sec-yaml-three-body).
reaction `type` entry, as it represents the default. An exception to this default is
when the same species occurs on both sides of the reaction equation, in which case the
reaction is treated as a
[three-body reaction for a specific collider](sec-three-body-specific-collider).
```

(sec-three-body-reaction)=
Expand Down Expand Up @@ -69,6 +70,9 @@ The rate coefficient $k_f(T)$ may be implemented using any rate parameterization
supported by Cantera, not just the modified Arrhenius form.
:::

(sec-three-body-specific-collider)=
### Collider-specific rate parameterizations

Sometimes, accounting for a particular third body's collision efficiency may require an
alternate set of rate parameters entirely. In this case, two reactions are written:

Expand All @@ -79,7 +83,8 @@ $$
$$

where the third-body efficiency for C in the first reaction should be explicitly set to
zero.
zero. For the second reaction, the efficiencies will automatically be set to one for C
and zero for all other colliders.

```{admonition} YAML Usage
:class: tip
Expand Down

0 comments on commit fb53e96

Please sign in to comment.