Skip to content

shreyasbapat/python-oifits

python-oifits logo

Name

python-oifits

Author

Shreyas Bapat orcid-shreyas

Website

http://oifits.vlbi.software/

Version

1.0.dev0

astropy mailing riotchat license docs doi

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.

Documentation

docs

Complete documentation, including a user guide and an API reference, can be read on the given link:

http://oifits.vlbi.software/

Requirements

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.

Installation

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!

Testing

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 ====================
$

Problems

If the installation fails or you find something that doesn't work as expected, please open an issue in the issue tracker.

Contributing

oifits is a community project, hence all contributions are more than welcome! For more information, head to CONTRIBUTING.rst.

Support

mailing

Release announcements and general discussion take place on our mailing list. Feel free to join!

https://groups.io/g/oifits-dev

Please join our [matrix] channel for further queries.

If you still have a doubt, write a mail directly to shreyas@einsteinpy.org.

Citing

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:

doi

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 ;)