Flavor Equilibration
=====================

The flavor equilibration input file must be provided in order to run a workflow with the 
`Flavor Equilibration <https://gitlab.com/nsf-muses/flavor-equilibration/beta_equil>`_ module, but it is optional for the Lepton module.
The input file requires the following columns: 

+---------------------------------------------+------------------+
| **Variable**                                | **Unit**         |
+=============================================+==================+
| Temperature (T)                             | MeV              |
+---------------------------------------------+------------------+
| Baryon chemical potential (:math:`\mu_B`)   | MeV              |
+---------------------------------------------+------------------+
| Strange chemical potential (:math:`\mu_S`)  | MeV              |
+---------------------------------------------+------------------+
| Electron chemical potential (:math:`\mu_e`) | MeV              |
+---------------------------------------------+------------------+
| Baryon density (:math:`n_B`)                | fm\ :sup:`-3`    |
+---------------------------------------------+------------------+
| Strange density (:math:`n_S`)               | fm\ :sup:`-3`    |
+---------------------------------------------+------------------+
| Electric charge density (:math:`n_Q`)       | fm\ :sup:`-3`    |
+---------------------------------------------+------------------+
| Energy density (:math:`\varepsilon_B`)      | MeV/fm\ :sup:`3` |
+---------------------------------------------+------------------+
| Pressure (:math:`P_B`)                      | MeV/fm\ :sup:`3` |
+---------------------------------------------+------------------+
| Entropy density (:math:`s_B`)               | 1/fm\ :sup:`3`   |
+---------------------------------------------+------------------+
| Proton effective mass (:math:`m_p^*`)       | MeV              |
+---------------------------------------------+------------------+
| Neutron effective mass (:math:`m_n^*`)      | MeV              |
+---------------------------------------------+------------------+
| Proton chemical potential (:math:`\mu_p`)   | MeV              |
+---------------------------------------------+------------------+
| Neutron chemical potential (:math:`\mu_n`)  | MeV              |
+---------------------------------------------+------------------+
| Proton baryon density (:math:`n_p`)         | fm\ :sup:`-3`    |
+---------------------------------------------+------------------+
| Neutron baryon density (:math:`n_n`)        | fm\ :sup:`-3`    |
+---------------------------------------------+------------------+
| Proton optical potential (:math:`U_p`)      | MeV              |
+---------------------------------------------+------------------+
| Neutron optical potential (:math:`U_n`)     | MeV              |
+---------------------------------------------+------------------+

To generate the output file, named `charge_neutrality_flavor_equilibration.csv`,  both the **use_charge_neutrality** and **output_flavor_equilibration** options must be enabled, 
and the files **eos_input_file** and **flavor_equilibration_input_file** must be provided in the config file if you are not using the Calculation Engine.

**Important**: Currently, the Flavor Equilibration module can only handle electrons, so please do not enable any other particles.