Metadata-Version: 2.4
Name: deterministic-gaussian-sampling-fibonacci
Version: 0.2.5
Summary: Deterministic sampling via orthogonal inverse transform of low-discrepancy Fibonacci grids.
License-Expression: MIT
License-File: LICENSE
Author: Vlad Korsakov
Author-email: ulqba@student.kit.edu
Requires-Python: >=3.10
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: h5py (>=3.15.1,<4.0.0)
Requires-Dist: numpy (>=2.0.0,<3.0.0)
Requires-Dist: scipy (>=1.15,<1.16) ; python_version < "3.11"
Requires-Dist: scipy (>=1.16.3,<2.0.0) ; python_version >= "3.11"
Description-Content-Type: text/markdown

# Deterministic Gaussian Sampling

Deterministic sampling via orthogonal inverse transform of low-discrepancy Fibonacci grids.

## Installation

Install via pip:

```bash
pip install deterministic-gaussian-sampling-fibonacci
```

or directly from GitHub:

```bash
pip install git+https://github.com/KIT-ISAS/deterministic_gaussian_sampling_fibonacci.git
```

## Usage example

```python
from deterministic_gaussian_sampling_fibonacci import sample_gaussian_fibonacci
import numpy as np

# sample_gaussian_fibonacci(mean, covariance_matrix, sample_count, sample_type)
samples = sample_gaussian_fibonacci([1, 1], np.eye(2), 100, "Fibonacci")
```

```python
from deterministic_gaussian_sampling_fibonacci import get_uniform_grid


# get_uniform_grid(dimension, sample_count, grid_type)
grid = get_uniform_grid(2, 100, "Fibonacci")
```

## Maximum supported sample counts by dimension and type

| dim | ClassicalFrolov | ImprovedFrolov | Fibonacci | Galois |
| --- | --------------: | -------------: | --------: | -----: |
| 2   |          100003 |         100003 |     99997 |      - |
| 3   |           99997 |         100007 |     99995 |      - |
| 4   |          100009 |          99965 |     99997 |      - |
| 5   |          100217 |         100017 |     99989 | 105021 |
| 6   |            5987 |          99969 |    100005 | 104997 |


