Metadata-Version: 2.4
Name: unxts.interop.gala
Version: 2.0.0
Summary: gala integration for unxt (canonical: unxts.interop.gala)
Project-URL: Bug Tracker, https://github.com/GalacticDynamics/unxt/issues
Project-URL: Homepage, https://github.com/GalacticDynamics/unxt
Author-email: GalacticDynamics <nstarman@users.noreply.github.com>, Nathaniel Starkman <nstarman@users.noreply.github.com>
License-Expression: BSD-3-Clause
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: astropy>=7.0.0
Requires-Dist: gala>=1.8; sys_platform != 'win32'
Requires-Dist: unxt>=2.0.0
Description-Content-Type: text/markdown

# unxts.interop.gala

[gala](https://gala.adrian.pw/) integration for [unxt](https://github.com/GalacticDynamics/unxt).

This is the canonical package (`unxts.interop.gala`). It provides conversions between `gala.units.UnitSystem` and `unxt.unitsystems.AbstractUnitSystem`.

## Install

```bash
pip install unxts.interop.gala
```

## Usage

```python
import unxts.interop.gala
```

## Public API

`unxts.interop.gala` exposes two conversion functions:

- `convert_gala_unitsystem_to_unxt_unitsystem`
- `convert_unxt_unitsystem_to_gala_unitsystem`

These are `plum.conversion_method`s, registered with `plum`'s dispatch table as a side effect of importing `unxts.interop.gala`. Prefer `plum.convert(usys, ...)` over calling either function directly, e.g.:

```python
from plum import convert
import unxt as u
import gala.units as gu

convert(gu.galactic, u.AbstractUnitSystem)
convert(u.unitsystem("galactic"), gu.UnitSystem)
```
