navier-cfd 0.2.0__tar.gz

navier_cfd-0.2.0/.gitignore

@@ -0,0 +1,17 @@
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.venv/
+venv/
+build/
+dist/
+*.egg-info/
+wandb/
+mlruns/
+outputs/
+checkpoints/
+data/
+.env
+.DS_Store

navier_cfd-0.2.0/LICENSE

@@ -0,0 +1,17 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright 2026 Somyajit Chakraborty
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

navier_cfd-0.2.0/PKG-INFO

@@ -0,0 +1,253 @@
+Metadata-Version: 2.4
+Name: navier-cfd
+Version: 0.2.0
+Summary: CFD-first neural solver registry, Hugging Face data hub, benchmark toolkit, evidence-aware task recommender, and agentic experiment planner.
+Project-URL: Homepage, https://github.com/Samsomyajit/NAVIER-CFD
+Project-URL: Documentation, https://samsomyajit.github.io/NAVIER-CFD/
+Project-URL: Issues, https://github.com/Samsomyajit/NAVIER-CFD/issues
+Author-email: Somyajit Chakraborty <chksomyajit@sjtu.edu.cn>
+License: Apache-2.0
+License-File: LICENSE
+Keywords: CFD,Hugging Face,PDE,PINN,neural operator,scientific machine learning
+Requires-Python: >=3.10
+Requires-Dist: datasets>=2.20
+Requires-Dist: huggingface-hub>=0.24
+Requires-Dist: numpy>=1.24
+Requires-Dist: rich>=13.7
+Requires-Dist: typer>=0.12
+Provides-Extra: all
+Requires-Dist: mkdocs-material>=9.5; extra == 'all'
+Requires-Dist: mypy>=1.10; extra == 'all'
+Requires-Dist: pytest-cov>=5; extra == 'all'
+Requires-Dist: pytest>=8; extra == 'all'
+Requires-Dist: ruff>=0.5; extra == 'all'
+Requires-Dist: torch>=2.1; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.5; extra == 'docs'
+Provides-Extra: torch
+Requires-Dist: torch>=2.1; extra == 'torch'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="docs/assets/navier-cfd-logo.svg" alt="NAVIER-CFD logo" width="860">
+</p>
+
+<h1 align="center">NAVIER-CFD</h1>
+
+<p align="center"><strong>Neural and Agentic Verification, Integration, Evaluation, and Recommendation for Computational Fluid Dynamics</strong></p>
+
+<p align="center">
+  <a href="https://github.com/Samsomyajit/NAVIER-CFD/releases"><img src="https://img.shields.io/badge/version-0.2.0-2f6f9f.svg" alt="Version"></a>
+  <a href="https://pypi.org/project/navier-cfd/"><img src="https://img.shields.io/pypi/v/navier-cfd.svg?label=PyPI" alt="PyPI"></a>
+  <a href="https://pypi.org/project/navier-cfd/"><img src="https://img.shields.io/pypi/pyversions/navier-cfd.svg" alt="Python"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-4c8c6b.svg" alt="Apache 2.0"></a>
+  <a href="https://github.com/Samsomyajit/NAVIER-CFD/actions/workflows/ci.yml"><img src="https://github.com/Samsomyajit/NAVIER-CFD/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://samsomyajit.github.io/NAVIER-CFD/"><img src="https://img.shields.io/badge/project-website-0d6fdc.svg" alt="Project website"></a>
+  <a href="https://samsomyajit.github.io/NAVIER-CFD/recommender/"><img src="https://img.shields.io/badge/tool-recommender-13b7d8.svg" alt="Interactive recommender"></a>
+  <img src="https://img.shields.io/badge/models-55-7c6aa6.svg" alt="55 models">
+  <img src="https://img.shields.io/badge/datasets-11-5d8f72.svg" alt="11 datasets">
+  <img src="https://img.shields.io/badge/scoring-paper--evidence--aware-7057c7.svg" alt="Paper-evidence-aware scoring">
+</p>
+
+NAVIER-CFD is a CFD-first Python platform and project website for neural PDE solvers, hybrid numerical acceleration, benchmark datasets, paper-evidence-aware task recommendation, Hugging Face integration, and agentic experiment planning.
+
+## Project website and interactive tool
+
+- **Project website:** https://samsomyajit.github.io/NAVIER-CFD/
+- **Interactive model and dataset recommender:** https://samsomyajit.github.io/NAVIER-CFD/recommender/
+- **Technical documentation:** https://samsomyajit.github.io/NAVIER-CFD/docs/
+
+The web recommender runs entirely in the browser. It applies hard compatibility filters, explains every score, recommends suitable benchmark datasets, and exports a reproducible run manifest.
+
+> A recommendation is a task-specific hypothesis, not proof that one architecture is universally superior. Report the final score together with evidence confidence, metric coverage, matched paper records, and the target benchmark.
+
+## Evidence-aware recommendation
+
+Version 0.2 introduces a traceable paper-result layer. Each quantitative claim is stored with the paper, benchmark, metric, baseline, physical regime, dimension, mesh, geometry, temporal mode, fidelity, code/data availability, evidence level, and caveats.
+
+The recommender now combines:
+
+1. **Hard compatibility filtering** for dimension, representation, geometry/mesh transfer, numerical role, temporal mode, and hardware.
+2. **Task-to-paper similarity** across physics, discretization, geometry, temporal regime, role, and fidelity.
+3. **Metric-aware utility** that prefers same-pipeline baseline comparisons and refuses to compare scale-dependent absolute MSE values across unrelated datasets.
+4. **Evidence quality weighting** for independent reproduction, peer review, code/data availability, cases, seeds, and baseline quality.
+5. **Bayesian shrinkage** toward a neutral prior when evidence is sparse.
+6. **Confidence and coverage reporting** so a high score with one weak paper cannot masquerade as a mature result.
+
+Citation counts, venue prestige, author prestige, and coauthorship centrality are deliberately excluded from performance scoring. Bibliometrics are used for paper discovery and provenance, not as a proxy for CFD accuracy.
+
+See [Evidence Scoring](docs/EVIDENCE_SCORING.md) and the frozen catalog at `src/navier_cfd/data/paper_evidence.json`.
+
+## Scientific pipeline
+
+<p align="center">
+  <img src="docs/assets/navier_pipeline.svg" alt="NAVIER-CFD scientific pipeline" width="100%">
+</p>
+
+The workflow keeps the learned numerical role explicit—surrogate, closure, corrector, preconditioner, inverse model, controller, or generator—and connects each experiment to versioned data, traceable model cards, CFD-aware metrics, paper evidence, and a reproducible run manifest.
+
+## Why NAVIER-CFD
+
+- **55-model taxonomy:** acceleration frameworks, surrogates, general PDE solvers, specialized CFD, geometry and unstructured-mesh models, foundation models, inverse methods, uncertainty, particle and multiphase models, and generative methods.
+- **11 first-class datasets:** PDEBench, CFDBench, RealPDEBench, AirfRANS, DrivAerNet++, DrivAerML, The Well, APEBench, ScalarFlow, ShapeNet-Car, and EAGLE.
+- **Paper-level evidence:** traceable benchmark claims with task context, provenance, quality, confidence, and comparability limits.
+- **Full Hugging Face support:** discovery, inspection, selective downloads, revision pinning, authentication, streaming, caching, and arbitrary CFD dataset identifiers.
+- **Explainable recommendation:** compatibility filtering plus evidence-aware ranking by physics, dimension, mesh, geometry, temporal regime, numerical role, fidelity, memory, conservation, uncertainty, and transfer requirements.
+- **Agentic AI:** deterministic offline planning and provider-neutral interfaces for external LLM agents.
+- **CFD-aware benchmarking:** field, spectral, rollout, conservation, OOD, quantity-of-interest, uncertainty, wall-clock, memory, and break-even metrics.
+- **Safe integration:** external repositories remain metadata-first and are never executed automatically.
+
+## Installation
+
+From PyPI:
+
+```bash
+pip install navier-cfd
+```
+
+From source:
+
+```bash
+git clone https://github.com/Samsomyajit/NAVIER-CFD.git
+cd NAVIER-CFD
+pip install -e .
+
+# development, tests, and documentation
+pip install -e ".[dev,docs]"
+```
+
+## Quick start
+
+```bash
+# Explore catalogs
+navier models list
+navier models list --category acceleration
+navier datasets list
+
+# Inspect registered paper evidence
+navier evidence list
+navier evidence list --model-id gino
+navier evidence coverage
+
+# Search Hugging Face
+navier datasets discover "computational fluid dynamics" --limit 20
+
+# Download a CFDBench subset
+navier datasets download cfdbench \
+  --local-dir ./data/cfdbench \
+  --pattern "cylinder/**"
+
+# Evidence-aware recommendation
+navier recommend \
+  --problem vehicle_drag \
+  --task surrogate \
+  --dimension 3 \
+  --mesh point_cloud \
+  --temporal steady \
+  --geometry varying \
+  --physics aerodynamics \
+  --fidelity rans \
+  --memory-gb 80 \
+  --top-k 10
+
+# Generate an agentic experiment plan
+navier agent plan \
+  "Benchmark RealPDEBench cylinder sim-to-real forecasting with 24 GB VRAM, conservation and uncertainty"
+```
+
+## Python API
+
+```python
+from navier_cfd import Catalog, TaskSpec, recommend_models
+
+catalog = Catalog.load_builtin()
+task = TaskSpec(
+    problem="3d_vehicle_aerodynamics",
+    task_type="surrogate",
+    dimension=3,
+    mesh_type="point_cloud",
+    temporal_mode="steady",
+    geometry_mode="varying",
+    physics=("aerodynamics",),
+    fidelity="rans",
+    requires_geometry_transfer=True,
+    requires_mesh_transfer=True,
+    hardware_memory_gb=80,
+)
+
+for result in recommend_models(task, catalog.models, top_k=8):
+    print(result.model.name, result.score)
+    print("evidence:", result.evidence_score)
+    print("confidence:", result.evidence_confidence)
+    print("coverage:", result.evidence_coverage)
+    print("records:", result.evidence_count)
+    print("reasons:", result.reasons)
+    print("cautions:", result.cautions)
+```
+
+## Registered model families
+
+- **Physics-informed:** PINN, NSFnets, PINNsFormer, PINO, PI-MFM, and RiemannONet.
+- **Operator learning:** DeepONet, MIONet, Fourier-DeepONet, Fourier-MIONet, FNO, F-FNO, U-FNO, U-NO, LSM, MWT, Laplace NO, and state-space NO.
+- **Geometry and transformer solvers:** Geo-FNO, GINO, GNOT, Transolver, UPT, MeshGraphNets, DoMINO, and ReViT.
+- **CFD-specialized:** PIBERT, FourierFlow, P3D, AeroTransformer, NeuralDEM, DeepM&Mnet, and Energy Transformer.
+- **Foundation and generative:** DPOT, Poseidon, PROSE-FD, BCAT, PDEformer-1, Tadpole, PDE-Refiner, FunDiff, and Flow Matching for PDEs.
+- **Acceleration:** Solver-in-the-Loop, INC, PICT, diffSPH, NeuroSEM, neural-operator preconditioned Newton, and geometry-aware neural preconditioning.
+- **Uncertainty and adaptation:** Conformalized-DeepONet and TANTE.
+
+“Included” means represented through a uniform model card and recommendation interface. Official implementations remain external so upstream licenses and revisions are respected.
+
+## Repository map
+
+```text
+src/navier_cfd/
+  agents/          deterministic and LLM-ready planning
+  benchmarks/      CFD metrics and benchmark plans
+  datasets/        Hugging Face discovery, download, streaming
+  models/          safe adapter protocol
+  data/            frozen paper-evidence catalog
+  catalogs.py      model and dataset registries
+  evidence.py      task similarity, quality, utility, shrinkage
+  recommender.py   compatibility prior + evidence ranking
+
+website/
+  index.html       standalone project website
+  recommender/     interactive browser recommender
+  data/            static model and dataset catalogs
+
+docs/              MkDocs technical documentation
+case_studies/      detailed benchmark study guides
+configs/tasks/     reusable task specifications
+```
+
+## Recommender validation
+
+The Python recommender is covered by `pytest`; the browser engine is covered by Node's built-in test runner.
+
+```bash
+pytest tests/test_recommender.py tests/test_evidence_recommender.py
+node --test website/recommender/recommender-core.test.mjs
+```
+
+Canonical tests verify task-specific evidence transfer, geometry-aware 3D ranking, hybrid acceleration selection, evidence provenance, and neutral treatment of incomparable absolute MSE values.
+
+## Packaging and deployment
+
+- Package: `navier-cfd`
+- Import namespace: `navier_cfd`
+- Current version: `0.2.0`
+- Evidence algorithm: `0.2.0-evidence`
+- Build backend: Hatchling
+- Website source: `website/`
+- Documentation source: `docs/`
+- Branch publisher: `.github/workflows/pages-branch.yml`
+- PyPI Trusted Publishing workflow: `.github/workflows/publish-pypi.yml`
+
+## License
+
+Licensed under the [Apache License 2.0](LICENSE). Cite NAVIER-CFD and the original model, dataset, upstream implementation, benchmark, and numerical-solver references used in every experiment.

