f2p 0.1.1

FITS 2D/3D physical size analyzer

fits2physical

Overview

fits2physical is a Python package to analyze FITS files, compute pixel and physical sizes, and generate plots.

Installation

Install via pip (after PyPI release) or GitHub:

.. code-block:: bash

pip install f2p
# or directly from GitHub
pip install git+https://github.com/siwakotiutsav/fits2physical.git

Usage

Analyze a FITS file and get dimensions:

.. code-block:: python

import f2p
df, fig = f2p.analyze("../data/ngc253/NGC253_sky_v1_17_1_ch3-shortmediumlong_s3d.fits",
                       distance_mpc=3.5)
print(df)
fig.show()  # Optional: display figure

Expected output:

.. code-block:: text

   Quantity     Pixels                    Angular               Physical
0    Length  85.529646   17.10592943977466 arcsec  290.26160171739974 pc
1   Breadth  50.442038  10.088407695872492 arcsec  171.18493250494006 pc
2  Diagonal  97.406365   19.48127334931105 arcsec   330.5675745813207 pc

Figure

Here’s the figure generated by the analysis:

.. image:: docs/_static/example_plot.png :alt: FITS Analysis Figure :align: center :width: 80%