Metadata-Version: 2.3
Name: fits2tmp
Version: 0.3.0
Summary: A way of loading FITS files into temporary filesystems to make them available in memory.
License: BSD-3-Clause
Author: Verity Allan
Author-email: vla22@cam.ac.uk
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: BSD License
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
Requires-Dist: astropy (>=6.1.4,<7.0.0)
Requires-Dist: dask[distributed] (>=2025.1.0,<2026.0.0)
Requires-Dist: h5py (>=3.12.1,<4.0.0)
Requires-Dist: numpy (>=2.1.2,<3.0.0)
Requires-Dist: pytest (>=8.3.3,<9.0.0)
Requires-Dist: zarr (>=2.18.3,<3.0.0)
Project-URL: Repository, https://gitlab.developers.cam.ac.uk/phy/ra/vla22-phd/fits2tmp
Description-Content-Type: text/markdown

# fits2tmp 

This project allows you to take a large FITS file and render it as a set of smaller FITS files stored in-memory in a temporary directory, with appropriately updated headers.
The program returns a list of the location of these files, which can then be processed by a parallel processing framework such as dask.

The program also allows you to turn a zarr file containing your FITS data into small FITS files, provided you have extracted the FITS file header to a text file.
Utilities in the program can be used to write headers out to or read them from a text file.

## TODO:

- Add a utility to convert FITS files to zarr, including saving the header out to a text file.
- Add hdf5 support using a similar strategy to FITS.
- Add xradio support.

## Installing fits2tmp

The program is available from pypi so can be installed with pip: `pip install fits2tmp`.

## Example Usage

```
import fits2tmp as f2t

a = fakefits2tmpfiles("fits", "/path/to/input/data", "/path/to/temporary/filesystem", "path/to/header/", (100, 100, 100), chunks=(20,20,20))
```