navier_cfd-0.2.0/README.md

@@ -0,0 +1,218 @@
+<p align="center">
+  <img src="docs/assets/navier-cfd-logo.svg" alt="NAVIER-CFD logo" width="860">
+</p>
+
+<h1 align="center">NAVIER-CFD</h1>
+
+<p align="center"><strong>Neural and Agentic Verification, Integration, Evaluation, and Recommendation for Computational Fluid Dynamics</strong></p>
+
+<p align="center">
+  <a href="https://github.com/Samsomyajit/NAVIER-CFD/releases"><img src="https://img.shields.io/badge/version-0.2.0-2f6f9f.svg" alt="Version"></a>
+  <a href="https://pypi.org/project/navier-cfd/"><img src="https://img.shields.io/pypi/v/navier-cfd.svg?label=PyPI" alt="PyPI"></a>
+  <a href="https://pypi.org/project/navier-cfd/"><img src="https://img.shields.io/pypi/pyversions/navier-cfd.svg" alt="Python"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-4c8c6b.svg" alt="Apache 2.0"></a>
+  <a href="https://github.com/Samsomyajit/NAVIER-CFD/actions/workflows/ci.yml"><img src="https://github.com/Samsomyajit/NAVIER-CFD/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://samsomyajit.github.io/NAVIER-CFD/"><img src="https://img.shields.io/badge/project-website-0d6fdc.svg" alt="Project website"></a>
+  <a href="https://samsomyajit.github.io/NAVIER-CFD/recommender/"><img src="https://img.shields.io/badge/tool-recommender-13b7d8.svg" alt="Interactive recommender"></a>
+  <img src="https://img.shields.io/badge/models-55-7c6aa6.svg" alt="55 models">
+  <img src="https://img.shields.io/badge/datasets-11-5d8f72.svg" alt="11 datasets">
+  <img src="https://img.shields.io/badge/scoring-paper--evidence--aware-7057c7.svg" alt="Paper-evidence-aware scoring">
+</p>
+
+NAVIER-CFD is a CFD-first Python platform and project website for neural PDE solvers, hybrid numerical acceleration, benchmark datasets, paper-evidence-aware task recommendation, Hugging Face integration, and agentic experiment planning.
+
+## Project website and interactive tool
+
+- **Project website:** https://samsomyajit.github.io/NAVIER-CFD/
+- **Interactive model and dataset recommender:** https://samsomyajit.github.io/NAVIER-CFD/recommender/
+- **Technical documentation:** https://samsomyajit.github.io/NAVIER-CFD/docs/
+
+The web recommender runs entirely in the browser. It applies hard compatibility filters, explains every score, recommends suitable benchmark datasets, and exports a reproducible run manifest.
+
+> A recommendation is a task-specific hypothesis, not proof that one architecture is universally superior. Report the final score together with evidence confidence, metric coverage, matched paper records, and the target benchmark.
+
+## Evidence-aware recommendation
+
+Version 0.2 introduces a traceable paper-result layer. Each quantitative claim is stored with the paper, benchmark, metric, baseline, physical regime, dimension, mesh, geometry, temporal mode, fidelity, code/data availability, evidence level, and caveats.
+
+The recommender now combines:
+
+1. **Hard compatibility filtering** for dimension, representation, geometry/mesh transfer, numerical role, temporal mode, and hardware.
+2. **Task-to-paper similarity** across physics, discretization, geometry, temporal regime, role, and fidelity.
+3. **Metric-aware utility** that prefers same-pipeline baseline comparisons and refuses to compare scale-dependent absolute MSE values across unrelated datasets.
+4. **Evidence quality weighting** for independent reproduction, peer review, code/data availability, cases, seeds, and baseline quality.
+5. **Bayesian shrinkage** toward a neutral prior when evidence is sparse.
+6. **Confidence and coverage reporting** so a high score with one weak paper cannot masquerade as a mature result.
+
+Citation counts, venue prestige, author prestige, and coauthorship centrality are deliberately excluded from performance scoring. Bibliometrics are used for paper discovery and provenance, not as a proxy for CFD accuracy.
+
+See [Evidence Scoring](docs/EVIDENCE_SCORING.md) and the frozen catalog at `src/navier_cfd/data/paper_evidence.json`.
+
+## Scientific pipeline
+
+<p align="center">
+  <img src="docs/assets/navier_pipeline.svg" alt="NAVIER-CFD scientific pipeline" width="100%">
+</p>
+
+The workflow keeps the learned numerical role explicit—surrogate, closure, corrector, preconditioner, inverse model, controller, or generator—and connects each experiment to versioned data, traceable model cards, CFD-aware metrics, paper evidence, and a reproducible run manifest.
+
+## Why NAVIER-CFD
+
+- **55-model taxonomy:** acceleration frameworks, surrogates, general PDE solvers, specialized CFD, geometry and unstructured-mesh models, foundation models, inverse methods, uncertainty, particle and multiphase models, and generative methods.
+- **11 first-class datasets:** PDEBench, CFDBench, RealPDEBench, AirfRANS, DrivAerNet++, DrivAerML, The Well, APEBench, ScalarFlow, ShapeNet-Car, and EAGLE.
+- **Paper-level evidence:** traceable benchmark claims with task context, provenance, quality, confidence, and comparability limits.
+- **Full Hugging Face support:** discovery, inspection, selective downloads, revision pinning, authentication, streaming, caching, and arbitrary CFD dataset identifiers.
+- **Explainable recommendation:** compatibility filtering plus evidence-aware ranking by physics, dimension, mesh, geometry, temporal regime, numerical role, fidelity, memory, conservation, uncertainty, and transfer requirements.
+- **Agentic AI:** deterministic offline planning and provider-neutral interfaces for external LLM agents.
+- **CFD-aware benchmarking:** field, spectral, rollout, conservation, OOD, quantity-of-interest, uncertainty, wall-clock, memory, and break-even metrics.
+- **Safe integration:** external repositories remain metadata-first and are never executed automatically.
+
+## Installation
+
+From PyPI:
+
+```bash
+pip install navier-cfd
+```
+
+From source:
+
+```bash
+git clone https://github.com/Samsomyajit/NAVIER-CFD.git
+cd NAVIER-CFD
+pip install -e .
+
+# development, tests, and documentation
+pip install -e ".[dev,docs]"
+```
+
+## Quick start
+
+```bash
+# Explore catalogs
+navier models list
+navier models list --category acceleration
+navier datasets list
+
+# Inspect registered paper evidence
+navier evidence list
+navier evidence list --model-id gino
+navier evidence coverage
+
+# Search Hugging Face
+navier datasets discover "computational fluid dynamics" --limit 20
+
+# Download a CFDBench subset
+navier datasets download cfdbench \
+  --local-dir ./data/cfdbench \
+  --pattern "cylinder/**"
+
+# Evidence-aware recommendation
+navier recommend \
+  --problem vehicle_drag \
+  --task surrogate \
+  --dimension 3 \
+  --mesh point_cloud \
+  --temporal steady \
+  --geometry varying \
+  --physics aerodynamics \
+  --fidelity rans \
+  --memory-gb 80 \
+  --top-k 10
+
+# Generate an agentic experiment plan
+navier agent plan \
+  "Benchmark RealPDEBench cylinder sim-to-real forecasting with 24 GB VRAM, conservation and uncertainty"
+```
+
+## Python API
+
+```python
+from navier_cfd import Catalog, TaskSpec, recommend_models
+
+catalog = Catalog.load_builtin()
+task = TaskSpec(
+    problem="3d_vehicle_aerodynamics",
+    task_type="surrogate",
+    dimension=3,
+    mesh_type="point_cloud",
+    temporal_mode="steady",
+    geometry_mode="varying",
+    physics=("aerodynamics",),
+    fidelity="rans",
+    requires_geometry_transfer=True,
+    requires_mesh_transfer=True,
+    hardware_memory_gb=80,
+)
+
+for result in recommend_models(task, catalog.models, top_k=8):
+    print(result.model.name, result.score)
+    print("evidence:", result.evidence_score)
+    print("confidence:", result.evidence_confidence)
+    print("coverage:", result.evidence_coverage)
+    print("records:", result.evidence_count)
+    print("reasons:", result.reasons)
+    print("cautions:", result.cautions)
+```
+
+## Registered model families
+
+- **Physics-informed:** PINN, NSFnets, PINNsFormer, PINO, PI-MFM, and RiemannONet.
+- **Operator learning:** DeepONet, MIONet, Fourier-DeepONet, Fourier-MIONet, FNO, F-FNO, U-FNO, U-NO, LSM, MWT, Laplace NO, and state-space NO.
+- **Geometry and transformer solvers:** Geo-FNO, GINO, GNOT, Transolver, UPT, MeshGraphNets, DoMINO, and ReViT.
+- **CFD-specialized:** PIBERT, FourierFlow, P3D, AeroTransformer, NeuralDEM, DeepM&Mnet, and Energy Transformer.
+- **Foundation and generative:** DPOT, Poseidon, PROSE-FD, BCAT, PDEformer-1, Tadpole, PDE-Refiner, FunDiff, and Flow Matching for PDEs.
+- **Acceleration:** Solver-in-the-Loop, INC, PICT, diffSPH, NeuroSEM, neural-operator preconditioned Newton, and geometry-aware neural preconditioning.
+- **Uncertainty and adaptation:** Conformalized-DeepONet and TANTE.
+
+“Included” means represented through a uniform model card and recommendation interface. Official implementations remain external so upstream licenses and revisions are respected.
+
+## Repository map
+
+```text
+src/navier_cfd/
+  agents/          deterministic and LLM-ready planning
+  benchmarks/      CFD metrics and benchmark plans
+  datasets/        Hugging Face discovery, download, streaming
+  models/          safe adapter protocol
+  data/            frozen paper-evidence catalog
+  catalogs.py      model and dataset registries
+  evidence.py      task similarity, quality, utility, shrinkage
+  recommender.py   compatibility prior + evidence ranking
+
+website/
+  index.html       standalone project website
+  recommender/     interactive browser recommender
+  data/            static model and dataset catalogs
+
+docs/              MkDocs technical documentation
+case_studies/      detailed benchmark study guides
+configs/tasks/     reusable task specifications
+```
+
+## Recommender validation
+
+The Python recommender is covered by `pytest`; the browser engine is covered by Node's built-in test runner.
+
+```bash
+pytest tests/test_recommender.py tests/test_evidence_recommender.py
+node --test website/recommender/recommender-core.test.mjs
+```
+
+Canonical tests verify task-specific evidence transfer, geometry-aware 3D ranking, hybrid acceleration selection, evidence provenance, and neutral treatment of incomparable absolute MSE values.
+
+## Packaging and deployment
+
+- Package: `navier-cfd`
+- Import namespace: `navier_cfd`
+- Current version: `0.2.0`
+- Evidence algorithm: `0.2.0-evidence`
+- Build backend: Hatchling
+- Website source: `website/`
+- Documentation source: `docs/`
+- Branch publisher: `.github/workflows/pages-branch.yml`
+- PyPI Trusted Publishing workflow: `.github/workflows/publish-pypi.yml`
+
+## License
+
+Licensed under the [Apache License 2.0](LICENSE). Cite NAVIER-CFD and the original model, dataset, upstream implementation, benchmark, and numerical-solver references used in every experiment.

