peclet-cu13 0.7.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: peclet-cu13
|
|
3
|
+
Version: 0.7.0
|
|
4
|
+
Summary: GPU-accelerated & parallel simulation of transport phenomena (CFD, DEM, Voronoi) — single-GPU CUDA family metapackage
|
|
5
|
+
Project-URL: Homepage, https://github.com/computational-chemical-engineering/peclet
|
|
6
|
+
Project-URL: Documentation, https://github.com/computational-chemical-engineering/peclet
|
|
7
|
+
Author-email: Frank Peters <e.a.j.f.peters@gmail.com>
|
|
8
|
+
License-Expression: MIT
|
|
9
|
+
License-File: LICENSE
|
|
10
|
+
Requires-Python: >=3.10
|
|
11
|
+
Requires-Dist: peclet-dem-cu13==0.5.0
|
|
12
|
+
Requires-Dist: peclet-flow-cu13==0.5.0
|
|
13
|
+
Requires-Dist: peclet-morton==0.2.1
|
|
14
|
+
Requires-Dist: peclet-pnm-cu13==0.1.1
|
|
15
|
+
Requires-Dist: peclet-voro-cu13==0.5.0
|
|
16
|
+
Provides-Extra: cfd-dem
|
|
17
|
+
Requires-Dist: peclet-coupling==0.4.0; extra == 'cfd-dem'
|
|
18
|
+
Provides-Extra: mpi
|
|
19
|
+
Requires-Dist: peclet-core==0.6.0; extra == 'mpi'
|
|
20
|
+
Description-Content-Type: text/markdown
|
|
21
|
+
|
|
22
|
+
# Peclet
|
|
23
|
+
|
|
24
|
+
[](https://pypi.org/project/peclet/)
|
|
25
|
+
[](https://pypi.org/project/peclet/)
|
|
26
|
+
[](LICENSE)
|
|
27
|
+
[](https://computational-chemical-engineering.github.io/peclet/)
|
|
28
|
+
[](https://github.com/computational-chemical-engineering/peclet/actions/workflows/site.yml)
|
|
29
|
+
[](https://doi.org/10.5281/zenodo.21132445)
|
|
30
|
+
|
|
31
|
+
A suite of codes for **simulation of transport phenomena** — Eulerian (CFD/Navier–Stokes), Lagrangian
|
|
32
|
+
(DEM/particle packing) and mixed (Voronoi) methods — sharing one MPI **block domain decomposition**
|
|
33
|
+
with efficient **asynchronous ghost-layer exchange**, **SDF**-described solids, a common **immersed
|
|
34
|
+
boundary** methodology, **GPU** support, and **Python bindings**.
|
|
35
|
+
|
|
36
|
+
The name nods to the [Péclet number](https://en.wikipedia.org/wiki/P%C3%A9clet_number) — the ratio of
|
|
37
|
+
advective to diffusive transport, the dimensionless heart of transport phenomena.
|
|
38
|
+
|
|
39
|
+
📖 **Documentation site:** <https://computational-chemical-engineering.github.io/peclet/> — the suite's front
|
|
40
|
+
door (Python API reference, install/deployment guide, design docs, links to each code's Doxygen API).
|
|
41
|
+
Built from `docs/` via MkDocs ([mkdocs.yml](mkdocs.yml)).
|
|
42
|
+
|
|
43
|
+
🧪 **Examples gallery:** <https://computational-chemical-engineering.github.io/peclet-examples/> — runnable,
|
|
44
|
+
validated notebooks (single-phase and two-phase flow, packings, DEM, CFD-DEM, scaling benchmarks), each
|
|
45
|
+
with an *Open in Colab* button.
|
|
46
|
+
|
|
47
|
+
This is an **umbrella repository**: each code is a git **submodule** (its own repo and history); this
|
|
48
|
+
repo pins compatible commits and holds the shared design docs.
|
|
49
|
+
|
|
50
|
+
## Clone
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
git clone --recursive git@github.com:computational-chemical-engineering/peclet.git
|
|
54
|
+
# or, after a plain clone:
|
|
55
|
+
git submodule update --init --recursive
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
## Layout
|
|
59
|
+
|
|
60
|
+
| Submodule | Role |
|
|
61
|
+
|-----------|------|
|
|
62
|
+
| `core/` | **Shared infrastructure** (header-only C++20 + MPI, optional Kokkos): ORB block decomposition, async grid ghost-layer exchange + Lagrangian particle migration/ghosts, SDF geometry, VTI I/O. Every method depends on it. |
|
|
63
|
+
| `flow/` | Eulerian **Kokkos** incompressible Navier–Stokes (porous media; staggered MAC grid + cut-cell IBM). Complete, validated, MPI-optional distributed solver on `core`. |
|
|
64
|
+
| `pnm/` | **Kokkos** pore-network extraction from SDF geometry (pores, watershed segmentation, throat topology). Split out of `flow`. |
|
|
65
|
+
| `dem/` | Lagrangian **Kokkos + ArborX** DEM/XPBD particle packing. Full XPBD step with a validated distributed `step_mpi` (core particle halo). |
|
|
66
|
+
| `voro/` | Mixed Lagrangian/Eulerian dynamic 3D Voronoi tessellation (**Kokkos** device tessellator; periodic & Lees–Edwards), mesh generator and Navier–Stokes on the Voronoi mesh. |
|
|
67
|
+
| `coupling/` | **CFD-DEM coupling** of `flow` + `dem` (Kokkos kernels + Python drivers): unresolved volume-averaged drag and resolved cut-cell coupling. |
|
|
68
|
+
| `morton/` | Morton/Z-order spatial-index primitive — arithmetic directly in Morton space (header-only C++17 + BMI2/AVX-512, Python). |
|
|
69
|
+
|
|
70
|
+
The compute codes are **Kokkos**-based; the same source runs on CUDA, HIP (AMD/LUMI), and OpenMP backends,
|
|
71
|
+
chosen by the bootstrapped install prefix (`tools/bootstrap_deps.sh`). The reusable parts of the original
|
|
72
|
+
`block_decomposer` prototype were extracted into `core/`.
|
|
73
|
+
|
|
74
|
+
## Shared design docs
|
|
75
|
+
|
|
76
|
+
`docs/` is the cross-code contract every method follows:
|
|
77
|
+
[ARCHITECTURE](docs/ARCHITECTURE.md) · [CONVENTIONS](docs/CONVENTIONS.md) · [STYLE](docs/STYLE.md) ·
|
|
78
|
+
[INTERFACES](docs/INTERFACES.md) · [ROADMAP](docs/ROADMAP.md) ·
|
|
79
|
+
[PORTABILITY](docs/PORTABILITY.md). See `CLAUDE.md` for an agent-facing overview.
|
|
80
|
+
|
|
81
|
+
## Install & run (Python)
|
|
82
|
+
|
|
83
|
+
Everything ships under one **`peclet` namespace** — installable parts of one family:
|
|
84
|
+
|
|
85
|
+
| PyPI package | Import | Role |
|
|
86
|
+
|---|---|---|
|
|
87
|
+
| `peclet-morton` | `peclet.morton` | Morton/Z-order spatial index |
|
|
88
|
+
| `peclet-flow` | `peclet.flow` | Eulerian incompressible Navier–Stokes solver |
|
|
89
|
+
| `peclet-pnm` | `peclet.pnm` | Pore-network extraction from SDF geometry |
|
|
90
|
+
| `peclet-dem` | `peclet.dem` | Lagrangian DEM/XPBD particle packing |
|
|
91
|
+
| `peclet-voro` | `peclet.voro` | Dynamic Voronoi tessellation + mesh generator |
|
|
92
|
+
| `peclet-coupling` | `peclet.coupling` | CFD-DEM coupling drivers over flow + dem — sdist only (`peclet[cfd-dem]`) |
|
|
93
|
+
| `peclet-core` | `peclet.core` (`.mpi`, `.amr`, `.geom`) | Shared infra (particle halo, AMR, analytic-SDF scenes) — sdist only (`peclet[mpi]`) |
|
|
94
|
+
| `peclet` | — | metapackage: `pip install peclet` pulls the CPU family |
|
|
95
|
+
| `peclet-cu13` | — | metapackage: `pip install peclet-cu13` pulls the CUDA family (`peclet-{flow,pnm,dem,voro}-cu13`) |
|
|
96
|
+
|
|
97
|
+
**Multicore CPU (OpenMP):** the compute packages ship **self-contained wheels** — `pip install peclet`
|
|
98
|
+
(or an individual `pip install peclet-flow`) just works and runs multi-threaded (`OMP_NUM_THREADS`).
|
|
99
|
+
|
|
100
|
+
**Single NVIDIA GPU:** `pip install peclet-cu13` — CUDA wheels of the same family (only the NVIDIA driver is
|
|
101
|
+
needed; not alongside `peclet` in one venv).
|
|
102
|
+
|
|
103
|
+
**AMD/HIP and multi-rank MPI:** a wheel cannot carry an MPI ABI, so you build the packages from source
|
|
104
|
+
against a Kokkos prefix, or use a container. Because the backend (Serial / OpenMP / CUDA / HIP) is compiled
|
|
105
|
+
in, you build for your hardware — [**docs/DEPLOYMENT.md**](docs/DEPLOYMENT.md) is the guide: the backend×MPI
|
|
106
|
+
matrix, `pip install` recipes per environment, the Snellius site install (`tools/hpc/`), and the
|
|
107
|
+
**Apptainer containers** (GHCR, built by CI on every release) for Snellius (CUDA) and LUMI (HIP) in
|
|
108
|
+
[`containers/`](containers).
|
|
109
|
+
|
|
110
|
+
## Continuous integration & docs
|
|
111
|
+
|
|
112
|
+
Each submodule carries its own `.github/workflows/`: a **CI** workflow (build + test — `core` and `morton`
|
|
113
|
+
run full CPU/MPI suites; the Kokkos codes build the OpenMP host backend and run their single-rank suites),
|
|
114
|
+
a **Documentation** workflow that builds the Doxygen API docs and publishes them to that repo's GitHub
|
|
115
|
+
Pages, and a **Release** workflow that builds the sdist + CPU wheels (+ the CUDA wheel) and publishes them
|
|
116
|
+
to PyPI on a version tag. The umbrella adds the documentation site (`site.yml`), the metapackages
|
|
117
|
+
(`release.yml`) and the containers (`containers.yml`). The whole procedure is written down in
|
|
118
|
+
[docs/RELEASE.md](docs/RELEASE.md).
|
|
119
|
+
|
|
120
|
+
## Contributing & community
|
|
121
|
+
|
|
122
|
+
Contributions are welcome — see **[CONTRIBUTING.md](CONTRIBUTING.md)** for the submodule dev setup,
|
|
123
|
+
build/test, and PR flow. Participation is governed by the [Contributor Covenant](CODE_OF_CONDUCT.md).
|
|
124
|
+
Report security issues privately per the [Security Policy](SECURITY.md). Release history lives in the
|
|
125
|
+
[CHANGELOG](CHANGELOG.md).
|
|
126
|
+
|
|
127
|
+
## Citing
|
|
128
|
+
|
|
129
|
+
If you use Peclet in your research, please cite it. Each release is archived on Zenodo:
|
|
130
|
+
|
|
131
|
+
[](https://doi.org/10.5281/zenodo.21132445)
|
|
132
|
+
|
|
133
|
+
- **All versions (concept DOI):** [10.5281/zenodo.21132445](https://doi.org/10.5281/zenodo.21132445) — always resolves to the latest release; use this unless you need to pin an exact version.
|
|
134
|
+
- **A specific version:** the Zenodo record lists a version DOI per release, and each [GitHub release](https://github.com/computational-chemical-engineering/peclet/releases) links to its own.
|
|
135
|
+
|
|
136
|
+
Machine-readable metadata is in [CITATION.cff](CITATION.cff) — use GitHub's "Cite this repository"
|
|
137
|
+
button for ready-made BibTeX/APA.
|
|
138
|
+
|
|
139
|
+
## Note on submodule pins
|
|
140
|
+
|
|
141
|
+
This umbrella pins each submodule to a compatible commit on `main`. Update to the latest upstream with
|
|
142
|
+
`git submodule update --remote` followed by a commit here that bumps the pointers.
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
peclet_cu13-0.7.0.dist-info/METADATA,sha256=_xsPFnefXUXbb0og9pBXViHf4S8BINFCTGGio4C1rI0,8779
|
|
2
|
+
peclet_cu13-0.7.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
|
|
3
|
+
peclet_cu13-0.7.0.dist-info/licenses/LICENSE,sha256=y1lAzZEZuBZvgvSMwte2O-Of5uGi9PGpeNTCHMMxTvU,1069
|
|
4
|
+
peclet_cu13-0.7.0.dist-info/RECORD,,
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Frank Peters
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|