An interactive web-based tool for analyzing, interrogating, and visualizing the gene-disease association on Online Mendelian Inheritance in Man (OMIM).
Explore GPAD on any modern internet browser! Whether you're on a PC, tablet, or mobile phone, our platform is optimized for your convenience.
π Read the paper!
Rahit, K.M.T.H., Avramovic, V., Chong, J.X. et al. GPAD: a natural language processing-based application to extract the gene-disease association discovery information from OMIM. BMC Bioinformatics 25, 84 (2024). https://doi.org/10.1186/s12859-024-05693-x
The paper presents the technical details with the analysis done on the GPAD extracted data.
https://youtu.be/96RzCY-91Is?si=Xd8EDn9u91MyLJEg
- OMIM API key: Request yours from the OMIM team here.
- Docker: GPAD runs in Docker containers, ensuring a consistent and isolated environment across different machines. Download Docker if you haven't already. It's a powerful tool that packages applications and their dependencies into a single container that can run anywhere, streamlining deployment and testing.
- Clone the Repository
- Use the command:
git clone git@github.com:MTG-Lab/gpad.git
- Use the command:
- Go to the Directory
- Navigate to the directory:
cd gpad
- Navigate to the directory:
- Environment Setup
- Create a
.env
file using ourexample.env
as a template. - Replace values in the
.env
file with your own. You do not have to change theMONGO_URI
if you are using docker.
- Create a
- Build and Run with Docker
- Execute:
docker compose up -d
(usesudo
if necessary/running on Linux)
- Execute:
π Post-setup, access the application at http://localhost:3001
. Initially, you'll be greeted with a blank page as there's no data yet.
GPAD leverages the OMIM API for textual data, which is then processed to extract relevant information. This is a breeze with just one command:
docker exec -it gpad_api python -m api.gpad omim
(Use sudo
if necessary/running on Linux)
β³ The data population depends on your internet speed. Be patient!
OMIM API limits 250 requests per day. Because of that all associations/entries from OMIM will not be processed in a single day. Therefore, you might need to run the above command multiple times. However, it will not process the data that is already processed. It will start from where it left off.
π Once complete, you'll see the data come to life in the application!
If you face issues, we kindly request you to submit a issue here. This will allow us to gather more information about the userβs specific system, environment and setup, enabling us to diagnose and resolve the problem effectively.