Metadata-Version: 2.4
Name: flowtube
Version: 1.3.1
Summary: A Python package for transport and diffusion calculations in cylindrical flow reactors
Author-email: Corey Pedersen <coreyped@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/c-pedersen/flowtube
Project-URL: Repository, https://github.com/c-pedersen/flowtube
Project-URL: Documentation, https://github.com/c-pedersen/flowtube#readme
Project-URL: Bug Tracker, https://github.com/c-pedersen/flowtube/issues
Keywords: flow reactor,diffusion,transport,coated wall reactor,aerosol,atmospheric chemistry
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Chemistry
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.18.0
Requires-Dist: pandas>=1.0.0
Requires-Dist: tabulate>=0.8.0
Requires-Dist: molmass>=2019.1.1
Requires-Dist: requests>=2.22.0
Requires-Dist: scipy>=1.0.0
Provides-Extra: test
Requires-Dist: pytest>=8.0.0; extra == "test"
Requires-Dist: pytest-cov>=6.0.0; extra == "test"
Provides-Extra: dev
Requires-Dist: build>=1.0.0; extra == "dev"
Requires-Dist: twine>=6.0.0; extra == "dev"
Provides-Extra: docs
Requires-Dist: sphinx>=8.0.0; extra == "docs"
Requires-Dist: sphinx_autodoc_typehints; extra == "docs"
Requires-Dist: sphinx-rtd-theme>=2.0.0; extra == "docs"
Requires-Dist: sphinx-mdinclude; extra == "docs"
Requires-Dist: sphinx-autoapi>=3.0.0; extra == "docs"
Requires-Dist: ipykernel>=7.0.0; extra == "docs"
Requires-Dist: nbsphinx; extra == "docs"
Requires-Dist: pandoc; extra == "docs"
Dynamic: license-file

# flowtube Package

[![PyPI Version](https://img.shields.io/pypi/v/flowtube.svg?cacheSeconds=3600)](https://pypi.org/project/flowtube/)
[![License: MIT](https://cdn.prod.website-files.com/5e0f1144930a8bc8aace526c/65dd9eb5aaca434fac4f1c34_License-MIT-blue.svg)](/LICENSE)
[![Tests](https://github.com/c-pedersen/flowtube/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/c-pedersen/flowtube/actions/workflows/ci.yml)
[![codecov](https://codecov.io/gh/c-pedersen/flowtube/branch/main/graph/badge.svg?ts=20251106)](https://codecov.io/gh/c-pedersen/flowtube)
[![Documentation Status](https://readthedocs.org/projects/flowtube/badge/?version=stable)](https://flowtube.readthedocs.io/en/stable/?badge=stable)

A Python package for transport and diffusion calculations in cylindrical
flow reactors using the KPS method published in Knopf et al., Anal.
Chem., 2015. The package is currently designed for coated wall reactor
(CWR) and boat reactor analysis with plans to support aerosol flow
reactors in future versions.

Author: Corey Pedersen

Documentation: <https://flowtube.readthedocs.io/>

## Features

- Flow Calculations: Flow rates, velocities, residence times, and
Reynolds numbers.
- Transport Properties: Dynamic viscosity and density
- Diffusion Analysis: Binary diffusion coefficients, Péclet numbers, and
mixing parameters
- Uptake Modeling: Diffusion correction factors and uptake coefficient
calculations
- Support for Inserts: Handles coated cylindrical inserts within flow
tubes
- Support for Boats: Handles boat reactors which are placed inside of a
flow tube and filled with an analyte solution.

## Scientific Applications

This package is designed for atmospheric chemistry and aerosol research,
particularly for:

- Heterogeneous reaction kinetics studies
- Uptake coefficient measurements
- Flow reactor design and optimization
- Transport phenomena analysis in laminar flow systems

## Installation

```bash
pip install flowtube
```

## Acronyms

- `sccm = standard cubic centimeter per minute`
- `FT = flow tube`
- `FR = flow rate`
- `MR = mixing ratio`
- `CWR = coated wall reactor`

## Assumptions

KPS method assumptions (Knopf et al., 2015):

1. The interacting gas species is a trace gas in the bulk flow
2. Laminar flow is established in the flow reactor
3. The gas temperature and viscosity are homogeneous
4. The axial diffusion velocity is negligible compared to bulk flow
velocity
5. The amount of gas species taken up is small compared to its reservoir
6. There is an absence of gas-phase reactions impacting gas species
concentration

## Bibliography (more citations within package files)

Knopf, D.A., Pöschl, U., Shiraiwa, M., 2015. Radial Diffusion and
Penetration of Gas Molecules and Aerosol Particles through Laminar Flow
Reactors, Denuders, and Sampling Tubes. Anal. Chem. 87, 3746–3754.
<https://doi.org/10.1021/ac5042395>
