PDataViewer

PDataViewer is a web application that lets you explore the PD data landscape and identify cohort datasets that suit your research needs.

• PDataViewer
  • Introduction
  • Requirements
  • Installation
    • Clone the Repository
    • Install the Backend Requirements
    • Install the Frontend Requirements
  • Usage
    • Starting the Backend Locally
    • Run the Backend via Docker
    • Starting the Frontend Locally
    • Run the Frontend via Docker
    • Run both the Frontend and Backend via Docker

Introduction

Data collected in cohort studies lay the groundwork for a plethora of Parkinson’s disease (PD) research endeavors. PDataViewer lets you explore this PD data landscape and identify cohort datasets that suit your research needs. We accessed and curated major PD cohort datasets in a purely data-driven manner with the aim of:

1. characterizing their underlying data
2. assessing the quantity and availability of data
3. evaluating the interoperability across these distinct cohort datasets.

Requirements

• Python >= 3.14
• Angular == 21.x.x
• Node.js >= 20.19.0
• TypeScript >= 5.9.0

Installation

Clone the Repository

git clone https://github.com/SCAI-BIO/PDataViewer
cd PDataViewer

Install the Backend Requirements

Please consult uv documentation for uv package manager installation.

cd backend
uv sync

Install the Frontend Requirements

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
nvm install 24
npm install -g @angular/cli

Usage

Starting the Backend Locally

You can access the backend functionalities by accessing the provided REST API.

Run the Backend API on port 5000:

cd backend
uvicorn api.main:app --reload --port 5000

Run the Backend via Docker

The API can also be run via docker.

To build the Docker container locally:

docker build -t ghcr.io/scai-bio/pdataviewer/backend:latest .

After building, you will be able to start the container and access the PDataViewer API on localhost:8000 with the following command:

docker run -p 8000:80 ghcr.io/pdataviewer/scai-bio/backend:latest

Starting the Frontend Locally

You can deploy a local version of the web application via Angular CLI.

You can access the web application on localhost:4200:

cd frontend
npm install
ng serve

Run the Frontend via Docker

To build the Docker container locally:

docker build -t ghcr.io/scai-bio/pdataviewer/frontend:latest .

After building, you will be able to start the container and access the PDataViewer web application on localhost:8080 via the following command:

docker run -p 8080:80 ghcr.io/scai-bio/pdataviewer/frontend:latest

Run both the Frontend and Backend via Docker

You can deploy a local version of the API and the web application together.

1. Ensure Docker Compose is Installed: Make sure you have Docker Compose installed on your machine. You can verify this by running:

   docker-compose --version

2. Navigate to the Root (PDataViewer) Folder

3. Build and Run the Containers:

   docker-compose up --build

4. Verify that the Containers are Running:

   docker ps

This command lists all running containers. You should be able to see your containers with the name pdataviewer-frontend, pdataviewer-backend, and postgres:18.

You can access the web application on localhost:3000 and the API on localhost:5000