.. _[t-time]:

[ T-Time ] section
==================================================

This tally gives information on the number of particles undergoing energy cut-off, escape, and decay in the time mesh [nsec].
Energy spectra of these particles can also be obtained.
In particular, this is the only tally that can obtain energy spectra of particles at the moment of energy cut-off.

.. rst-class:: no-caption-number

.. list-table:: **mesh**
   :header-rows: 0

   * - value
     - explanation
   * - **reg, r-z, xyz**
     - Mesh type.
       A mesh type subsection is required below this option.

.. include:: ./commontally/part.rst
.. include:: ./commontally/material.rst
.. include:: ./commontally/t-type.rst
.. include:: ./commontally/e-type.rst
.. rst-class:: no-caption-number

.. list-table:: **unit**
   :header-rows: 0

   * - value
     - explanation
   * - **1, 2, 3, 4**
     - **1**: [1/source]
       **2**: [1/nsec/source]
       **3**: [1/nsec/cm^3/source]
       **4**: [1/nsec/cm^3/MeV/source]

.. rst-class:: no-caption-number

.. list-table:: **axis**
   :header-rows: 0

   * - value
     - explanation
   * - **t, eng, reg, x, y, z, r**
     - x axis value of output data.
   * - **xy, yz, xz, rz**
     - 2-dimensional.

.. include:: ./commontally/samepage.rst
.. include:: ./commontally/file.rst
.. include:: ./commontally/resfile.rst
.. rst-class:: no-caption-number

.. list-table:: **output**
   :header-rows: 0

   * - value
     - explanation
   * - **all**
     - Energy cut-off, escape, and decay particles.
   * - **cutoff**
     - Energy cut-off particles.
   * - **escape**
     - Escape particles.
   * - **decay**
     - Decay particles.

.. include:: ./commontally/factor.rst
.. include:: ./commontally/title.rst
.. include:: ./commontally/angel.rst
.. include:: ./commontally/sangel.rst
.. include:: ./commontally/2d-type.rst
.. include:: ./commontally/x-txt.rst
.. include:: ./commontally/y-txt.rst
.. include:: ./commontally/z-txt.rst
.. include:: ./commontally/gshow.rst
.. rst-class:: no-caption-number

.. list-table:: **rshow**
   :header-rows: 0

   * - value
     - explanation
   * - **0** (default), **1, 2, 3**
     - When **mesh=xyz** and **axis=xy,yz,xz**, region border (1), material name (2), and region name (3) are plotted using this option.
       A **xyz** mesh section must be added below this option.

.. include:: ./commontally/resol.rst
.. include:: ./commontally/width.rst
.. rst-class:: no-caption-number

.. list-table:: **volume**
   :header-rows: 0

   * - value
     - explanation
   * - (optional)
     - This option defines the volume for each region for **reg** mesh.
       Volume definitions are required below this option.
       Values defined in **[volume]** are used in the case of no definition.
       If special description such as using ``(  )`` is used to specify a region in **reg=**, its internally defined region number is output in input echo when this volume subsection is not defined.
   * - **reg vol**
     - Volume definition.
       For details see the **[volume]** section.

.. include:: ./commontally/iechrl.rst
.. include:: ./commontally/volmat.rst
.. include:: ./commontally/epsout.rst
.. include:: ./commontally/bmpout.rst
.. include:: ./commontally/vtkout.rst
.. include:: ./commontally/vtkfmt.rst
.. include:: ./commontally/maxangel.rst
.. include:: ./commontally/ctmin.rst
.. include:: ./commontally/ctmax.rst
.. include:: ./commontally/chmin.rst
.. include:: ./commontally/chmax.rst
.. include:: ./commontally/trcl.rst
.. rst-class:: no-caption-number

.. list-table:: **dump**
   :header-rows: 0

   * - value
     - explanation
   * - Number of data
     - For **mesh=reg**, the information is dumped on the file.
       If **dump** is negative, data are written in ascii, and if positive, in binary.
   * - (next line)
     - Data sequence.
       Define the data sequence.
       The history information, **nocas** and **nobch**, is necessary to use **idmpmode=1**.

.. include:: ./commontally/gslat.rst
.. include:: ./commontally/stdcut.rst

In the **[t-time]** tally, the dump option can only be used with **output=cutoff**.
If the dump option is set, the **e-type** and **t-type** meshes take on only the maximum and minimum values.
When using this dump parameter, **axis** and **file** are restricted to one axis and one file, and **unit** is always 1.
The dumped data are written onto a file named ``***_dmp``, where ``***`` indicates the file name specified by **file=***.
The normal output of the tally is written on ``***``.
From this file, information on the total normalization factor can be obtained; doing so requires setting one mesh each for **e-type** and **t-type**.
Note that constraints based on the history counter, **chmin** and **chmax**, do not work with the dump function because the particle information is output to the dump file immediately after the condition specified by the **output** parameter is met.
The history information, **nocas** and **nobch**, is necessary to use **idmpmode=1** for continuous calculation using the dump file; in addition, both the dump file with ``_dmp`` and the normal output file specified by **file** are required to use **idmpmode=1**.
The option **dumpall** is not compatible with this dump tally option when shared memory parallelization is active.