python-oifits is the python package for dealing with Event Horizons Telescope Data. The Data is in infamous OIFITS format. Which is too complex to parse everytime when applying any machine learning or deep learning model on the VLBI Data. The module provides easy access to all the data that is in the OIFITS file. And provides a easy function to export all the data to a numpy array for making computer scientists later spending time on the application of data science models rather than understanding the data.
Complete documentation, including a user guide and an API reference, can be read on the given link:
oifits requires the following Python packages:
- NumPy, for basic numerical routines
- Astropy, for fits handling
oifits is usually tested on Linux on Python 3.6 and 3.7 against latest NumPy.
The easiest and fastest way to get the package up and running is to install python-oifits using pip or conda by simply running:
$ pip install oifits $ conda install -c conda-forge oifits
And it's done!
If installed correctly, the tests can be run using pytest:
$ pytest -vv ============================= test session starts ============================== platform linux -- Python 3.7.1, pytest-4.3.1, py-1.8.0, pluggy-0.9.0 rootdir: /home/shreyas/Local Forks/python-oifits, inifile: setup.cfg plugins: remotedata-0.3.1, openfiles-0.3.1, doctestplus-0.3.0, cov-2.5.1, arraydiff-0.3 collected 1 items [...] ==================== 1 passed, 1 warnings in 28.19 seconds ==================== $
If the installation fails or you find something that doesn't work as expected, please open an issue in the issue tracker.
oifits is a community project, hence all contributions are more than welcome! For more information, head to CONTRIBUTING.rst.
Release announcements and general discussion take place on our mailing list. Feel free to join!
Please join our [matrix] channel for further queries.
If you still have a doubt, write a mail directly to email@example.com.
If you use oifits on your project, please drop us a line.
You can also use the DOI to cite it in your publications. This is the latest one:
And this is an example citation format:
Shreyas Bapat et al.. (2019). oifits: oifits 0.1.1. Zenodo. 10.5281/zenodo.3402135
Why care for the OIFITS now?
oifits is a part of my Major Technical Project of my B.Tech. Degree. I faced the issue of not understanding exactly what the data was, and there was NO PYTHON MODULE which can tell me what's inside the data file. So I spent a significant amount of my research in understanding the data. And I don't want this to happen to anyone who wants to do their research using the world's largest telescope ;)