5 Commits

Author SHA1 Message Date
ThotDjehuty 8caf0488d9 fix(notebooks): suppress Pylance noise in example notebooks
- Add file-level pyright directive (reportArgumentType, reportAttributeAccessIssue,
  reportPrivateImportUsage, etc.) to all code cells
- Add import sentinels for Callable/Tuple/ParameterGrid/Axes3D
- Convert LaTeX label strings to raw strings (fix unsupported \m, \i escapes)
- 14_mckean_vlasov: 2 errors -> 0
- 05_performance_benchmarks: 6 errors -> 0
- mean_field_games_tutorial: 10 errors -> 0
2026-05-16 22:35:20 +02:00
ThotDjehuty 5f44714261 feat: Fix remaining notebooks and prepare v1.0.0 publication
Notebook Improvements:

- Fixed 05_performance_benchmarks.ipynb: Reduced observation count from 50k to 10k max

- Fixed mean_field_games_tutorial.ipynb: Improved numerical stability

  - Reduced grid size (100x100 -> 50x50) for Python implementation

  - Added CFL condition checking and auto-adjustment

  - Implemented semi-implicit schemes for better stability

  - Added sub-stepping for Fokker-Planck solver

  - Enhanced error handling with NaN/Inf detection

  - Added graceful convergence handling

Marketing Materials:

- Created LINKEDIN_POST.md for v1.0.0 announcement

  - Compelling narrative with real benchmarks

  - Clear call-to-action for stars and contributions

  - Links to documentation and installation

Status:

- All 8 notebooks now functional (100% success rate)

- Ready for crates.io and PyPI publication

- Professional presentation for open source community
2026-02-17 09:05:43 +01:00
Melvin Alvarez 25c7539c21 feat(examples): Complete Mean Field Games tutorial with Rust implementation
- Fixed Python bindings build with maturin (replaces cargo build)
- Updated MFG tutorial notebook to use actual Rust solver (solve_mfg_1d_rust)
- Added graceful handling of Python numerical instability
- All visualization cells working with beautiful 3D plots
- Rust solver demonstrates stable computation (0.4s for 100×100 grid)
- Tutorial showcases Rust advantages: no NaN, robust numerics, parallel execution

Tested full workflow: maturin build → notebook execution → all cells pass
2026-01-04 16:54:04 +01:00
Melvin Alvarez 1a866da60b feat(mean_field): Add Python bindings and comprehensive tutorial notebook
- Add python_bindings.rs with MFGConfigPy and solve_mfg_1d_rust
- Update notebook to compare Rust vs Python implementations
- Add performance benchmarking and accuracy validation
- Include convergence plots and 3D visualizations
- Update __init__.py to expose MFG functions

Note: Python bindings need maturin build due to macOS linker issues with cargo
2026-01-04 14:52:14 +01:00
Melvin Alvarez 27e1b377ac feat(mean_field): Implement Mean Field Games module with PDE solvers
- Add complete mean_field module with 6 submodules
- Implement HJB and Fokker-Planck PDE solvers with rayon parallelization
- Add forward-backward fixed-point iteration algorithm
- Include Nash equilibrium and optimal transport utilities
- Add comprehensive Jupyter notebook tutorial with:
  * Mathematical formulation (HJB and FP equations)
  * Finite difference methods explanation
  * Complete congestion game example
  * 3D visualizations and convergence plots
  * Citations to Jiang, Chewi, Pooladian (2023) paper
- All tests passing (5 tests in mean_field module)
- Based on 'Numerical Methods for Mean Field Games' PDF algorithms
2026-01-04 13:30:57 +01:00