Skip to content

Commit 7230de2

Browse files
committed
add crash analysis tool to docs
1 parent b4da4a0 commit 7230de2

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

docs/src/Analysis.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -80,6 +80,13 @@ Transitory sensitivity values can be computed using several different algorithms
8080
Please let us know on our Github issues page if we're missing any important
8181
property calculators.
8282

83+
## Crash Analysis
84+
85+
When thermodynamics and kinetics are poorly assigned mechanisms can become too stiff to simulate causing the solver to crash. In these
86+
cases it is very important to be able to efficiently identify potential offending thermochemistry and/or kinetics. Our crash analysis tool analyzes
87+
the reaction and species fluxes to identify NaN quantities and quantities that are unusually large. A crash report can be generated from the associated `Simulation` or `SystemSimulation` object with `printcrashanalysis(analyzecrash(sim;tol=tol))`. In general, the correct `tol` depends on how much faster the offending chemistry is than the real chemistry. Rather than use the default tolerance one should adjust `tol` to achieve a reasonable amount of possible offending thermochemistry and kinetics, adjusting up to reduce the amount identified while decreasing `tol` will cause
88+
the amount identified to increase.
89+
8390
## Plotting
8491

8592
### Plotting Mole Fractions

0 commit comments

Comments
 (0)