Welcome to Fluids's documentation!
==================================

  .. meta::
      :google-site-verification: wcmDZ88ikLzq1to6urRDGA6R7oIhzya2sN5hOeV1zZw

Fluids is open-source software for engineers and technicians working in the
fields of chemical, mechanical, or civil engineering. It includes modules
for piping, fittings, pumps, tanks, compressible flow, open-channel flow,
atmospheric properties, solar properties, particle size distributions,
two phase flow, friction factors, control valves, orifice plates and
other flow meters, ejectors, relief valves, and more.


   
   
Module Contents:

.. toctree::
   :maxdepth: 2
   
   tutorial.rst
   modules.rst
   examples.rst
   data.rst
   sample_programs.rst
   developers.rst


Installation
------------

.. image:: http://img.shields.io/pypi/v/fluids.svg?style=flat
   :target: https://pypi.python.org/pypi/fluids
   :alt: Version_status
.. image:: https://github.com/CalebBell/fluids/workflows/Build/badge.svg
   :target: https://github.com/CalebBell/fluids/actions
   :alt: Build_status
.. image:: http://img.shields.io/badge/license-MIT-blue.svg?style=flat
   :target: https://github.com/CalebBell/fluids/blob/master/LICENSE.txt
   :alt: license
.. image:: https://img.shields.io/coveralls/CalebBell/fluids.svg?
   :target: https://coveralls.io/github/CalebBell/fluids
   :alt: Coverage
.. image:: https://img.shields.io/pypi/pyversions/fluids.svg?
   :target: https://pypi.python.org/pypi/fluids
   :alt: Supported_versions
.. image:: http://img.shields.io/appveyor/ci/calebbell/fluids.svg?
   :target: https://ci.appveyor.com/project/calebbell/fluids/branch/master
   :alt: Build_status
.. image:: https://zenodo.org/badge/48924523.svg?
   :alt: Zendo
   :target: https://zenodo.org/badge/latestdoi/48924523

Get the latest version of fluids from
https://pypi.python.org/pypi/fluids/

If you have an installation of Python with pip, simple install it with:

    $ pip install fluids

Alternatively, if you are using `conda <https://conda.io/en/latest/>`_ as your package management, you can simply
install fluids in your environment from `conda-forge <https://conda-forge.org/>`_ channel with:

    $ conda install -c conda-forge fluids 

To get the git version, run:

    $ git clone git://github.com/CalebBell/fluids.git

Latest source code
------------------

The latest development version of fluids's sources can be obtained at

    https://github.com/CalebBell/fluids


Bug reports
-----------

To report bugs, please use the fluids's Bug Tracker at:

    https://github.com/CalebBell/fluids/issues
    
If you have further questions about the usage of the library, feel free
to contact the author at Caleb.Andrew.Bell@gmail.com.


License information
-------------------

Fluids is MIT licensed. See ``LICENSE.txt`` for full information 
on the terms & conditions for usage of this software, and a 
DISCLAIMER OF ALL WARRANTIES.

Although not required by the fluids license, if it is convenient for you,
please cite fluids if used in your work. Please also consider contributing
any changes you make back, such that they may be incorporated into the
main library and all of us will benefit from them.

Compliance information
----------------------
The author testifies that this software is not subject to the US EAR. The country of origin of this software is Canada.
The author also confirms confirm that this software is not developed by, contain components developed by, or receive substantial influence from entities prohibited by Section 889 of the 2019 NDAA.

Citation
--------

To cite fluids in publications use::

    Caleb Bell and Contributors (2016-2024). fluids: Fluid dynamics component of Chemical Engineering Design Library (ChEDL)
    https://github.com/CalebBell/fluids.


Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

