mnFlow Documentation

Micro-nanoflow (mnFlow) library is aimed at providing the community with tools for design and modeling of micro-nanofluidic chips. The current focus of the project is on Deterministic Lateral Displacement (DLD) structures. In particular, the DLD design automation (DDA) tool aims at automating the entire process of design and production of computer-aided design (CAD) files for DLD-based micro-nanofluidic chips. The produced CAD files can be used for computational modeling, optimization, and manufacturing of DLD devices.

Check out the Usage section for further information, including how to install the package as well as a quick start. The Tutorials section also includes a set of examples to introduce various features of the package. Finally, the Manual section describes how the package works under the hood. For information on how to cite the related works see Citation.

Note

This project is under development.

Contents:

• Usage
  • Installation
  • Quick start
• Tutorials
  • Benchmarks from original paper
  • Benchmarks from original paper (ESI)
  • Benchmarks: Pressure Balance
  • Benchmarks: Multi-lane boundary (MLB) model
• Manual
  • Core
  • Block
  • Multistage
  • Condenser-and-Sorter
• API
  • mnflow.mfda.cad.dld.theme.core.DLD
  • mnflow.mfda.cad.dld.theme.block.DLD
  • mnflow.mfda.cad.dld.theme.multistage.DLD
  • mnflow.mfda.cad.dld.theme.condenser_sorter.DLD

Acknowledgments

This project utilizes the packages mentioned in the following. We gratefully acknowledge their contributions to this project.

• klayout: For creating CAD layouts.

• numpy: For numerical computations.

• pillow: For creating image of layouts.

• scipy: For solving equations.

• matplotlib: For data visualization

• black, flake8, and isort: For linting and formatting codes.

• git and pre-commit: For revision control and pre-commit hooks, respectively.

• sphinx, and sphinx-rtd-theme: For creating docs.

• pytest, and pytest-cov: For creating test cases.

Citation

If you use this work in your research, please cite the relevant works associated with it as listed in the following.

Original paper

A. Mehboudi, S. Singhal, and S.V. Sreenivasan, A universal framework for design and manufacture of deterministic lateral displacement chips. Lab on a Chip 25, 1521-1536 (2025). DOI: 10.1039/D4LC00838C

Pressure Balance

A. Mehboudi, S. Singhal, and S.V. Sreenivasan, Investigation of pressure balance in proximity of sidewalls in deterministic lateral displacement. arXiv:2503.11839v1 [physics.flu-dyn] Mar 2025. DOI: 10.48550/arXiv.2503.11839

Multi-lane boundary (MLB) model optimized through combinatorial approach

A. Mehboudi, S. Singhal, and S.V. Sreenivasan, A Combinatorial Approach to Novel Boundary Design in Deterministic Lateral Displacement. arXiv.2506.06936 [physics.flu-dyn] Jun 2025. DOI: 10.48550/arXiv.2506.06936

Zenodo Archive

A. Mehboudi, mnFlow: A package for micro/nanoflow, Zenodo, 2024. DOI: 10.5281/zenodo.14357811