Ising 2D T'-Expansion Scheme (Ising-2DTExS)
===========================================

The Ising-2DTExS module of the NSF-funded
`MUSES <https://musesframework.io/>`__ project enables to calculate a
family of 2D equations of state of nuclear matter, at finite temperature
:math:`T` and finite baryon chemical potential :math:`\mu_B`, including
a :math:`1^{st}` order phase transition and a critical point from 3D-Ising model. 
It employs the so-called :math:`T'` Expansion Scheme,
based on an effective temperature :math:`T'` which is defined as an
expansion in :math:`\mu_B`, using lattice coefficients :math:`\kappa`
computed at :math:`\mu_B=0` as expansion coefficients (with
:math:`\kappa` coefficients being related to susceptibilities
:math:`\chi`). The critical point, which critical region can be shaped
freely and location can be chosen along a parametrized transition line,
is mapped to QCD from the 3D Ising model universality class.

It can be used to compute nuclear equations of state for a temperature
range of :math:`30 < T < 800` MeV, and for baryon chemical potential
values of :math:`0 < \mu_B < 700` MeV, at :math:`\mu_Q = \mu_S = 0` MeV.

| **When using results from this module for scientific publication, please cite:**  
| M. Kahangirwe, S.A. Bass, E. Bratkovskaya, J. Jahan, P. Moreau, P. Parotto, D. Price, C. Ratti, O. Soloveva and M. Stephanov, *Phys.Rev.D 109* (2024) 9, 094046, `arXiv:2402.08636 <https://arxiv.org/abs/2402.08636>`__ [nucl-th]

============================

| **Original source code was developed by:** Micheal
  Kahangirwe\ :math:`^{(1)}` & Paolo Parotto\ :math:`^{(2)}`.
| **Module development and code adaptation by:** Johannes Jahan
  :math:`^{(1)}`, Micheal Kahangriwe :math:`^{(1)}` & Volodymyr Vovchenko :math:`^{(1)}`.

| :math:`^{(1)}` *Department of Physics, University of Houston, Houston, TX 77204, USA.*   
| :math:`^{(2)}` *Dipartimento di Fisica, Università di Torino and INFN Torino, I-10125, Torino, IT.*

============================

.. toctree::
   :maxdepth: 1
   :caption: Contents
   :glob:

   _contents/physics.rst
   _contents/quickstart.rst
   _contents/unite.rst
   _contents/parameters.rst
   _contents/Detailed_Running.rst
   _contents/troubleshooting.rst