Metadata-Version: 2.4
Name: fits2tmp
Version: 1.0.0
Summary: A way of loading FITS files into temporary filesystems to make them available in memory.
Author: Verity Allan
Author-email: Verity Allan <vla22@cam.ac.uk>
License-Expression: BSD-3-Clause
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
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: dask[distributed]>=2025.1.0,<2026
Requires-Dist: astropy>=6.1.4,<7
Requires-Dist: h5py>=3.16.0
Requires-Dist: numpy>=2.1.2,<3
Requires-Dist: pytest>=8.3.3,<9
Requires-Dist: zarr>=3.4.1
Requires-Python: >=3.12, <4
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))
```

