https://github.com/calebbell/fluids

Fluid dynamics component of Chemical Engineering Design Library (ChEDL)

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

○
CITATION.cff file
✓
codemeta.json file
Found codemeta.json file
✓
.zenodo.json file
Found .zenodo.json file
○
DOI references
✓
Academic publication links
Links to: zenodo.org
○
Committers with academic emails
○
Institutional organization owner
○
JOSS paper metadata
○
Scientific vocabulary similarity
Low similarity (17.6%) to scientific vocabulary

Keywords

atmosphere chemical-engineering compressible-fluid-dynamics drag engineering fluid-dynamics friction mechanical-engineering open-channel particle-size-distribution pipe pipeline pressure-drop process-simulation pump reynolds sedimentation tank two-phase valve

Keywords from Contributors

thermodynamics viscosity vapor-pressure thermal-conductivity surface-tension solubility physics molecule heat-capacity equation-of-state

Last synced: 5 months ago · JSON representation

Repository

Fluid dynamics component of Chemical Engineering Design Library (ChEDL)

Basic Info

Host: GitHub
Owner: CalebBell
License: mit
Language: Python
Default Branch: master
Size: 8.11 MB

Statistics

Stars: 396
Watchers: 28
Forks: 77
Open Issues: 4
Releases: 20

Topics

Created about 10 years ago · Last pushed 11 months ago

Metadata Files

Readme Changelog Contributing License Security Authors

README.rst

======
fluids
======

.. image:: http://img.shields.io/pypi/v/fluids.svg?style=flat
:target: https://pypi.python.org/pypi/fluids
:alt: Version_status
.. image:: http://img.shields.io/badge/docs-latest-brightgreen.svg?style=flat
:target: https://fluids.readthedocs.io/
:alt: Documentation
.. 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?release
: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

.. contents::

What is Fluids?
---------------

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.

The fluids library is designed to be a low-overhead, lightweight repository
of engineering knowledge and utilities that relate to fluid dynamics.

Fluids was originally tightly integrated with SciPy and NumPy; today they
are optional components used for only a small amount of functionality
which do not have pure-Python numerical methods implemented.
Fluids targets Python 3.6 and up as well as PyPy3. Additionally,
fluids has been tested by the author to load in IronPython,
and micropython.

While the routines in Fluids are normally quite fast and as efficiently
coded as possible, depending on the application there can still be a need
for further speed. PyPy provides a substantial speed boost of 6-12 times
for most methods. Fluids also
supports Numba, a powerful accelerator that works well with NumPy.
The Numba interface to fluids also makes it easy to multithread
execution as well, avoiding Python GIL issue.

