Metadata-Version: 2.4
Name: f2p
Version: 0.1.1
Summary: FITS 2D/3D physical size analyzer
Home-page: https://github.com/siwakotiutsav/fits2physical
Author: Utsav Siwakoti
Author-email: siwakotiutsav@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: matplotlib
Requires-Dist: astropy
Requires-Dist: scipy
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

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%
