/PS_Classifier

Classifier new project architecture.

Primary LanguagePython


Logo

PathoSpotter Classifier

PathoSpotter is a computational tool built to help pathologists. This repository intends to improve the already operational, yet not optimal, tool entitled Classifier. The objective when concluding this project is to have a fast and secure web page where physicians can upload their digital images of kidney biopsies and obtain a diagnosis from our trained and published neural networks.

Table of Contents

  1. About The Project
  2. Getting Started
  3. Usage
  4. Contributing
  5. Contact

About The Project

Imagine having a physician colleague, always available to give you his guesses and advices when it comes to diagnosis. This is what this tool is simulating. Our neural networks were trained to see the amyloidosis, hypercellularity, and sclerosis lesions in glomeruli. This tool by no means replaces the need of a trained physician, but intends to be a useful tool in  the nephropathology context.

Built With

Getting Started

To get a local copy up and running follow these simple steps.

Installation

This tutorial assumes you already have a valid Python instalation. If not, please check the websites above for tutorials.

  1. Clone the repo

    git clone https://github.com/Karnezis/PS_Classifier.git
  2. Create a virtual environment

    python -m venv env
  3. Activate your environment

    env\\Scripts\\activate.bat
  4. This project is built on top of some libraries. Install them with:

    pip install -r requirements.txt
  5. Now, run our project.

    python .\\src\\main.py
    
  6. Access the website in the link specified.

Usage

First, upload an image to the system. Then, click the button to submit it. Now wait for the results. Ta-da!

Tips

If you want to know more about this project, contact the authors to read the unpublished bachelor thesis in which this project is tested in latency, security, and maintainability.

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Contact

Ellen C. Aguiar - chalegreaguiar@gmail.com
Ângelo A. Duarte - angeloduarte@uefs.br
Project Link: here.