Create your own algorithm

This tutorial takes you through the steps to serve your algorithm in a Docker container compatible with the requirements of grand-challenge.org. We focus on creating a Docker container to perform inference with your algorithm on test data, but most instructions apply to any algorithm.

Wrapping your algorithm in a container ensures that the environments necessary for reproducing your algorithm are packaged along with the algorithm. This is the fastest and the most reliable way to reproduce algorithms. We chose Docker as this is the most popular and widely used technology for creating containers.

Before you start

To follow the tutorial, make sure you have the following software packages installed on your computer:

💡 Windows tip: It is highly recommended to install Windows Subsystem for Linux (WSL) to work with Docker on a Linux environment within Windows. Please make sure to install WSL 2 by following the instructions on the same page. In this tutorial, we have used WSL 2 with Ubuntu 18.04 LTS. As of writing this tutorial, the latest version of WSL2 on Windows 11 comes with GPU support. Please watch the official tutorial by Microsoft on installing WSL 2 with GPU support. The alternative is to work purely out of Ubuntu, or any other flavor of Linux.

Video tutorial

Apart from reading through the tutorial in the sub-tabs of this section, you can also watch the corresponding video tutorial. It provides a walkthrough of the entire process for creating an algorithm container for the DRIVE Challenge using evalutils. However, note that this video tutorial was made with evalutils v0.2.4. The rest of the written documentation here is based on evalutils v0.3, including updated documentation for testing your containers locally!

Clone the repository containing the U-Net that segments retinal blood vessels from the DRIVE Challenge and then watch the video.

$ git clone https://github.com/DIAGNijmegen/drive-vessels-unet.git 



Contact

For contact and support, please email kiranvaidhya.venkadesh@radboudumc.nl and cc support@grand-challenge.org.

Disclaimer
Icons made by Freepik from www.flaticon.com