Researched & Developed By: Nuvin Godakanda Arachchi
Fibro-QuanNet is a Pulmonary Fibrosis Prognosis Prediction application utilizing Quantum Machine Learning to accurately predict the likely prognosis of PF (Pulmonary Fibrosis).
This code was developed as partial completion of my BEng (Hons) Software Engineering degree program at the University of Westminster.
The full thesis paper can be found on ResearchGate.
More information into the project can be found on my Fibro-QuanNet repository.
This application utilises a Quantum Varariational Circuit as a layer on a Classical Multiple Quantile Regression machine learning model, which has proven (through the thesis linked above) to increase model accuracy and robustness measured through Laplace-Loglikelihood evaluation matrix and MRSE and MSE scores.
The model utilises the OSIC Pulmonary Fibrosis Dataset for training and basic testing of the model performance.
- Data
- Software
- Windows/ Mac/ Linux Operating System
- Python 3
- NodeJS
- Hardware
- Intel Core i7 (10th Gen)/ Apple M1 Pro or higher
- Quantum Hardware
- IBM Quantum (Provided through IBM-Quantum Labs/ PennyLane)
- Google Cirq (Provided through Cirq/ PennyLane
For a more comprehensive set of requirements, refer to Chapter 3 in the full paper, available through Fibro-QuanNet repository or DOI.
The application consists of three main components
-
quantum-notebook
- The Jupyter Notebook file for the models development (Using JetBrains: DataSpell) -
fibro-quannet-frontent
- The JavaScript based React frontend application (Using Visual Studio Code) -
flask-server
- Python based Flask API gateway (Using Visual Studio Code)
How to work with and run each component will be explained below.
The notebook acts as a simple Jupyter Notebook, run using JetBrains:
DataSpell (Ultimate Edition) using anaconda3
and
python3
. In order to run the notebook and recreate
the results, follow the following steps:
-
Add the OSIC Pulmonary Fibrosis Dataset
into the
osic-pulmonary-fibrosis-progression
folder -
Add the OSIC Cached Dataset (Latency Encoded)
available through Kaggle into the
osic-cached-dataset
folder.
If you wish to train the model, you will need to run the notebook
from the imports and generate the neccessary weight exports (output
on to the working
directory).
This is a React-JS application, thus the normal steps to run a react app using NPM would work here.
Install the node-modules initially, and npm run start
to
start the localhost server.
Make sure you have already started the Flask-Server before starting the React App
This is also a basic flask server application. The virual envioronment
venv
can be source activated and have the
server.py
hosted.
This codebase has been submmitted to the Turn-it-in global referencing scheme in 2023. Thus, utilizing this code directly in any acedemic work can result in plagiarism.