crunchflow.output.Speciation
============================

.. py:class:: crunchflow.output.Speciation(block_text)

   
   A class for parsing and storing the results from a single speciation block
   within a CrunchFlow output file.

   This class processes the full text of a speciation block and extracts:
   - Primary species and their total concentrations.
   - Secondary species with molality, activity, and activity coefficient.
   - Gas species and their partial pressures.
   - Mineral phases and their saturation indices.
   - Exchange sites, exchangers, and surface complexation data.
   - General geochemical properties such as temperature, porosity, pH, etc.

   :Parameters:

       **block_text** : str
           The full text of a speciation block from a CrunchFlow output file.

   :Attributes:

       **totcon** : pandas.DataFrame
           Total molality of primary species. Index is species name.

       **conc** : pandas.DataFrame
           Molality, activity, and activity coefficient of secondary species.

       **gas_conc** : pandas.DataFrame
           Partial pressure of gas species, in bars.

       **saturation** : pandas.DataFrame
           Saturation indices of minerals, in log format.

       **exchangers** : pandas.DataFrame
           Equivalent concentrations of exchange sites.

       **exchange_site_conc** : pandas.DataFrame
           Concentrations of primary species in exchange sites.

       **surface_complex** : pandas.DataFrame
           Concentrations of surface complex species.

       **temperature, porosity, pH, pe, eh, total_charge** : float
           Scalar geochemical properties extracted from the block.

       **primary_species, secondary_species, minerals, gases** : list of str
           Lists of species in each category.

   .. rubric:: Methods



   =============  ==========
   **__str__()**  Returns a summary string with primary and secondary species counts.  
   =============  ==========












   ..
       !! processed by numpydoc !!

   .. py:method:: __str__()

      
      Return a short summary string for the speciation block.

      Includes counts of primary and secondary species parsed.















      ..
          !! processed by numpydoc !!