Skip to content

barrosyan/PINNeAPPle

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

102 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

PINNeAPPle ๐Ÿ

Your Physics AI Laboratory โ€” from first principles to real-world systems

Experiment. Learn. Build. Then scale โ€” anywhere.

PINNeAPPle is an open-source Physics AI research and experimentation platform designed to take you from your first physics-informed neural network all the way to robust, production-ready solutions โ€” independent of any specific framework, vendor, or ecosystem.

Clamped Plate 2D Heat Equation
Clamped Plate โ€” deflection, Von Mises stress & bending moment 2D Heat Equation โ€” Exact vs PINN across time steps
Lamb-Oseen Vortex Allen-Cahn Phase
Lamb-Oseen Vortex Pair โ€” vorticity evolution Allen-Cahn Phase Separation โ€” interface dynamics

๐Ÿš€ Why PINNeAPPle?

Modern Physics AI ecosystems are powerful โ€” but they assume you already understand:

  • How to formulate physical problems correctly
  • Which architectures to use (PINNs, operators, surrogatesโ€ฆ)
  • How to validate physics consistency
  • How to benchmark and trust your results

PINNeAPPle is where you build that foundation.

Think of it as your experimentation layer:

Your physics problem
        โ†“
  [ PINNeAPPle ]   โ† experiment freely here
    Understand the physics
    Try architectures
    Compare approaches
    Validate results
    Build intuition
        โ†“
[ Your Target Stack ]
  (custom infra, HPC, cloud, internal platform, etc.)
  Scale, deploy, integrate

๐Ÿง  Three Tiers of Physics AI Experience

๐ŸŒฑ Tier 1 โ€” Explorer

"I understand the physics. I want to see what AI can do with it."

from pinneaple_environment import BurgersPreset

problem = BurgersPreset(nu=0.01)
model   = problem.build_model()
trainer = problem.build_trainer(n_epochs=3000)
result  = trainer.fit(model)
result.plot()

๐Ÿ”ฌ Tier 2 โ€” Experimenter

"I want to test ideas and compare approaches."

from pinneaple_arena import ArenaRunner

runner  = ArenaRunner.from_yaml("configs/arena/burgers_benchmark.yaml")
results = runner.run_all()
results.leaderboard()

Potential Flow Past Cylinder Potential Flow Past Circular Cylinder โ€” exact solution vs PINN vs pointwise error


๐Ÿš€ Tier 3 โ€” Builder

"I want to turn this into a real system."

from pinneaple_train.distributed import DDPPINNTrainer
from pinneaple_export.onnx_exporter import ONNXExporter

Model Comparison Multi-model forecast comparison across test windows โ€” Naive, FFT-only, LSTM, FFT+LSTM


๐ŸŒ The Bridge to Any Physics AI Stack

PINNeAPPle is stack-agnostic.

It helps you:

  1. Validate physics and modeling
  2. Benchmark architectures
  3. Export models
  4. Integrate with:
    • HPC clusters
    • Cloud ML pipelines
    • Simulation frameworks
    • Internal platforms
    • Digital twins

๐Ÿ”ฅ Key Features

Module Description
๐Ÿ“ฆ Unified Physical Data (UPD) State, geometry, equations, metadata
๐ŸŒ Data Pipeline Zarr datasets, active learning
๐Ÿ“ Geometry & Mesh CAD, meshing, simulation interoperability
๐Ÿง  Model Zoo PINNs, Neural Operators, GNNs, Transformers, ROM, Classical
๐Ÿงฎ Physics Loss Factory Symbolic PDE โ†’ residuals
โš™๏ธ Solvers FEM, FDM, FVM, Spectral, SPH, LBM
๐Ÿ—๏ธ Training Distributed, AMP, deterministic
๐Ÿ“Š Uncertainty & Validation Dropout, ensembles, conservation checks
๐Ÿ” Transfer & Meta-Learning Fine-tuning, cross-PDE adaptation
๐Ÿ›ฐ๏ธ Digital Twins EnKF, real-time estimation
๐Ÿšข Deployment FastAPI, ONNX, TorchScript
๐Ÿค– Problem Design NLP โ†’ PDE
๐Ÿ† Benchmarking YAML, leaderboards

๐ŸŽฏ Philosophy

If you can't validate it, you shouldn't deploy it.

Physics AI is about:

  • โœ… Correct formulations
  • โœ… Reliable validation
  • โœ… Understanding failure modes
  • โœ… Making informed decisions

๐Ÿง  Positioning

PINNeAPPle
Vendor lock-in โŒ Not tied to any vendor
Just a PINN library โŒ Much more than that
Just experimentation โŒ Bridges to production
โœ… What it is A controlled environment to design, test, and validate Physics AI systems

โญ Support the Project

If this project makes sense to you, give it a star โญ

It helps:

  • Grow the ecosystem
  • Attract contributors
  • Build a real standard

Built for researchers and engineers who take physics seriously.

About

Pinneaple is an open-source Physics AI toolkit for Physics-Informed Neural Networks (PINNs), scientific ML, geometry processing, solvers, and reproducible training pipelines.

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors