Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Add documentation informing the user of a possible pitfall
  • Loading branch information
tjlaboss committed Apr 30, 2024
commit 41fb79966c8574725ce5a16946d960d4129cf29c
5 changes: 5 additions & 0 deletions docs/source/io_formats/tallies.rst
Original file line number Diff line number Diff line change
Expand Up @@ -105,6 +105,11 @@ The ``<tally>`` element accepts the following sub-elements:
convergece of the precision trigger. If True, only nonzero tally scores
will be compared to the trigger's threshold.

.. note:: The ``ignore_zeros`` option can cause the tally trigger to fire
prematurely if there are no hits in any bins at the first
evalulation. It is the user's responsibility to specify enough
particles per batch to get a nonzero score in at least one bin.

*Default*: False

:scores:
Expand Down
4 changes: 3 additions & 1 deletion openmc/trigger.py
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,9 @@ class Trigger(EqualityMixin):
threshold : float
The threshold for the trigger type.
ignore_zeros : bool
Whether to allow zero tally bins to be ignored.
Whether to allow zero tally bins to be ignored. Note that this option
can cause the trigger to fire prematurely if there are zero scores in
any bin at the first evaluation.

.. versionadded:: 0.14.1

Expand Down