Metadata-Version: 2.1
Name: chemics
Version: 20.4
Summary: A Python package for chemical reactor engineering
Home-page: https://github.com/chemics/chemics
Author: Gavin Wiggins
License: UNKNOWN
Description: # Chemics
        
        The [Chemics][] package is a collection of Python functions for conducting calculations in the field of chemical and fluidization engineering. Source code for the package is available on [GitHub][] and contributions from the community are encouraged.
        
        ## Installation
        
        The [Anaconda][] or [Miniconda][] distribution of Python is recommended for scientific computing. After setting up Python, the Chemics package can be downloaded and installed with the `pip` package manager:
        
        ```bash
        pip install chemics
        ```
        
        ## Usage
        
        The example below imports the Chemics package then uses the `rhog()` function to calculate the density of a gas based on its molecular weight, pressure, and temperature.
        
        ```python
        import chemics as cm
        cm.rhog(28, 101325, 773)    # returns 0.4414
        ```
        
        The `ut()` function calculates the terminal velocity of a particle according to the Haider and Levenspiel 1989 paper as shown below.
        
        ```python
        import chemics as cm
        
        # Parameters
        dp = 0.00016    # particle diameter [m]
        mu = 1.8e-5     # gas viscosity [kg/(m s)]
        phi = 0.67      # particle sphericity [-]
        rhog = 1.2      # gas density [kg/m^3]
        rhos = 2600     # particle density [kg/m^3]
        
        # Haider and Levenspiel terminal velocity [m/s]
        # this assigns a value of 0.8857 to `ut_haider`
        ut_haider = cm.ut_haider(dp, mu, phi, rhog, rhos)
        ```
        
        Use the `ChemicalEquation` class to get properties of the reactants and products from a given chemical equation.
        
        ```python
        import chemics as cm
        
        ce = cm.ChemicalEquation('2 HCl + 2 Na -> 2 NaCl + H2')
        
        ce.balance
        # returns True for balanced equation
        
        ce.rct_properties
        # returns a dataframe of the reactant properties
        #                HCl        Na
        # moles            2         2
        # species        HCl        Na
        # molwt       36.458     22.99
        # mass        72.916     45.98
        # molfrac        0.5       0.5
        # massfrac  0.613275  0.386725
        ```
        
        More examples are available in the [chemics-examples][] repository.
        
        ## Documentation
        
        Documentation for the Chemics package is available at [chemics.github.io](https://chemics.github.io).
        
        ## Contributing
        
        See the [CONTRIBUTING.md](CONTRIBUTING.md) document for guidelines on contributing to the Chemics package.
        
        ## License
        
        Chemics is available under the MIT License - see the [LICENSE](LICENSE) file for more information.
        
        
        [anaconda]: https://www.anaconda.com
        [chemics]: https://pypi.org/project/chemics/
        [chemics-examples]: https://github.com/chemics/chemics-examples
        [github]: https://github.com/chemics/chemics
        [miniconda]: https://conda.io/miniconda.html
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
