Metadata-Version: 2.4
Name: hpfracc
Version: 1.3.2
Summary: High-Performance Fractional Calculus Library with GPU Acceleration, Machine Learning Integration, and Graph Neural Networks
Author-email: "Davian R. Chin" <d.r.chin@pgr.reading.ac.uk>
Maintainer-email: "Davian R. Chin" <d.r.chin@pgr.reading.ac.uk>
License-Expression: MIT
Project-URL: Homepage, https://github.com/dave2k77/fractional_calculus_library
Project-URL: Repository, https://github.com/dave2k77/fractional_calculus_library.git
Project-URL: Documentation, https://fractional-calculus-library.readthedocs.io
Project-URL: Bug Tracker, https://github.com/dave2k77/fractional_calculus_library/issues
Project-URL: Source Code, https://github.com/dave2k77/fractional_calculus_library
Project-URL: Download, https://github.com/dave2k77/fractional_calculus_library/releases
Project-URL: Academic Contact, https://www.reading.ac.uk/people/d.r.chin
Keywords: fractional-calculus,numerical-methods,machine-learning,graph-neural-networks,jax,pytorch,numba,scientific-computing,mathematics,deep-learning
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Scientific/Engineering :: Mathematics
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.21.0
Requires-Dist: scipy>=1.7.0
Requires-Dist: matplotlib>=3.5.0
Requires-Dist: jax>=0.4.0
Requires-Dist: jaxlib>=0.4.0
Requires-Dist: optax>=0.1.0
Requires-Dist: torch>=1.12.0
Requires-Dist: numba>=0.56.0
Requires-Dist: multiprocessing-logging>=0.3.0
Requires-Dist: joblib>=1.1.0
Requires-Dist: sympy>=1.10.0
Requires-Dist: pandas>=1.3.0
Requires-Dist: seaborn>=0.11.0
Requires-Dist: pytest>=6.0.0
Requires-Dist: pytest-benchmark>=3.4.0
Requires-Dist: pytest-cov>=3.0.0
Requires-Dist: sphinx>=4.0.0
Requires-Dist: sphinx-rtd-theme>=1.0.0
Requires-Dist: black>=22.0.0
Requires-Dist: flake8>=4.0.0
Requires-Dist: mypy>=0.950
Requires-Dist: pre-commit>=2.15.0
Provides-Extra: dev
Requires-Dist: pytest>=6.0.0; extra == "dev"
Requires-Dist: pytest-benchmark>=3.4.0; extra == "dev"
Requires-Dist: pytest-cov>=3.0.0; extra == "dev"
Requires-Dist: black>=22.0.0; extra == "dev"
Requires-Dist: flake8>=4.0.0; extra == "dev"
Requires-Dist: mypy>=0.950; extra == "dev"
Requires-Dist: pre-commit>=2.15.0; extra == "dev"
Requires-Dist: jupyter>=1.0.0; extra == "dev"
Requires-Dist: ipykernel>=6.0.0; extra == "dev"
Provides-Extra: docs
Requires-Dist: sphinx>=4.0.0; extra == "docs"
Requires-Dist: sphinx-rtd-theme>=1.0.0; extra == "docs"
Requires-Dist: myst_parser>=0.18.0; extra == "docs"
Requires-Dist: sphinx-autodoc-typehints>=1.12.0; extra == "docs"
Requires-Dist: pygments>=2.10.0; extra == "docs"
Provides-Extra: gpu
Requires-Dist: cupy>=10.0.0; extra == "gpu"
Requires-Dist: cudf>=21.0.0; extra == "gpu"
Provides-Extra: ml
Requires-Dist: torch>=1.12.0; extra == "ml"
Requires-Dist: jax>=0.4.0; extra == "ml"
Requires-Dist: jaxlib>=0.4.0; extra == "ml"
Requires-Dist: numba>=0.56.0; extra == "ml"
Dynamic: license-file

# HPFRACC - High-Performance Fractional Calculus Library

