PelvisVR Server

Server docker container for the PelvisVR percutaneous pelvic surgery simulator.

The PelvisVR client is located here.

The server is responsible for:

• Loading patient mesh and annotation data (patientloaderd.py)
• Generating DeepDRR projections (deepdrrd.py)
• Providing a global time reference (timed.py)
• Logging all user interactions and collected DeepDRR projections for future analysis (loggerd.py)

Requirements

• Computer running Windows or Linux and GPU with CUDA support and >11GB of VRAM

Installing Docker

Please follow the official Docker installation guide based on your operating system:

• Docker Desktop for Windows
  • Note: Avoid using Docker Desktop version 4.17.1 due to known issues. Refer to this issue for details.
• Docker Desktop for Linux

Setting Up the Environment

Open your terminal or command prompt and navigate to the root directory of the vrpelvisim-deepdrr-zmq repository.

1. Create a .env file in the root directory:

   touch .env

2. Open the .env file and add the following environment variables:

   # .env
   DOCKER_PATIENT_DATA_DIR="C:/path/to/patient/data"
   DOCKER_LOG_DIR="C:/path/to/logs/"

Running the Application

Open your terminal or command prompt and navigate to the root directory of the vrpelvisim-deepdrr-zmq repository.

1. Pull the latest Docker image for the vrpelvisim-deepdrr-zmq application:

   docker pull ghcr.io/arcadelab/vrpelvisim-deepdrr-zmq:main

2. Start the application using Docker Compose:

   docker compose up -d --no-build

Documentation

• API