:py:mod:`pytmosph3r.chemistry.dissociation`
===========================================

.. py:module:: pytmosph3r.chemistry.dissociation


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

.. py:class:: Parmentier2018Dissociation(gases=None, T_min=0, H2_dissociation=None, ratio_HeH2=None)


   Bases: :py:obj:`pytmosph3r.chemistry.chemistry.Chemistry`

   Chemistry model based on :cite:`parmentier2018`.

   A few notes: the dissociation of :math:`H_2` will create :math:`H` and :math:`He` automatically to fill the atmosphere.
   If you do not have cross-section data for them, you should also add them to the list of `transparent_gases`.

   :param gases: List of gases for which to consider dissociation, and eventually override the coefficients associated with each gas. Example: :code:`{'H2O':(2.,2.83,15.9),'H2':True}`. This overrides the coefficients for :math:`H_2O` but uses the default values for :math:`H_2`.
   :type gases: :obj:`dict`
   :param T_min: Minimum temperature for which to compute dissociation.
   :type T_min: float

   .. py:attribute:: wasp121b_coeffs

      

   .. py:attribute:: wasp121b_deep_abundances_log

      

   .. py:attribute:: H2_dissociation

      H2 dissociation will create H. He is also added (see :attr:`ratio_HeH2`).

   .. py:attribute:: ratio_HeH2

      When H2 dissociates, we add He using this ratio to define their deep abundances. :attr:`ratio_HeH2` = x_He_deep / x_H2_deep.

   .. py:method:: build(atmosphere)

      General function that will be called to compute the chemistry after :attr:`atmosphere` has been initialized. It iterates over :attr:`gases` by calling :func:`compute_vmr` on each gas.

      :param atmosphere: Altitude-based atmosphere in which to compute the volume mixing ratios of :attr:`gases`.
      :type atmosphere: :class:`~pytmosph3r.atmosphere.altitudeatmosphere.AltitudeAtmosphere`
      :param input_atmosphere: Input atmosphere if you need it (with input mix_ratios for example).
      :type input_atmosphere: :class:`~pytmosph3r.atmosphere.inputatmosphere.InputAtmosphere`, optional


   .. py:method:: compute_vmr(gas, mix_ratio)

      This function can be overridden to compute the volume mixing ratio of a gas :attr:`gas` using :attr:`mix_ratio`, initialized to an array with the :attr:`~pytmosph3r.Grid3D.shape` of the atmosphere.

      :param gas: Name of the gas
      :type gas: str
      :param mix_ratio: Array full of ones of shape :attr:`~pytmosph3r.Grid3D.shape`. The array is filled with the values in the atmosphere is the gas was already present, or else ones.
      :type mix_ratio: array, np.ndarray


   .. py:method:: inputs()