[![PyPI version](https://badge.fury.io/py/hpfracc.svg)](https://pypi.org/project/hpfracc/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)

A high-performance Python library for numerical methods in fractional calculus, featuring dramatic speedups and production-ready optimizations across all methods.

## 🚀 **Quick Start**

### Installation
```bash
pip install hpfracc
```

### Basic Usage
```python
import hpfracc as hpc

# Create time array
t = np.linspace(0, 10, 1000)
x = np.sin(t)

# Compute fractional derivative
alpha = 0.5  # fractional order
result = hpc.optimized_caputo(t, x, alpha)
```

## ✨ **Features**

### Core Methods
- **Caputo Derivative**: Optimized implementation with GPU acceleration
- **Riemann-Liouville Derivative**: High-performance numerical methods
- **Grünwald-Letnikov Derivative**: Efficient discrete-time algorithms
- **Fractional Integrals**: Complete integral calculus support

### Advanced Algorithms
- **GPU Acceleration**: CUDA support via PyTorch, JAX, and CuPy
- **Parallel Computing**: Multi-core optimization with NUMBA
- **Machine Learning Integration**: PyTorch and JAX backends
- **Graph Neural Networks**: Fractional GNN layers and models

### Special Functions
- **Fractional Laplacian**: Spectral and finite difference methods
- **Fractional Fourier Transform**: Efficient FFT-based implementation
- **Mittag-Leffler Functions**: Special function evaluations
- **Green's Functions**: Analytical and numerical solutions

## 🔧 **Installation Options**

### Basic Installation
```bash
pip install hpfracc
```

### With GPU Support
```bash
pip install hpfracc[gpu]
```

### With Machine Learning Extras
```bash
pip install hpfracc[ml]
```

### Development Version
```bash
pip install hpfracc[dev]
```

## 📚 **Documentation**

- **📖 [User Guide](https://fractional-calculus-library.readthedocs.io/en/latest/user_guide.html)**
- **🔍 [API Reference](https://fractional-calculus-library.readthedocs.io/en/latest/api_reference.html)**
- **📝 [Examples](https://fractional-calculus-library.readthedocs.io/en/latest/examples.html)**
- **🔬 [Scientific Tutorials](https://fractional-calculus-library.readthedocs.io/en/latest/scientific_tutorials.html)**

## 🧪 **Testing**

Run the comprehensive test suite:
```bash
python -m pytest tests/
```

## 🚀 **Performance**

- **Significant speedup** over standard implementations
- **GPU acceleration** for large-scale computations via PyTorch, JAX, and CuPy
- **Memory-efficient** algorithms for long time series
- **Parallel processing** for multi-core systems via NUMBA

## 📊 **Current Status**

### ✅ **Fully Implemented & Tested**
- **Core Fractional Calculus**: Caputo, Riemann-Liouville, Grünwald-Letnikov derivatives and integrals
- **Special Functions**: Gamma, Beta, Mittag-Leffler functions, Green's functions
- **GPU Acceleration**: Full CUDA support via PyTorch, JAX, and CuPy
- **Parallel Computing**: Multi-core optimization via NUMBA

### 🚧 **Partially Implemented & Testing**
- **Machine Learning**: Basic neural networks, GNN layers, attention mechanisms (85% complete)
- **Advanced Solvers**: Basic ODE/PDE solvers, analytical methods in development
- **Advanced Layers**: Basic Conv1D, Conv2D, LSTM, Transformer layers

### 📋 **Planned Features**
- **Complete ML Library**: Advanced layers, optimizers, and loss functions
- **Advanced Solvers**: Homotopy perturbation, variational iteration methods
- **Extended GNN Support**: Additional graph neural network architectures

### 📈 **Implementation Metrics**
- **Core Functionality**: 95% complete and tested
- **ML Integration**: 85% complete
- **Documentation**: 90% complete
- **Test Coverage**: 85%
- **PyPI Package**: Published as `hpfracc-1.3.2`

## 🤝 **Contributing**

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.

**Note**: This library is actively developed. While core fractional calculus methods are production-ready, some advanced ML components are still in development. Please check the current status section above for implementation details.

## 📄 **License**

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 👨‍🔬 **Authors**

- **Davian R. Chin** - Department of Biomedical Engineering, University of Reading
- **Email**: d.r.chin@pgr.reading.ac.uk

## 🙏 **Acknowledgments**

- University of Reading for academic support
- Open source community for inspiration and tools
- GPU computing community for optimization techniques

---

**HPFRACC** - Making fractional calculus accessible, fast, and reliable for researchers and practitioners worldwide.
