Skip to content

This tool can support dermatological clinic work by evaluating a patient's moles to identify outlier lesions or “ugly ducklings” that are most likely to be melanoma.

License

Notifications You must be signed in to change notification settings

jpvt/melanoma-detection

Repository files navigation

Melanoma Detection Tool

Skin cancer is the most prevalent type of cancer. Melanoma, specifically, is responsible for 75% of skin cancer deaths, despite being the least common skin cancer. The American Cancer Society estimates over 100,000 new melanoma cases will be diagnosed in 2020. It's also expected that almost 7,000 people will die from the disease. As with other cancers, early and accurate detection—potentially aided by data science—can make treatment more effective.

This tool can support dermatological clinic work by evaluating a patient's moles to identify outlier lesions or “ugly ducklings” that are most likely to be melanoma.

The data used to train the Deep Leaning model was taken from: SIIM-ISIC Melanoma Classification

Prerequisites

  1. Linux or MacOS

⚠️ Warning: this installation was only tested on Linux.

  1. docker - Get docker

  2. git, git lfs installed by your distribution Linux or MacOS (e.g. using HomeBrew)

  3. Port 12000 available in the environment host

Install and Use

  1. Install git-lfs
foo@bar# mkdir lfs && cd lfs && wget https://github.com/git-lfs/git-lfs/releases/download/v2.13.2/git-lfs-linux-amd64-v2.13.2.tar.gz
foo@bar# tar -xzvf git-lfs-linux-amd64-v2.13.2.tar.gz
foo@bar# sudo ./install.sh
foo@bar# git lfs install
  1. Install docker and check installation. It should be possible to execute the image hello-world, the output should be something like this:
foor@bar# docker run hello-world

Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
 1. The Docker client contacted the Docker daemon.
 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
    (amd64)
 3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
 4. The Docker daemon streamed that output to the Docker client, which sent it
    to your terminal.

To try something more ambitious, you can run an Ubuntu container with:
 $ docker run -it ubuntu bash

Share images, automate workflows, and more with a free Docker ID:
 https://hub.docker.com/

For more examples and ideas, visit:
 https://docs.docker.com/get-started/
  1. Clone the repo:
  • SSH
foo@bar# git clone git@github.com:jpvt/melanoma-detection.git
  • HTTPS
foo@bar# git clone https://github.com/jpvt/melanoma-detection.git
  1. Prepare the script setup.sh to execution.
foo@bar# cd melanoma-detection
foo@bar# chmod a+x setup.sh
  1. Execute setup.sh
foo@bar# sudo ./setup.sh
  1. Use the Melanoma Detection Tool. Just access http://0.0.0.0:12000/ in your browser and upload an image to see the model prediction. The prediction represents the probability of an image being of a melanoma.

Author

João Pedro Vasconcelos
github.com/jpvt

Computer Engineering undergrad student at Universidade Federal da Paraíba

Hey, I'm João Pedro.

I'm from São Paulo, Brazil. Though, I have spent most of my life where I currently live João Pessoa, Brazil.

I'm a Computer Engineering Undergrad student at the Federal University of Paraíba, and a Machine Learning Researcher at ArIA - Artificial Intelligence Applications Laboratory, where I've been studying Artificial Intelligence for the past months.

I'm also the Co-founder and Vice president of TAIL (Technology and Artificial Intelligence League). We're a research group, made by students, focused on spread knowledge on our region. Our primary goal is to construct a strong community of Artificial Intelligence developers.

Outside of computer science, I enjoy reading Sci-fi, traveling, playing Dungeons & Dragons, and caffeine :)

Background in: Python, C/C++, Julia, Machine Learning, Deep Learning, Computer Vision, Reinforcement Learning, and Natural Language Processing.

Links:


Support

Reach out to me at one of the following places!

  • Email joaoteixeira@eng.ci.ufpb.br
  • Linkedin at jpvt

About

This tool can support dermatological clinic work by evaluating a patient's moles to identify outlier lesions or “ugly ducklings” that are most likely to be melanoma.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published