NoteBooks

Notebooks for Clara Train SDK

This is a set of multiple notebooks which walks you through Clara train SDK features.

Notebooks for V4.1

1. Getting Started
   1. Getting Started
   2. Bring your own component BYOC
2. AI Assisted Annotation (AIAA):
   1. Basics
3. DataSets
   1. Download Decathlon Dataset
   2. Download from National Cancer Archive
4. AutoML
   1. AutoML Basics

Notebooks for V4.0 (to be updated to v4.1 soon)

1. AI Assisted Annotation (AIAA): 2. Train Deepgrow (2D and 3D) 3. OHIF Integration
2. Federated Learning
   
   1. Federated learning
   2. Provisioning Notebook
   3. Client Notebook
   4. Administration of FL experiment
   5. Bring your own Component to FL
   6. Homomorphic_Encryption
   7. Bring your own Trainer to FL
3. AutoML 2. AutoML BYOC
4. Domain specific Examples:
   1. Digital pathology

Pre-requisites

1. Nvidia Pascal or newer GPU. (2+GPUS are recommended for advanced features as AutoML).
2. If you already have docker installed then user should be in the docker group. Otherwise, sudo is needed to install the pre requisite

This NoteBooks contain:

1. Scripts to:
   1. Install pre-requisite as Docker 19, docker compose
   2. Start pulling the clara docker and run jupyter lab.
2. SampleData: To start using the sdk.
3. Multiple Notebooks to show show all capabilities of the sdk

Getting started

1. Install cuda nvidia drivers / Trouble Shooting Cuda

You should skip this step, if you already have cuda and nvida driver. To check simply run nvidia-smi

If you don't have nvidia drivers / cuda installed or you do get a cuda lib mismatch when running nvidia-smi as

nvidia-smi
Failed to initialize NVML: Driver/library version mismatch

then you need to do the following steps

1.1- Remove drivers

sudo apt-get --purge remove "*nvidia*"
sudo apt autoremove

1.2- Reboot

reboot using

sudo systemctl reboot

1.3- Install cuda

Got to https://developer.nvidia.com/cuda-11.0-download-archive?target_os=Linux pick your os and hardware and follow instructions

1.4- Reboot again

you need to reboot again after installing cuda

sudo systemctl reboot

1.5- check Nvidia-smi

run nvidia-smi should show you the gpus you have on your system

2. Install pre-req

If you already have docker 19+, nvidia docker, and docker compose you can skip this step. Otherwise, you can install docker and docker compose using script provided by

cd scripts 
sudo installDocker.sh

3 Start Docker image

To begin, go into the scripts folder

cd scripts

from here you can just start either:

1. ./startClaraTrainNoteBooks.sh to start docker compose of Triton used by AIAA and clara train container
2. Only clara train container for training, AutoML and FL workflow

3.1 Start Docker-Compose

run command below which will pull and start the latest clara train SDK and Triton server for AIAA.

./startClaraTrainNoteBooks.sh

You can now go to your browser on port 3030 and use the token printed out as below

[I 23:47:18.654 LabApp] http://claratrain:8888/?token=3e5ef35f982ea5a3e432322b07b6d33b5fc51a4fcb0ffa88
[I 23:47:18.654 LabApp]  or http://127.0.0.1:8888/?token=3e5ef35f982ea5a3e432322b07b6d33b5fc51a4fcb0ffa88

3.1.1 Customize docker compose

You should edit the docker-compose.yml file in case you want to:

• start jupter lab on different port than 3030
• change the AIAA port as

ports:
  - "3030:8888"  # Jupyter lab port 
  - "3031:5000"  # AIAA port

To expose certain gpus to Triton please uncomment lines at the end of the docker-compose file

capabilities: [ gpu ]
# To specify certain GPU uncomment line below
#device_ids: ['0,1']

• Install gpu monitoring tools for jupyter lab. You can install gpu monitoring tools (see step 5) by changing the line

##### use vanilla clara train docker 
#image: nvcr.io/nvidia/clara-train-sdk:v4.0
##### to build image with GPU dashboard inside jupyter lab 
build:
  context: ./dockerWGPUDashboardPlugin/    # Project root
  dockerfile: ./Dockerfile                 # Relative to context
image: clara-train-nvdashboard:v4.0

3.2 Start Docker only

If you don't plan to use AIAA then only running clara train container without triton is sufficient. For this you need to run

startDocker.sh

4. Open Browser with given token

Now you can go to your browser on the port you specified above (default is 3030) with the token provided in the terminal. You should see jupyter lab where you should start running the Welcome Notebook. This page shows all notebooks available as

5. Activating GPU Dashboard (optional)

Before starting, we need to activate the GPU Dashboard. Look at the left sidebar and click on System Dashboards.

Next, click on GPU Utilization, GPU Memory,GPU Resources, and MachineResources. All of these will open in new tabs. Click and hold on GPU Utilization tab and drag it to the right most area of screen. It will dock the tab on top of the notebook. Follow the same procedure with GPU Memory tab and docker it on the bottom right of screen. The result should be similar to

Now we can see GPU Utilization and GPU Memory while we run through the notebooks.