# TelescopeML
[![PyPI - Latest Release](https://img.shields.io/pypi/v/TelescopeML.svg?logo=pypi&logoColor=white&label=PyPI)](https://pypi.python.org/pypi/TelescopeML)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.10183099.svg)](https://doi.org/10.5281/zenodo.10183099)
[![Build Status](https://app.travis-ci.com/EhsanGharibNezhad/TelescopeML.svg?branch=main)](https://app.travis-ci.com/EhsanGharibNezhad/TelescopeML)
[![.github/workflows/draft-pdf.yml](https://github.com/EhsanGharibNezhad/TelescopeML/actions/workflows/draft-pdf.yml/badge.svg)](https://github.com/EhsanGharibNezhad/TelescopeML/actions/workflows/draft-pdf.yml)
[![pages-build-deployment](https://github.com/EhsanGharibNezhad/TelescopeML/actions/workflows/pages/pages-build-deployment/badge.svg)](https://github.com/EhsanGharibNezhad/TelescopeML/actions/workflows/pages/pages-build-deployment)
[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
![Python](https://img.shields.io/badge/python-3.9-blue.svg)
[![Downloads](https://static.pepy.tech/badge/telescopeml)](https://pepy.tech/project/telescopeml)
``TelescopeML`` is a Python package comprising a series of modules, each equipped with specialized machine learning and
statistical capabilities for conducting Convolutional Neural Networks (CNN) or Machine Learning (ML) training on
datasets captured from the atmospheres of extrasolar planets and brown dwarfs. The tasks executed by the ``TelescopeML``
modules are outlined below:
![](docs/figures/TelescopeML_modules.png)
- *DataMaster module*: Performs various tasks to process the datasets, including:
- Preparing inputs and outputs
- Splitting the dataset into training, validation, and test sets
- Scaling/normalizing the data
- Visualizing the data
- Conducting feature engineering
- *DeepTrainer module*: Utilizes different methods/packages such as TensorFlow to:
- Build Convolutional Neural Networks (CNNs) model using the training examples
- Utilize tuned hyperparameters
- Fit/train the ML models
- Visualize the loss and training history, as well as the trained model's performance
- *Predictor module*: Implements the following tasks to predict atmospheric parameters:
- Processes and predicts the observational datasets
- Deploys the trained ML/CNNs model to predict atmospheric parameters
- Visualizes the processed observational dataset and the uncertainty in the predicted results
- *StatVisAnalyzer module*: Provides a set of functions to perform the following tasks:
- Explores and processes the synthetic datasets
- Performs the chi-square test to evaluate the similarity between two datasets
- Calculates confidence intervals and standard errors
- Functions to visualize the datasets, including scatter plots, histograms, boxplots
or simply...
- Load the trained CNN models
- Follow the tutorials
- Predict the stellar/exoplanetary parameters
- Report the statistical analysis
## Documentation
- Documentation: https://ehsangharibnezhad.github.io/TelescopeML/
- Installation: https://ehsangharibnezhad.github.io/TelescopeML/installation.html
- Tutorials: https://ehsangharibnezhad.github.io/TelescopeML/tutorials.html
- The code: https://ehsangharibnezhad.github.io/TelescopeML/code.html
## Contributors
<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
[![All Contributors](https://img.shields.io/badge/all_contributors-6-orange.svg?style=flat-square)](#contributors-)
<!-- ALL-CONTRIBUTORS-BADGE:END -->
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
<tbody>
<tr>
<td align="center" valign="top" width="20%">
<a href="https://github.com/EhsanGharibNezhad">
<img src="https://avatars.githubusercontent.com/u/22139918?v=4?s=100" width="100px;" alt="Ehsan Gharib-Nezhad"/><br />
<sub><b>Ehsan Gharib-Nezhad</b></sub>
</a><br/>
<a href="https://github.com/EhsanGharibNezhad/TelescopeML/commits?author=EhsanGharibNezhad" title="Code">💻</a>
<a href="#ideas" title="Ideas, Leading ">🤔</a>
<a href="https://pypi.org/project/TelescopeML/" title="Maintenance">🚧</a>
<a href="https://ehsangharibnezhad.github.io/TelescopeML/tutorials.html" title="tutorial">📚</a>
</td>
<td align="center" valign="top" width="20%">
<a href="http://natashabatalha.github.io">
<img src="https://avatars.githubusercontent.com/u/6554465?v=4?s=100" width="100px;" alt="Natasha Batalha"/><br />
<sub><b>Natasha Batalha</b></sub>
</a><br/>
<a href="#mentoring-astro" title="mentoring">🧑🏫</a>
<a href="https://github.com/EhsanGharibNezhad/TelescopeML/commits?author=natashabatalha" title="bug">🐛</a>
<a href="#ideas" title="Ideas & Feedback">🤔</a>
</td>
<td align="center" valign="top" width="20%">
<a href="https://github.com/hvalizad">
<img src="https://avatars.githubusercontent.com/u/52180694?v=4?s=100" width="100px;" alt="Hamed Valizadegan"/><br />
<sub><b>Hamed Valizadegan</b></sub>
</a><br/>
<a href="#mentoring-ML" title="mentoring">🧑🏫</a>
<a href="#ideas" title="Ideas & Feedback">🤔</a>
</td>
<td align="center" valign="top" width="20%">
<a href="https://github.com/migmartinho">
<img src="https://avatars.githubusercontent.com/u/47117139?v=4?s=100" width="100px;" alt="Miguel Martinho"/><br />
<sub><b>Miguel Martinho</b></sub>
</a><br/>
<a href="" title="mentoring-CNNTuning-BOHB" title="Mentoring">🧑🏫</a>
<a href="#ideas" title="Ideas & Feedback">🤔</a>
</td>
</tr>
<tr>
<td align="center" valign="top" width="20%">
<a href="https://github.com/mdhabibi">
<img src="https://avatars.githubusercontent.com/u/19531036?v=4" width="100px;" alt="Mahdi Habibi"/><br />
<sub><b>Mahdi Habibi</b></sub>
</a><br/>
<a href="https://github.com/EhsanGharibNezhad/TelescopeML/blob/xai/TelescopeML/LIMEXplainer.py" title="Code">💻</a>
<a href="#ideas" title="XAI Ideas, Feedback">🤔</a>
</td>
<td align="center" valign="top" width="20%">
<a href="https://github.com/letgotopal">
<img src="https://avatars.githubusercontent.com/u/89670109?v=4?s=100" width="80px;" alt="Gopal Nookula"/><br />
<sub><b>Gopal Nookula</b></sub>
</a><br/>
<a href="https://ehsangharibnezhad.github.io/TelescopeML/tutorials.html" title="tutorial">📚</a>
</td>
</tr>
</tbody>
</table>
<!-- ALL-CONTRIBUTORS-LIST:END -->
Raw data
{
"_id": null,
"home_page": "https://ehsangharibnezhad.github.io/TelescopeML",
"name": "TelescopeML",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "Astronomy, Stars, Telescope, CNN, Deep Learning, Machine Learning",
"author": "Ehsan (Sam) Gharib-Nezhad",
"author_email": "e.gharibnezhad@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/fe/dc/4023871019c404afd529f4bd4c58d6661b78742a4a9c572f69cc18fd75e5/telescopeml-0.0.5.tar.gz",
"platform": null,
"description": "# TelescopeML\n\n[![PyPI - Latest Release](https://img.shields.io/pypi/v/TelescopeML.svg?logo=pypi&logoColor=white&label=PyPI)](https://pypi.python.org/pypi/TelescopeML)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.10183099.svg)](https://doi.org/10.5281/zenodo.10183099)\n\n[![Build Status](https://app.travis-ci.com/EhsanGharibNezhad/TelescopeML.svg?branch=main)](https://app.travis-ci.com/EhsanGharibNezhad/TelescopeML)\n[![.github/workflows/draft-pdf.yml](https://github.com/EhsanGharibNezhad/TelescopeML/actions/workflows/draft-pdf.yml/badge.svg)](https://github.com/EhsanGharibNezhad/TelescopeML/actions/workflows/draft-pdf.yml)\n[![pages-build-deployment](https://github.com/EhsanGharibNezhad/TelescopeML/actions/workflows/pages/pages-build-deployment/badge.svg)](https://github.com/EhsanGharibNezhad/TelescopeML/actions/workflows/pages/pages-build-deployment)\n[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n![Python](https://img.shields.io/badge/python-3.9-blue.svg)\n[![Downloads](https://static.pepy.tech/badge/telescopeml)](https://pepy.tech/project/telescopeml)\n\n``TelescopeML`` is a Python package comprising a series of modules, each equipped with specialized machine learning and\nstatistical capabilities for conducting Convolutional Neural Networks (CNN) or Machine Learning (ML) training on\ndatasets captured from the atmospheres of extrasolar planets and brown dwarfs. The tasks executed by the ``TelescopeML``\nmodules are outlined below:\n\n\n![](docs/figures/TelescopeML_modules.png)\n\n- *DataMaster module*: Performs various tasks to process the datasets, including:\n\n - Preparing inputs and outputs\n - Splitting the dataset into training, validation, and test sets\n - Scaling/normalizing the data\n - Visualizing the data\n - Conducting feature engineering\n\n- *DeepTrainer module*: Utilizes different methods/packages such as TensorFlow to:\n\n - Build Convolutional Neural Networks (CNNs) model using the training examples\n - Utilize tuned hyperparameters\n - Fit/train the ML models\n - Visualize the loss and training history, as well as the trained model's performance\n\n- *Predictor module*: Implements the following tasks to predict atmospheric parameters:\n\n - Processes and predicts the observational datasets\n - Deploys the trained ML/CNNs model to predict atmospheric parameters\n - Visualizes the processed observational dataset and the uncertainty in the predicted results\n\n- *StatVisAnalyzer module*: Provides a set of functions to perform the following tasks:\n\n - Explores and processes the synthetic datasets\n - Performs the chi-square test to evaluate the similarity between two datasets\n - Calculates confidence intervals and standard errors\n - Functions to visualize the datasets, including scatter plots, histograms, boxplots\n\n\nor simply...\n\n - Load the trained CNN models\n - Follow the tutorials\n - Predict the stellar/exoplanetary parameters\n - Report the statistical analysis\n\n\n\n## Documentation\n\n- Documentation: https://ehsangharibnezhad.github.io/TelescopeML/\n- Installation: https://ehsangharibnezhad.github.io/TelescopeML/installation.html\n- Tutorials: https://ehsangharibnezhad.github.io/TelescopeML/tutorials.html\n- The code: https://ehsangharibnezhad.github.io/TelescopeML/code.html\n\n\n## Contributors\n\n<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->\n[![All Contributors](https://img.shields.io/badge/all_contributors-6-orange.svg?style=flat-square)](#contributors-)\n<!-- ALL-CONTRIBUTORS-BADGE:END -->\n\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->\n<!-- prettier-ignore-start -->\n<!-- markdownlint-disable -->\n\n\n<table>\n <tbody>\n <tr>\n <td align=\"center\" valign=\"top\" width=\"20%\">\n <a href=\"https://github.com/EhsanGharibNezhad\">\n <img src=\"https://avatars.githubusercontent.com/u/22139918?v=4?s=100\" width=\"100px;\" alt=\"Ehsan Gharib-Nezhad\"/><br />\n <sub><b>Ehsan Gharib-Nezhad</b></sub>\n </a><br/>\n <a href=\"https://github.com/EhsanGharibNezhad/TelescopeML/commits?author=EhsanGharibNezhad\" title=\"Code\">\ud83d\udcbb</a> \n <a href=\"#ideas\" title=\"Ideas, Leading \">\ud83e\udd14</a>\n <a href=\"https://pypi.org/project/TelescopeML/\" title=\"Maintenance\">\ud83d\udea7</a>\n <a href=\"https://ehsangharibnezhad.github.io/TelescopeML/tutorials.html\" title=\"tutorial\">\ud83d\udcda</a>\n </td>\n <td align=\"center\" valign=\"top\" width=\"20%\">\n <a href=\"http://natashabatalha.github.io\">\n <img src=\"https://avatars.githubusercontent.com/u/6554465?v=4?s=100\" width=\"100px;\" alt=\"Natasha Batalha\"/><br />\n <sub><b>Natasha Batalha</b></sub>\n </a><br/>\n <a href=\"#mentoring-astro\" title=\"mentoring\">\ud83e\uddd1\u200d\ud83c\udfeb</a> \n <a href=\"https://github.com/EhsanGharibNezhad/TelescopeML/commits?author=natashabatalha\" title=\"bug\">\ud83d\udc1b</a>\n <a href=\"#ideas\" title=\"Ideas & Feedback\">\ud83e\udd14</a>\n </td>\n <td align=\"center\" valign=\"top\" width=\"20%\">\n <a href=\"https://github.com/hvalizad\">\n <img src=\"https://avatars.githubusercontent.com/u/52180694?v=4?s=100\" width=\"100px;\" alt=\"Hamed Valizadegan\"/><br />\n <sub><b>Hamed Valizadegan</b></sub>\n </a><br/>\n <a href=\"#mentoring-ML\" title=\"mentoring\">\ud83e\uddd1\u200d\ud83c\udfeb</a> \n <a href=\"#ideas\" title=\"Ideas & Feedback\">\ud83e\udd14</a>\n </td>\n <td align=\"center\" valign=\"top\" width=\"20%\">\n <a href=\"https://github.com/migmartinho\">\n <img src=\"https://avatars.githubusercontent.com/u/47117139?v=4?s=100\" width=\"100px;\" alt=\"Miguel Martinho\"/><br />\n <sub><b>Miguel Martinho</b></sub>\n </a><br/>\n <a href=\"\" title=\"mentoring-CNNTuning-BOHB\" title=\"Mentoring\">\ud83e\uddd1\u200d\ud83c\udfeb</a>\n <a href=\"#ideas\" title=\"Ideas & Feedback\">\ud83e\udd14</a>\n </td>\n </tr>\n <tr>\n <td align=\"center\" valign=\"top\" width=\"20%\">\n <a href=\"https://github.com/mdhabibi\">\n <img src=\"https://avatars.githubusercontent.com/u/19531036?v=4\" width=\"100px;\" alt=\"Mahdi Habibi\"/><br />\n <sub><b>Mahdi Habibi</b></sub>\n </a><br/>\n <a href=\"https://github.com/EhsanGharibNezhad/TelescopeML/blob/xai/TelescopeML/LIMEXplainer.py\" title=\"Code\">\ud83d\udcbb</a> \n <a href=\"#ideas\" title=\"XAI Ideas, Feedback\">\ud83e\udd14</a>\n </td> \n <td align=\"center\" valign=\"top\" width=\"20%\">\n <a href=\"https://github.com/letgotopal\">\n <img src=\"https://avatars.githubusercontent.com/u/89670109?v=4?s=100\" width=\"80px;\" alt=\"Gopal Nookula\"/><br />\n <sub><b>Gopal Nookula</b></sub>\n </a><br/>\n <a href=\"https://ehsangharibnezhad.github.io/TelescopeML/tutorials.html\" title=\"tutorial\">\ud83d\udcda</a>\n </td>\n </tr>\n </tbody>\n</table>\n\n\n\n\n<!-- ALL-CONTRIBUTORS-LIST:END -->\n",
"bugtrack_url": null,
"license": "GPL-3.0",
"summary": "An End-to-End Python Package for Interpreting Telescope Datasets through Training Machine Learning Models, Generating Statistical Reports, and Visualizing Results",
"version": "0.0.5",
"project_urls": {
"Download": "https://github.com/EhsanGharibNezhad/TelescopeML",
"Homepage": "https://ehsangharibnezhad.github.io/TelescopeML"
},
"split_keywords": [
"astronomy",
" stars",
" telescope",
" cnn",
" deep learning",
" machine learning"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5636150e5463f6f5d09b1e746c8cc29981f0d54143a27a68c9b99c5319004179",
"md5": "8889225f46c8aab09a5fc3fd2989aaf5",
"sha256": "55773e632adb33e40f425e2f6fdd61e9328d4d539f5f3572b84ae3dc45b84ae7"
},
"downloads": -1,
"filename": "TelescopeML-0.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8889225f46c8aab09a5fc3fd2989aaf5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 53411,
"upload_time": "2024-06-05T22:13:40",
"upload_time_iso_8601": "2024-06-05T22:13:40.828772Z",
"url": "https://files.pythonhosted.org/packages/56/36/150e5463f6f5d09b1e746c8cc29981f0d54143a27a68c9b99c5319004179/TelescopeML-0.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fedc4023871019c404afd529f4bd4c58d6661b78742a4a9c572f69cc18fd75e5",
"md5": "624b4d0e42c78519d20920612b4a9c27",
"sha256": "9bec5b2af2070039f38d3306af1dfe54f552446cfb6fb22731af1a110431c35f"
},
"downloads": -1,
"filename": "telescopeml-0.0.5.tar.gz",
"has_sig": false,
"md5_digest": "624b4d0e42c78519d20920612b4a9c27",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 52007,
"upload_time": "2024-06-05T22:13:42",
"upload_time_iso_8601": "2024-06-05T22:13:42.691770Z",
"url": "https://files.pythonhosted.org/packages/fe/dc/4023871019c404afd529f4bd4c58d6661b78742a4a9c572f69cc18fd75e5/telescopeml-0.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-05 22:13:42",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "EhsanGharibNezhad",
"github_project": "TelescopeML",
"travis_ci": true,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "telescopeml"
}