ChannelFlow-Tools: A Configuration-Driven Pipeline for Generating Machine-Learning-Ready Datasets of 3D Obstructed Channel Flows

Abstract:Data-driven surrogate models are increasingly used in computational fluid dynamics, and their reliability depends on the quality of the training data. These models are typically trained on fixed, pre-generated datasets. Systematic surrogate studies require controlled data generation, in which datasets can be regenerated, adapted, or extended to match specific research requirements. We introduce ChannelFlow-Tools, an open-source, configuration-driven pipeline for generating ML-ready datasets of three-dimensional obstructed channel flows. The pipeline integrates procedural obstacle geometry generation across six shape families, signed-distance-field (SDF) voxelisation, lattice-Boltzmann simulation, and packaging into ML-ready tensors. The workflow is driven by configuration files, with byte-identical reproducibility verified for the geometry-generation stage. The pipeline is evaluated through a full-corpus mesh-integrity audit, analytical and corpus-level validation of the SDF representation, canonical sphere-flow benchmarks for the solver, and a per-scene data-integrity audit. To demonstrate that the pipeline produces physically consistent and directly usable training data, three surrogate models (3D U-Net, FNO, and U-FNO) are trained on a sample dataset of 450 simulations spanning $Re_c \approx 1000$-$10{,}000$, generated entirely through the pipeline. The models learn the geometry-to-flow mapping and show physically interpretable behaviour on shape-family and Reynolds-number out-of-distribution splits, confirming direct downstream usability. ChannelFlow-Tools thus provides shared, auditable infrastructure for controlled benchmarking of geometry-aware CFD surrogates.

Graphics (cs.GR); Artificial Intelligence (cs.AI)

arXiv:2509.15236 [cs.GR]

(or arXiv:2509.15236v2 [cs.GR] for this version)

https://doi.org/10.48550/arXiv.2509.15236 Focus to learn more arXiv-issued DOI via DataCite

arXivLabs is a framework that allows collaborators to develop and share new arXiv features directly on our website.

Both individuals and organizations that work with arXivLabs have embraced and accepted our values of openness, community, excellence, and user data privacy. arXiv is committed to these values and only works with partners that adhere to them.

Have an idea for a project that will add value for arXiv's community? Learn more about arXivLabs.