Metadata-Version: 2.4
Name: transix
Version: 0.3.0
Summary: A lightweight Python library for power system and control engineering transforms
Keywords: numerical,transformations,math,engineering,scientific,transforms
Author: Gowtham Mahendran
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Topic :: Scientific/Engineering
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
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: numpy>=2.0
Requires-Dist: pytest>=9.0 ; extra == 'dev'
Requires-Dist: ruff>=0.14 ; extra == 'dev'
Requires-Dist: pytest-cov>=7.0 ; extra == 'dev'
Requires-Dist: sphinx>=8,<9 ; python_full_version < '3.12' and extra == 'dev'
Requires-Dist: sphinx>=9.1 ; python_full_version >= '3.12' and extra == 'dev'
Requires-Dist: sphinx-book-theme>=1.1.4 ; extra == 'dev'
Requires-Dist: myst-parser>=5.0 ; extra == 'dev'
Requires-Dist: numpydoc>=1.10 ; extra == 'dev'
Requires-Python: >=3.11
Project-URL: Homepage, https://github.com/Gowtham-Mahendran/transix
Project-URL: Documentation, https://Gowtham-Mahendran.github.io/transix
Project-URL: Repository, https://github.com/Gowtham-Mahendran/transix
Project-URL: Issues, https://github.com/Gowtham-Mahendran/transix/issues
Project-URL: Changelog, https://github.com/Gowtham-Mahendran/transix/blob/master/CHANGELOG.md
Provides-Extra: dev
Description-Content-Type: text/markdown

# transix

[![PyPI](https://img.shields.io/pypi/v/transix.svg)](https://pypi.org/project/transix/)
[![Python](https://img.shields.io/pypi/pyversions/transix)](https://pypi.org/project/transix/)
[![CI](https://github.com/Gowtham-Mahendran/transix/actions/workflows/tests.yml/badge.svg)](https://github.com/Gowtham-Mahendran/transix/actions/workflows/tests.yml)
[![License](https://img.shields.io/pypi/l/transix.svg)](https://github.com/Gowtham-Mahendran/transix/blob/main/LICENSE)
[![Docs](https://img.shields.io/badge/docs-online-blue)](https://Gowtham-Mahendran.github.io/transix/)

**transix** is a lightweight Python library for linear, deterministic, matrix-based representation transforms, commonly used in electrical and control engineering.

## Available Transforms

- Fortescue (Symmetrical Components)
- Clarke (αβ)
- Signal generation utilities

## Features

- Supports complex and real-valued inputs
- Clean object-oriented output
- Fully tested with `pytest`
- Lightweight and minimal dependency

## Installation

transix can be installed from PyPI:

```bash
pip install transix
```

## Example: 

### Fortescue Transform

```python
import transix as tx
Ea = 60+0j
Eb = 45-75j
Ec = -21+120j
seq = tx.abc_to_sym(Ea, Eb, Ec)

a0, b0, c0 = seq.zero
a1, b1, c1 = seq.pos
a2, b2, c2 = seq.neg
```

### Clarke Transform

```python
import transix as tx
alpha, beta, zero = tx.abc_to_ab0(a, b, c)
```

## Testing

All transforms and utilities are tested and verifiable using `pytest`

## Roadmap

See [`ROADMAP.md`](https://github.com/Gowtham-Mahendran/transix/blob/main/ROADMAP.md) for planned additions and future work.

## Contributing

Issues and pull requests are welcome.

If you find a bug, have a question, or want to add a transformation,
please open an issue on GitHub.

---