You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: _sources/theory/rmg/prune.rst.txt
+18-18Lines changed: 18 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,30 +12,30 @@ in order to achieve both low memory consumption and mechanism accuracy. Pruning
12
12
Key Parameters in Pruning
13
13
=========================
14
14
15
-
* toleranceKeepInEdge
15
+
* ``toleranceKeepInEdge``
16
16
17
-
Any edge species to prune should have peak flux along the whole conversion course lower than toleranceKeepInEdge :math:`*` characteristic flux. Thus, larger values will lead to smaller edge mechanisms.
17
+
Any edge species to prune should have peak flux along the whole conversion course lower than ``toleranceKeepInEdge``:math:`*` characteristic flux. Thus, larger values will lead to smaller edge mechanisms.
18
18
19
-
* toleranceMoveToCore
19
+
* ``toleranceMoveToCore``
20
20
21
-
Any edge species to enter core model should have flux at some point larger than toleranceMoveToCore :math:`*` characteristic flux Thus, in general, smaller values will lead to larger core mechanisms.
21
+
Any edge species to enter core model should have flux at some point larger than ``toleranceMoveToCore``:math:`*` characteristic flux. Thus, in general, smaller values will lead to larger core mechanisms.
22
22
23
-
* toleranceInterrupSimulation
23
+
* ``toleranceInterruptSimulation``
24
24
25
-
Once flux of any edge species exceeds toleranceInterruptSimulation :math:`*` characteristic flux, dynamic simulation will be stopped.
25
+
Once flux of any edge species exceeds ``toleranceInterruptSimulation``:math:`*` characteristic flux, dynamic simulation will be stopped.
26
26
Usually this tolerance will be set a very high value so that any flux's exceeding that means mechanism is too incomplete to continue
27
27
dynamic simulation.
28
28
29
-
* maximumEdgeSpecies
29
+
* ``maximumEdgeSpecies``
30
30
31
31
If dynamic simulation isn't interrupted in half way and total number of the edge species whose peak fluxes are higher than
32
-
toleranceKeepInEdge :math:`*` characteristic flux exceeds maximumEdgeSpecies, such excessive amount of edge species with lowest peak fluxes will be pruned.
32
+
``toleranceKeepInEdge``:math:`*` characteristic flux exceeds ``maximumEdgeSpecies``, such excessive amount of edge species with lowest peak fluxes will be pruned.
33
33
34
-
* minCoreSizeForPrune
34
+
* ``minCoreSizeForPrune``
35
35
36
36
Ensures that a minimum number of species are in the core before pruning occurs, in order to avoid pruning the model when it is far away from completeness. The default value is set to 50 species.
37
37
38
-
* minSpeciesExistIterationsForPrune
38
+
* ``minSpeciesExistIterationsForPrune``
39
39
40
40
Set the number of iterations an edge species must stay in the job before it can be pruned. The default value is 2 iterations.
41
41
@@ -46,20 +46,20 @@ How Pruning Works
46
46
47
47
The goal of pruning is to delete those "useless" edge species. So "usefulness" should be defined and it's natural to have flux as a
48
48
criterion for "usefulness". Since flux changes with reactant conversion, peak flux is chosen here to make decision of pruning or not.
49
-
Every time pruning is triggered, edge species with peak flux lower than toleranceKeepInEdge :math:`*` characteristic flux will be deleted.
49
+
Every time pruning is triggered, edge species with peak flux lower than ``toleranceKeepInEdge``:math:`*` characteristic flux will be deleted.
50
50
51
51
.. figure:: fluxDiagramWithTolerance.png
52
52
53
-
However, pruning is not always triggered because of toleranceInterruptSimulation. As mentioned above, in order to prune, RMG needs to figure out
53
+
However, pruning is not always triggered because of ``toleranceInterruptSimulation``. As mentioned above, in order to prune, RMG needs to figure out
54
54
the peak flux of each edge species, which requires dynamic simulation to complete. If some run of dynamic simulation is terminated in half way
55
-
by toleranceInterruptSimulation, pruning is rejected although there might be some edge species with peak fluxes lower than
56
-
toleranceKeepInEdge :math:`*` characteristic flux. Since pruning requires to complete dynamic simulation, setting toleranceInterruptSimulation to be positive infinity,
57
-
as an extreme case, means always enabling pruning. Another extreme case would be that it has same value as toleranceMoveToCore where
55
+
by ``toleranceInterruptSimulation``, pruning is rejected although there might be some edge species with peak fluxes lower than
56
+
``toleranceKeepInEdge``:math:`*` characteristic flux. Since pruning requires to complete dynamic simulation, setting ``toleranceInterruptSimulation`` to be positive infinity,
57
+
as an extreme case, means always enabling pruning. Another extreme case would be that it has same value as ``toleranceMoveToCore`` where
58
58
no pruning occurs.
59
59
60
-
In summary, each run of dynamic simulation will proceed towards terminationConversion unless some flux exceeds
61
-
toleranceInterruptSimulation :math:`*` characteristic flux.Following complete simulation is the pruning of edge species whose flux is not high enough be kept
62
-
in the edge, which is followed by pruning of excessive amount of edge species to make sure total edge species number is no greater than maximumEdgeSpecies.
60
+
In summary, each run of dynamic simulation will proceed towards ``terminationConversion`` unless some flux exceeds
61
+
``toleranceInterruptSimulation``:math:`*` characteristic flux.Following complete simulation is the pruning of edge species whose flux is not high enough be kept
62
+
in the edge, which is followed by pruning of excessive amount of edge species to make sure total edge species number is no greater than ``maximumEdgeSpecies``.
Please refer to the ``RMG``, ``RMG3``, and ``RMG_Database`` citations in the `CITATIONS.bib file <https://github.com/ReactionMechanismGenerator/RMG-Py/blob/main/CITATIONS.bib>`_.
0 commit comments