AstronomicAL
An interactive dashboard for visualisation, integration and classification of data using Active Learning.
AstronomicAL is a human-in-the-loop interactive labelling and training dashboard that allows users to create reliable datasets and robust classifiers using active learning. The system enables users to visualise and integrate data from different sources and deal with incorrect or missing labels and imbalanced class sizes by using active learning to help the user focus on correcting the labels of a few key examples. Combining the use of the Panel, Bokeh, modAL and SciKit Learn packages, AstronomicAL enables researchers to take full advantage of the benefits of active learning: high accuracy models using just a fraction of the total data, without the requirement of being well versed in underlying libraries.
Statement of Need
Active learning (Settles, 2012) removes the requirement for large amounts of labelled training data whilst still producing high accuracy models. This is extremely important as with ever-growing datasets; it is becoming impossible to manually inspect and verify ground truth used to train machine learning systems. The reliability of the training data limits the performance of any supervised learning model, so consistent classifications become more problematic as data sizes increase. The problem is exacerbated when a dataset does not contain any labelled data, preventing supervised learning techniques entirely. AstronomicAL has been developed to tackle these issues head-on and provide a solution for any large scientific dataset.
It is common for active learning to query areas of high uncertainty; these are often in the boundaries between classes where the expert's knowledge is required. To facilitate this human-in-the-loop process, AstronomicAL provides users with the functionality to fully explore each data point chosen. This allows them to inject their domain expertise directly into the training process, ensuring that asigned labels are both accurate and reliable.
AstronomicAL has been extensively validated on astronomy datasets. These are highly representative of the issues that we anticipate will be found in other domains for which the tool is designed to be easily customisable. Such issues include the volume of data (millions of sources per survey), vastly imbalanced classes and ambiguous class definitions leading to inconsistent labelling. AstronomicAL has been developed to be sufficiently general for any tabular data and can be customised for any domain. For example, we provide the functionality for data fusion of catalogued data and online cutout services for astronomical datasets.
Using its modular and extensible design, researchers can quickly adapt AstronomicAL for their research to allow for domain-specific plots, novel query strategies, and improved models. Furthermore, there is no requirement to be well-versed in the underlying libraries that the software uses. This is due to large parts of the complexity being abstracted whilst allowing more experienced users to access full customisability.
As the software runs entirely locally on the user's system, AstronomicAL provides a private space to experiment whilst providing a public mechanism to share results. By sharing only the configuration file, users remain in charge of distributing their potentially sensitive data, enabling collaboration whilst respecting privacy.
Documentation
The documentation for AstronomicAL can be found here.
Installation
To install AstronomicAL and its dependencies, the user can clone the repository and from within the repo folder run pip install -r requirements.txt. . It is recommended that the user creates a virtual environment using tools such as Virtualenv or Conda, to prevent any conflicting package versions.
git clone https://github.com/grant-m-s/AstronomicAL.git
cd AstronomicAL
conda config --add channels conda-forge
conda create --name astronomical --file requirements.txt
conda activate astronomical
Quickstart Instructions
To begin using the software, run bokeh serve astronomicAL --show and your browser should automatically open to localhost:5006/astronomicAL
AstronomicAL provides both an example dataset and an example configuration file to allow you to jump right into the software and give it a test run.
To begin training you simply have to select Load Custom Configuration checkbox and select your config file. Here we have chosen to use the example_config.json file.
The Load Config Select option allows use to choose the extent to which to reload the configuration.
Contributing to AstronomicAL
Reporting Bugs
If you encounter a bug, you can directly report it in the issues section.
Please describe how to reproduce the bug and include as much information as possible that can be helpful for fixing it.
Are you able to fix a bug?
You can open a new pull request or include your suggested fix in the issue.
Submission of extensions
Have you created an extension that you want to share with the community?
Create a pull request describing your extension and how it can improve research for others.
Support and Feedback
We would love to hear your thoughts on AstronomicAL.
Are there any features that would improve the effectiveness and usability of AstronomicAL? Let us know!
Any feedback can be submitted as an issue.
Referencing the Package
Please remember to cite our software and user guide whenever relevant.
See the Citing page in the documentation for instructions about referencing and citing the astronomicAL software.
![[JOSS Review] Tests](https://avatars.githubusercontent.com/u/39347211?v=4)
22 Dec 21, 2022
10 Jan 06, 2023
43 Dec 09, 2022
342 Oct 26, 2022
1.8k Dec 29, 2022
21 Aug 26, 2022
0 Jul 09, 2022
120 Jan 04, 2023
206 Dec 12, 2022
2 Oct 30, 2022
27 Dec 03, 2022
6 Aug 22, 2022
162 Dec 05, 2022
15 Dec 10, 2022
3 Jul 09, 2022
107 Dec 14, 2022
670 Jan 09, 2023
1 Dec 11, 2021
9 Sep 26, 2022
0 Jun 25, 2022