Metadata-Version: 2.4
Name: autoarray
Version: 2026.11.12.1
Summary: PyAuto Data Structures
Author-email: James Nightingale <James.Nightingale@newcastle.ac.uk>, Richard Hayes <richard@rghsoftware.co.uk>
License: MIT
Project-URL: Homepage, https://github.com/PyAutoLabs/PyAutoArray
Keywords: cli
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: autonerves>=2026.11.9.1.post1
Requires-Dist: astropy>=5.0
Requires-Dist: decorator>=4.0.0
Requires-Dist: dill>=0.3.1.1
Requires-Dist: finufft>=2.4.0; platform_machine == "AMD64" or (platform_machine == "x86_64" and sys_platform != "darwin") or (sys_platform == "darwin" and platform_machine == "arm64")
Requires-Dist: finufft<2.5,>=2.4.0; sys_platform == "darwin" and platform_machine == "x86_64"
Requires-Dist: matplotlib>=3.7.0
Requires-Dist: scipy<=1.17.1
Requires-Dist: scikit-image<=0.26.0
Requires-Dist: scikit-learn<=1.8.0
Requires-Dist: tqdm
Provides-Extra: jax
Provides-Extra: optional
Requires-Dist: autoarray[jax]; extra == "optional"
Requires-Dist: numba; extra == "optional"
Requires-Dist: nufftax<0.7.0,>=0.6.1; extra == "optional"
Requires-Dist: tfp-nightly==0.26.0.dev20260713; extra == "optional"
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: numba; extra == "dev"
Requires-Dist: nufftax<0.7.0,>=0.6.1; extra == "dev"
Requires-Dist: finufft>=2.4.0; (platform_machine == "AMD64" or (platform_machine == "x86_64" and sys_platform != "darwin") or (sys_platform == "darwin" and platform_machine == "arm64")) and extra == "dev"
Requires-Dist: finufft<2.5,>=2.4.0; (sys_platform == "darwin" and platform_machine == "x86_64") and extra == "dev"
Dynamic: license-file

# PyAutoArray: Arrays, Grids and Masks for Astronomy

**PyAutoArray** provides arrays, masks, coordinate grids and numerical tools for astronomical imaging and interferometer data. It powers the data handling and image reconstruction in **PyAutoGalaxy** and **PyAutoLens**.

If you want to model galaxies or gravitational lenses, start with [PyAutoGalaxy](https://github.com/PyAutoLabs/PyAutoGalaxy) or [PyAutoLens](https://github.com/PyAutoLabs/PyAutoLens). Use PyAutoArray directly when you need these building blocks in your own Python code.

## Getting Started

Install the package:

```bash
pip install autoarray
```

Create a two-dimensional array with a pixel scale:

```python
import autoarray as aa

image = aa.Array2D.no_mask(
    values=[[1.0, 2.0], [3.0, 4.0]],
    pixel_scales=0.1,
)
```

Create a circular mask and a grid of coordinates for its unmasked pixels:

```python
mask = aa.Mask2D.circular(
    shape_native=(50, 50),
    pixel_scales=0.1,
    radius=2.0,
)

grid = aa.Grid2D.from_mask(mask=mask)
```

## Explore Further

- **[Galaxy modeling examples](https://github.com/PyAutoLabs/autogalaxy_workspace#find-your-examples)** — see arrays, grids and masks used in galaxy analysis.
- **[Lensing examples](https://github.com/PyAutoLabs/autolens_workspace#find-your-examples)** — explore their use in gravitational lens modeling.
- **[Source code](https://github.com/PyAutoLabs/PyAutoArray/tree/main/autoarray)** — explore the data structures and numerical tools.
- **[Tests](https://github.com/PyAutoLabs/PyAutoArray/tree/main/test_autoarray)** — find focused examples of individual components.

## Community and Contributing

Ask questions, suggest improvements and share your work in [PyAutoLabs Discussions](https://github.com/orgs/PyAutoLabs/discussions), or chat with us on [Slack](https://join.slack.com/t/pyautolens/shared_invite/zt-2cufp4eyf-fXfgMxRGuvg~bMrI3uOAxg).

To contribute, see the [contribution guide](https://github.com/PyAutoLabs/PyAutoArray/blob/main/CONTRIBUTING.md).

## License

See the [license](https://github.com/PyAutoLabs/PyAutoArray/blob/main/LICENSE).
