1 Introduction

This is a short companion tutorial to the github (Monteiro 2020b). We give here a glimpse of the Phase Separation Binary Classifier (in short, PSBC), proposed in the article Binary Classification as a Phase Separation Process, by Rafael Monteiro; a preprint is available on arXiv.

An implementation of the model can be found in the module binary_phase_separation.py. Part of this tutorial can also be found in README.pdf.

…but, before we start…

  • The main module for this project is binary_phase_separation.py, that you will find in this Github page (Monteiro 2020b).

  • If you are looking for the dataset and trained models, see the (Monteiro 2020a) at Zenodo.

  • If you want to reproduce this notebook you should download the file PSBC_Examples.tar.gz in the aforementioned data repository, and also the tarball jupyter-notebooks in (Monteiro 2020b).1

  • To download data, I highly recommend the use of the script download_PSBC.sh, for a few reasons: (i) it downloads the data in a safe way (using wget); (ii) it automatically checks the MD5 of each file. We would like to highlight that you can also use the same script to download only the trained examples and only the jupyter-notebooks for this project. In order to use it, please read first this README.pdf guide for further explanation.

  • This website is based on this jupyter-notebook. The full code to the pictures seen here are posted there. For that reason, I shall refrain from posting the whole oputput of some cases, marking then with a symbol \(>>>\).

  • We will summarize some of the outputs, adding a “…” to them. If you would like to see the whole output, please see Notebook_PSBC_example.ipynb.

As we said, this discussion is short but we want to offer a bit more than just a manual, so we will point out references along the way.

References

Monteiro, Rafael. 2020a. “Data Repository for the Paper ‘Binary Classification as a Phase Separation Process’.” Zenodo Repository. https://dx.doi.org/10.5281/zenodo.4005131; Zenodo. https://doi.org/10.5281/zenodo.4005131.

Monteiro, Rafael. 2020b. “Source Code for the Paper ‘Binary Classification as a Phase Separation Process’.” GitHub Repository. https://github.com/rafael-a-monteiro-math/Binary_classification_phase_separation; GitHub.

  1. This tarball contains all the 3 notebooks, and also the two modules used.↩︎