Metadata-Version: 2.4
Name: pyamtrack
Version: 0.14.1a11
Summary: Python bindings for the libamtrack library
Author-Email: Leszek Grzanka <grzanka@agh.edu.pl>
License-Expression: GPL-3.0-or-later
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3.9
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: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Intended Audience :: Science/Research
Project-URL: Homepage, https://libamtrack.github.io/
Project-URL: Documentation, https://libamtrack.github.io/docs/python/
Project-URL: Repository, https://github.com/libamtrack/pyamtrack.git
Project-URL: Issues, https://github.com/libamtrack/pyamtrack/issues
Requires-Python: >=3.9
Requires-Dist: numpy
Description-Content-Type: text/markdown

# pyamtrack

pyamtrack is a Python wrapper for the libamtrack library, making it easier to access and use libamtrack's functionality directly from Python.

## Stable Release Information

The last stable release of pyamtrack is **0.14.0** (released on **2022-10-03**). However, this version has several limitations:
- It is only available as a binary wheel package for **Linux** (no support for Windows or macOS).
- There is no documentation describing the available functions or how to use them.

To install the stable release, run:
```bash
pip install pyamtrack
```

## Ongoing Development

A new version of pyamtrack is currently being developed, addressing these limitations. The new release will include:
- Support for **Linux, Windows, and macOS** (for Python >= 3.9).
- Full documentation detailing all available functions, their usage, and example applications.

The work is still in progress, and the latest **alpha release** can be installed via:
```bash
pip install pyamtrack --pre
```
*(Use at your own risk, as many things may still be broken.)*

### Usage Example

Here's a quick example demonstrating how to use pyamtrack (ongoing development release):
```python
from pyamtrack.converters import beta_from_energy

print(beta_from_energy(150))
```

### Documentation

Detailed user documentation is available at **[https://libamtrack.github.io/](https://libamtrack.github.io/)**. It includes:
- Instructions for installing the Python library.
- Guidelines on how to use pyamtrack.
- Descriptions of all available functions, including examples.

Informations about Linux installation and project workflow can also be found [here](docs/README.md)

### Example Notebooks

For more detailed examples and tutorials, please refer to the notebooks in the `example` directory.