navier_cfd-0.2.0/pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[project]
+name = "navier-cfd"
+version = "0.2.0"
+description = "CFD-first neural solver registry, Hugging Face data hub, benchmark toolkit, evidence-aware task recommender, and agentic experiment planner."
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "Apache-2.0"}
+authors = [
+  {name = "Somyajit Chakraborty", email = "chksomyajit@sjtu.edu.cn"},
+]
+keywords = ["CFD", "scientific machine learning", "neural operator", "PINN", "PDE", "Hugging Face"]
+dependencies = [
+  "numpy>=1.24",
+  "typer>=0.12",
+  "rich>=13.7",
+  "huggingface_hub>=0.24",
+  "datasets>=2.20",
+]
+
+[project.optional-dependencies]
+torch = ["torch>=2.1"]
+dev = ["pytest>=8", "pytest-cov>=5", "ruff>=0.5", "mypy>=1.10"]
+docs = ["mkdocs-material>=9.5"]
+all = ["torch>=2.1", "pytest>=8", "pytest-cov>=5", "ruff>=0.5", "mypy>=1.10", "mkdocs-material>=9.5"]
+
+[project.scripts]
+navier = "navier_cfd.cli:app"
+cfdns = "navier_cfd.cli:app"
+
+[project.urls]
+Homepage = "https://github.com/Samsomyajit/NAVIER-CFD"
+Documentation = "https://samsomyajit.github.io/NAVIER-CFD/"
+Issues = "https://github.com/Samsomyajit/NAVIER-CFD/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/navier_cfd"]
+
+[tool.hatch.build]
+include = ["src/navier_cfd/**/*.py", "src/navier_cfd/**/*.json"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+addopts = "-q"
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_configs = true

navier_cfd-0.2.0/src/navier_cfd/__init__.py

@@ -0,0 +1,30 @@
+"""NAVIER-CFD public API: neural and agentic workflows for computational fluid dynamics."""
+
+from .catalogs import Catalog
+from .evidence import (
+    ALGORITHM_VERSION,
+    EvidenceMatch,
+    EvidenceRecord,
+    EvidenceSummary,
+    load_builtin_evidence,
+    score_model_evidence,
+)
+from .recommender import Recommendation, recommend_models
+from .specs import DatasetSpec, ModelSpec, TaskSpec
+
+__all__ = [
+    "ALGORITHM_VERSION",
+    "Catalog",
+    "DatasetSpec",
+    "EvidenceMatch",
+    "EvidenceRecord",
+    "EvidenceSummary",
+    "ModelSpec",
+    "Recommendation",
+    "TaskSpec",
+    "load_builtin_evidence",
+    "recommend_models",
+    "score_model_evidence",
+]
+
+__version__ = "0.2.0"

navier_cfd-0.2.0/src/navier_cfd/__main__.py

@@ -0,0 +1,3 @@
+from .cli import app
+
+app()

navier_cfd-0.2.0/src/navier_cfd/agents/__init__.py

@@ -0,0 +1,3 @@
+from .orchestrator import AgentOrchestrator, AgentPlan
+
+__all__ = ["AgentOrchestrator", "AgentPlan"]