Fluids runs on all operating systems which support Python, is quick to
install, and is free of charge. Fluids is designed to
be easy to use while still providing powerful functionality.
If you need to perform some fluid dynamics calculations, give
fluids a try.

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

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 `_ as your package management, you can simply
install fluids in your environment from `conda-forge `_ channel with:

$ conda install -c conda-forge fluids

To get the git version, run:

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

Documentation
-------------

fluids's documentation is available on the web:

http://fluids.readthedocs.io/

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.

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.

Owner

Name: Caleb Bell
Login: CalebBell
Kind: user
Location: Calgary
Company: University of New Brunswick

Repositories: 17
Profile: https://github.com/CalebBell

GitHub Events

Total

Create event: 6
Release event: 2
Issues event: 9
Watch event: 41
Issue comment event: 14
Push event: 47
Pull request event: 13
Fork event: 3

Last Year

Create event: 6
Release event: 2
Issues event: 9
Watch event: 41
Issue comment event: 14
Push event: 47
Pull request event: 13
Fork event: 3

Committers

Last synced: 9 months ago

All Time

Total Commits: 1,682
Total Committers: 15
Avg Commits per committer: 112.133
Development Distribution Score (DDS): 0.015

Past Year

Commits: 223
Committers: 2
Avg Commits per committer: 111.5
Development Distribution Score (DDS): 0.004

Top Committers

Name	Email	Commits
Caleb Bell	C**l@g**m	1,656
Yoel	y**s@g**m	6
Anders Andreasen	5****6	3
luz paz	l****z	2
Richard Killam	r**m@g**m	2
Diego Volpatto	v**o@l**r	2
Kurt Kremitzki	k**t@k**s	2
Pierre Lesouhaitier	p**r@n**r	2
Stefano Rivera	g**b@r**t	1
Marc Jutras	j**c@g**m	1
Guillaume Jacquenot	G****t	1
GITHAE KEVIN	K**h@l**m	1
Edward Betts	e**d@4**m	1
Chris Lamb	l**y@d**g	1
Adam Beckmeyer	a**g@t**z	1

Committer Domains (Top 20 + Academic)

thebeckmeyers.xyz: 1 debian.org: 1 4angle.com: 1 rivera.za.net: 1 naarea.fr: 1 kwk.systems: 1 lncc.br: 1

Issues and Pull Requests

Last synced: 6 months ago

All Time

Total issues: 36
Total pull requests: 42
Average time to close issues: 8 months
Average time to close pull requests: 3 days
Total issue authors: 32
Total pull request authors: 18
Average comments per issue: 2.36
Average comments per pull request: 1.4
Merged pull requests: 29
Bot issues: 0
Bot pull requests: 0

Past Year

Issues: 3
Pull requests: 8
Average time to close issues: 11 days
Average time to close pull requests: 3 days
Issue authors: 2
Pull request authors: 3
Average comments per issue: 0.67
Average comments per pull request: 1.0
Merged pull requests: 6
Bot issues: 0
Bot pull requests: 0

View more stats

Top Authors

Issue Authors

Hagobert (2)
kkremitzki (2)
anthracitegrey (2)
markwmuller (2)
MTkeg (1)
InvncibiltyCloak (1)
bertrand-faure (1)
AllanBjerg (1)
pyup-bot (1)
benardt (1)
olejonny (1)
Filprots (1)
rddaz2013 (1)
NANDISHSHAH (1)
non-Jedi (1)

Pull Request Authors

CalebBell (17)
pyup-bot (9)
andr1976 (3)
kkremitzki (2)
stefanor (2)
luzpaz (2)
guidoca (2)
lamby (1)
InvncibiltyCloak (1)
yoelcortes (1)
PierreLesouhaitier (1)
Kevogich (1)
non-Jedi (1)
Gjacquenot (1)
EdwardBetts (1)

Top Labels

Issue Labels

enhancement (4)

Pull Request Labels

Packages

Total packages: 2
Total downloads:
- pypi 45,406 last-month
Total docker downloads: 92

Total dependent packages: 10
(may contain duplicates)
Total dependent repositories: 36
(may contain duplicates)
Total versions: 134
Total maintainers: 1

pypi.org: fluids

Fluid dynamics component of Chemical Engineering Design Library (ChEDL)

Homepage: https://github.com/CalebBell/fluids
Documentation: https://fluids.readthedocs.io/
License: MIT
Latest release: 1.1.0
published about 1 year ago

Versions: 97
Dependent Packages: 7
Dependent Repositories: 34
Downloads: 45,406 Last month
Docker Downloads: 92

Rankings

Dependent packages count: 1.3%

Downloads: 2.0%

Dependent repos count: 2.5%

Average: 3.1%

Stargazers count: 3.6%

Docker downloads count: 3.8%

Forks count: 5.2%

Maintainers (1)

CalebBell

Last synced: 6 months ago

conda-forge.org: fluids

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, and more. The fluids library depends on the SciPy library to provide numerical constants, interpolation, integration, and numerical solving functionality. fluids runs on all operating systems which support Python, is quick to install, and is free of charge. fluids is designed to be easy to use while still providing powerful functionality. If you need to perform some fluid dynamics calculations, give fluids a try.

Homepage: https://github.com/CalebBell/fluids
License: MIT
Latest release: 1.0.21
published almost 4 years ago

Versions: 37
Dependent Packages: 3
Dependent Repositories: 2

Rankings

Dependent packages count: 15.6%

Dependent repos count: 20.1%

Average: 20.4%

Forks count: 22.5%

Stargazers count: 23.5%

Last synced: 6 months ago

Dependencies

requirements.txt pypi

numpy >=1.5.0
scipy >=0.9.0

requirements_docs.txt pypi

ipython *
matplotlib *
nbsphinx *
numba *
numpy *
numpydoc *
pint *
scipy *
sphinx ==4.3.0
sphinx-sitemap *
sphinxcontrib-katex *

requirements_test.txt pypi

IPython * test
coveralls * test
fuzzywuzzy * test
matplotlib * test
numpy * test
pandas * test
pint * test
pytest * test
pytest-cov * test
pytz * test
scipy * test
sphinx * test
sympy * test
wheel * test

setup.py pypi

numpy >=1.5.0

.github/workflows/build.yml actions

actions/cache v2 composite
actions/checkout v2 composite
actions/setup-python v2 composite

environment.yml pypi

fluids *