Metadata-Version: 2.1
Name: PyFIRSTClassifier
Version: 2.0.2
Summary: Automated morphological classification of Compact and Extended radio sources using Deep Convolutional Neural Networks
Home-page: https://github.com/wathela/FIRSTClassifier
Author: Wathela Alhassan
Author-email: wathelahamed@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pandas==2.0.3
Requires-Dist: numpy==1.24.3
Requires-Dist: matplotlib==3.7.5
Requires-Dist: scipy==1.10.1
Requires-Dist: astropy==5.2.2
Requires-Dist: pyvo==1.5.2
Requires-Dist: scikit-image==0.21.0
Requires-Dist: keras==2.13.1
Requires-Dist: tensorflow==2.13.1

[![Language](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/wathela/pymerger/blob/main/LICENSE)
[![DOI](https://zenodo.org/badge/825790581.svg)](https://zenodo.org/records/13941128)


 FIRST Classifier: Compact and Extended Radio Galaxies Classification using Deep Convolutional Neural Networks
 =============
 
The FIRST Classifier is a tool for the automated morphological classification of radio sources based on data from the FIRST radio survey. This system leverages a trained Deep Convolutional Neural Network to classify radio galaxies into Compact, BENT, FRI, and FRII categories with high accuracy. It can predict the morphological class of single or multiple sources.
    - **Accuracy**: 97%
    - **Recall**: Compact (98%), BENT (100%), FRI (98%), FRII (93%)

### How to use:


 ```python
 
    from PyFIRSTClassifier import FIRSTClassifier

    classifier = FIRSTClassifier.Classifiers()

    # Example for single source classification
    ra = 223.47337
    dec = 26.80928

    # Call the classification function
    fits_file_link, predicted_class, probability, image = classifier.single_source(ra,       
                                                                        dec,plot=False)

    # Example for multi-source classification
    input_file = "test.csv"
    output_file = "results.csv"
    classifier.multi_sources(file=input_file, ra_col=0, dec_col=1,
                            output_file=output_file)
    
    
```


For more information, see the associated research papers:
- [MNRAS](https://academic.oup.com/mnras/advance-article/doi/10.1093/mnras/sty2038/5060783)
- [Astro-ph](https://arxiv.org/abs/1807.10380)
- [GitHub](https://github.com/wathela/FIRST-CLASSIFIER)

<img src="https://raw.githubusercontent.com/wathela/FIRST-CLASSIFIER/master/Diagram.png" width="400px">




How to cite:
=========
@article{Alhassan2018,

author = {Alhassan, Wathela and Taylor, A R and Vaccari, Mattia},

doi = {10.1093/mnras/sty2038},

issn = {0035-8711},

journal = {Monthly Notices of the Royal Astronomical Society},

month = {jul},

title = {{The FIRST Classifier: Compact and Extended Radio Galaxy Classification using Deep Convolutional Neural Networks}},

url = {https://academic.oup.com/mnras/advance-article/doi/10.1093/mnras/sty2038/5060783},

year = {2018}

}


