2DMatGMM
2DMatGMM copied to clipboard
Code release for "An open-source robust machine learning platform for real-time detection and classification of 2D material flakes"
2DMatGMM: An open-source robust machine learning platform for real-time detection and classification of 2D material flakes
This repository hosts the code and related resources for the 2DMatGMM project, a robust machine learning system designed to detect and classify 2D material flakes in real-time. The details of the project are published on arXiv in the paper titled "An open-source robust machine learning platform for real-time detection and classification of 2D material flakes".
Features
- Real-time detection: The model can detect flakes in real-time on a standard laptop without the need for a GPU.
- Simple Yet Robust: The model is based on a simple Gaussian Mixture Model (GMM) and a Logistic Classifier making it robust to Camera Noise, SiOx variation and Brightness differences.
- Open-Source: Any code and dataset used in the project is open-source and available under an MIT license making it possible to modify, extend and use the project for any purpose.
- Interpretable and Physics-based: The model uses well understood features reported on by literature and can be easily interpreted and validated.
Repository Structure
The paper comprises three repositories each containing a part of the project:
- 2DMatGMM: The code for the machine learning model and the detection algorithm.
- 2DMatGMM-System: The full detection system used in the laboratory.
- 2DMatGMM-Website: The code for the website to analyse, filter and download the flakes.
Dataset
This Repository contains the dataset used in the paper. The dataset will be made available for download on Zenodo. It is currently privately hosted. The download links as well as metadata about the dataset and usage can be found in the Dataset Guide.
Installation
To install and set up your system to use 2DMatGMM, follow the installation instructions.
Getting Started
This repository comes with weights pretrained on the datasets used in the paper. To use the detector for you own projects check out the Getting Started guide.
Quick Start
You may also quickly hop in by trying out the demo on Google Colab. The demo is a Jupyter Notebook which runs the detector on a few demo images from the testset of the Graphene Dataset.
Citing 2DMatGMM
If you use our work or dataset in your research or find the code helpful, we would appreciate a citation to the original paper:
@misc{uslu2023opensource,
title={An open-source robust machine learning platform for real-time detection and classification of 2D material flakes},
author={Jan-Lucas Uslu and Taoufiq Ouaj and David Tebbe and Alexey Nekrasov and Jo Henri Bertram and Marc Schütte and Kenji Watanabe and Takashi Taniguchi and Bernd Beschoten and Lutz Waldecker and Christoph Stampfer},
year={2023},
eprint={2306.14845},
archivePrefix={arXiv},
primaryClass={cond-mat.mes-hall}
}
Contact
If you encounter any issues or have questions about the project, feel free to open an issue on our GitHub repository. This Repo is currently maintained by Jan-Lucas Uslu.