:py:mod:`FELiCS.Equation.Reactions.NOx`
=======================================

.. py:module:: FELiCS.Equation.Reactions.NOx


Module Contents
---------------

Classes
~~~~~~~

.. autoapisummary::

   FELiCS.Equation.Reactions.NOx.NOx




.. py:class:: NOx(P)


   Class for computing NO and NO2 source terms based on pre-tabulated data.

   This class uses a CSV table to interpolate reaction source terms for NO and NO2
   as a function of the mixture fraction or equivalence ratio (`phi`). These interpolated
   values are used to add source terms to the weak form of a finite element formulation.

   **Initialize the NOx object**

   :param P: Placeholder for configuration or context parameter (currently unused).
   :type P: :py:class:`any`

   .. py:method:: add_source_to_weak_form(weakform, dQ_threshold=None)

      Add NO and NO2 source terms to the weak form based on interpolated data.

      Interpolates pre-tabulated NO and NO2 production rates as a function of
      the local `phi` field and assigns them as source terms in the weak form.
      Optionally filters source terms based on a heat release threshold.

      :param weakform: The weak form structure, expected to include test functions `v_NO`, `v_NO2`,
                       and solution fields `phi` and `T`.
      :type weakform: :py:class:`object`
      :param dQ_threshold: A threshold for the mean heat release rate; source terms are suppressed
                           where the temperature `T` is below 1000 K.
      :type dQ_threshold: :py:class:`float`, *optional*

      :returns: **eq** -- The assembled weak form with NO and NO2 source terms included.
      :rtype: :py:class:`ufl.Form`