.. _[t-let]:

[ T-LET ] セクション
==================================================

任意の物質の LET (:math:`dE/dx`) の関数として、track length や dose を
タリーします。**[t-heat]** と異なり、ここでの dose は、荷電粒子の
エネルギー付与だけをタリーします。LET の単位は、keV/um です。
**[t-let]** を使い、中性子の輸送計算を行う場合は、
Event Generator mode (**e-mode>=1**) にする必要があります。
また、電子に関しては、計算打切エネルギー **emin** 以下の粒子の寄与は
タリーさせませんので、ご注意ください。

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

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

   * - value
     - explanation
   * - **reg, r-z, xyz**
     - メッシュ型。
       メッシュ型サブセクションが必要です。

.. include:: ./commontally/volume.rst
.. include:: ./commontally/iechrl.rst
.. rst-class:: no-caption-number

.. list-table:: **l-type**
   :header-rows: 0

   * - value
     - explanation
   * - **1, 2, 3, 4, 5**
     - LET メッシュ。単位は [keV/um]。
       LET メッシュサブセクションの定義方法は :numref:`sec-mesh-type` を参照。
       ただし、メッシュを細かく設定しすぎる
       （1桁あたり 20 分割以上）と、得られた LET スペクトルに
       物理的に意味のないピークが生じますのでご注意ください。

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

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

   * - value
     - explanation
   * - **all** （省略時）, 粒子名
     - タリーする粒子。

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

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

   * - value
     - explanation
   * - **let, reg, x, y, z, r**
     - 出力データの x 軸。
   * - **xy, yz, xz, rz**
     - 2次元表示。

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

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

   * - value
     - explanation
   * - **1, 2, 3, 4, 5, 6**
     - 1: Track [cm/(keV/um)/source]
       2: Dose [MeV/(keV/um)/source]
       3: Track [cm/ln(keV/um)/source]
       4: Dose [MeV/ln(keV/um)/source]
       5: Track [cm/source]
       6: Dose [MeV/source]
   * - **7, 8, 9, 10, 11, 12**
     - 7: Track [1/cm^2/(keV/um)/source]
       8: Dose [MeV/cm^3/(keV/um)/source]
       9: Track [1/cm^2/ln(keV/um)/source]
       10: Dose [MeV/cm^3/ln(keV/um)/source]
       11: Track [1/cm^2/source]
       12: Dose [MeV/cm^3/source]
   * - **13, 14**
     - 13: :math:`L*f(L)` [dimensionless] ただし :math:`\int f(L)dL=1` に規格化。
       14: :math:`L*d(L)` [keV/um] ただし :math:`\int d(L)dL=1` に規格化。

.. include:: ./commontally/factor.rst

Version 3.02 より新たな **unit=13,14** が加わりました。
どちらもマイクロドジメトリ分野でよく使われる形式で、:math:`f(L)` と
:math:`d(L)` は、それぞれ LET (:math:`L`) に対する飛跡及び線量の
確率密度 (probability density) を表します。
**unit=13,14** の結果は、それぞれ **unit=2,4** の結果と比例関係にありますが、
確率密度関数の積分値が 1 に規格化されているため、その絶対値が異なります。
また、**sum over** の代わりに、**unit=13** の場合は頻度平均
（Frequency mean）、**unit=14** の場合は線量平均（Dose mean）の値が
出力されます。ただし、その誤差は出力されません（常に 0.000 となる）。
なお、**unit=13,14** は、**axis=let** のみ有効となります。

.. include:: ./commontally/title.rst
.. include:: ./commontally/angel.rst
.. include:: ./commontally/sangel.rst
.. include:: ./commontally/2d-type.rst
.. include:: ./commontally/gshow.rst
.. include:: ./commontally/rshow.rst
.. include:: ./commontally/gslat.rst
.. include:: ./commontally/x-txt.rst
.. include:: ./commontally/y-txt.rst
.. include:: ./commontally/z-txt.rst
.. include:: ./commontally/resol.rst
.. include:: ./commontally/width.rst
.. include:: ./commontally/trcl.rst

.. include:: ./commontally/material.rst
.. include:: ./commontally/volmat.rst
.. rst-class:: no-caption-number

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

   * - value
     - explanation
   * - （省略可）
     - LET (:math:`dE/dx`) を評価する物質番号。
       省略時は、実際の物質です。
       物質を指定する場合の密度は、**[Material]** セクションで定義された密度となります。
       したがって、水に対する LET 分布を計算したい場合、**[Material]** セクションで、
       水の密度が 1 g/cm^3 となるように定義する必要があります。
       また、負の場合は電子・陽電子の :math:`dE/dx` として 1 g/cm^3 の水に対する値が参照されます。
       詳しくは、``phits/recommendation/ParticleTherapy`` を参照してください。

.. include:: ./commontally/epsout.rst
.. include:: ./commontally/maxangel.rst
.. include:: ./commontally/ctmin.rst
.. include:: ./commontally/ctmax.rst
.. include:: ./commontally/chmin.rst
.. include:: ./commontally/chmax.rst
.. include:: ./commontally/stdcut.rst