Skip to content

Ensemble Learning Classifier to Classify High Redshift X-Ray GRBs

License

Notifications You must be signed in to change notification settings

Milind018/Redshift-Classifier

Repository files navigation

Redshift-Classifier (X-ray)

Documentation Status R Version 4.3 Python Version 3.11 GitHub license image Code DOI

arXiv

Redshift-Classifier (X-ray) is a reliable ensemble machine learning (ML) framework developed to classify X-ray gamma-ray bursts (GRBs) as high-redshift or low-redshift based on the desired redshift cutoff (user-defined). We have used all the GRB light-curve (LC) phases in this framework, prompt, X-ray plateau, and X-ray afterglow, as features to train and test the models. However, our model is developed to use any set of features based on the availability and user's interest.

This ML framework is developed to quickly identify if a GRB is a high-redshift or a low-redshift as soon as a new GRB is detected, which will help other facilities to have quick and more precise follow-up observations. In this ML framework, we have also incorporated ML techniques like outlier removal (removing bad data points), feature selection (to select the best features for redshift classification and to reduce the dimensionality), imputing missing data (to increase the sample size), and also balancing the data (to not have a biased ML trained model), to improve the performance of the ML model.

Our ML model is more reliable because we use an ensemble model (combining many ML algorithms in a single framework using SuperLearner) rather than traditional methods that use a single ML algorithm. This further increases the prediction accuracy.

Documentation

The Redshift-Classifier's (X-Ray) documentation is available in this repository and also hosted on readthedocs.io. Although the documentation is fairly complete, if you are trying to use the Redshift-Classifier (X-ray) Web app and run into issues, please get in touch with us!

Publications

The Redshift-Classifier(X-Ray) was initially introduced in the following publication. Please cite this publication if you make use of the Redshift-Classifier (X-ray) Web app or some code herein.

@misc{dainotti2025grbredshiftclassifierfollowup,
      title={GRB Redshift Classifier to Follow-up High-Redshift GRBs Using Supervised Machine Learning}, 
      author={Maria Giovanna Dainotti and Shubham Bhardwaj and Christopher Cook and Joshua Ange and Nishan Lamichhane and Malgorzata Bogdan and Monnie McGee and Pavel Nadolsky and Milind Sarkar and Agnieszka Pollo and Shigehiro Nagataki},
      year={2025},
      eprint={2408.08763},
      archivePrefix={arXiv},
      primaryClass={astro-ph.HE},
      url={https://arxiv.org/abs/2408.08763}, 
}

License

Copyright 2025 Maria Giovanna Dainotti, Malgorzata Bogdan, Aditya Narendra, Agnieszka Pollo, Shubham Bhardwaj, Milind Sarkar, Joshua Ange, Christopher Cook & contributors

Made available under a GNU GPL v3.0 license.

Contributors

The Redshift-Classifier(X-ray) Ensemble Learning Framework and Web App was initially developed by Maria Giovanna Dainotti, Malgorzata Bogdan, Aditya Narendra, Agnieszka Pollo, Shubham Bhardwaj, Milind Sarkar, Joshua Ange, Christopher Cook & contributors.

The initial documentation was developed by Shubham Bhardwaj, Milind Sarkar, and Joshua Ange.

Getting Help/Contributing

If you have a question, please send me an e-mail at this [email protected] yahoo address.

If you have spotted a bug in the code/documentation or you want to propose a new feature, please feel free to open an issue/a pull request on GitHub.