Skip to content

Commit fb53e96

Browse files
committed
[Doc] Improve wording about automatic third-body detection
Fixes Cantera/cantera-website#262
1 parent b294740 commit fb53e96

File tree

1 file changed

+9
-4
lines changed

1 file changed

+9
-4
lines changed

doc/sphinx/reference/kinetics/reaction-rates.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -25,9 +25,10 @@ parameterizations such as the [modified Arrhenius](sec-arrhenius-rate) form.
2525
:class: tip
2626
An elementary reaction with an Arrhenius reaction rate can be defined in the YAML format
2727
using the [`elementary`](sec-yaml-elementary) reaction `type`, or by omitting the
28-
reaction `type` entry, as it represents the default. In case the `type` entry is omitted
29-
and a species occurs on both sides of the reaction equation, Cantera infers that the
30-
reaction type is [`three-body`](sec-yaml-three-body).
28+
reaction `type` entry, as it represents the default. An exception to this default is
29+
when the same species occurs on both sides of the reaction equation, in which case the
30+
reaction is treated as a
31+
[three-body reaction for a specific collider](sec-three-body-specific-collider).
3132
```
3233

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

73+
(sec-three-body-specific-collider)=
74+
### Collider-specific rate parameterizations
75+
7276
Sometimes, accounting for a particular third body's collision efficiency may require an
7377
alternate set of rate parameters entirely. In this case, two reactions are written:
7478

@@ -79,7 +83,8 @@ $$
7983
$$
8084

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

8489
```{admonition} YAML Usage
8590
:class: tip

0 commit comments

Comments
 (0)