Pre-op FL Study

This is the documentation for the Federated Learning Study conducted for pre-operative gliomas.

Home
Application Setup
Process the Data
Run the Application
Extras
ITCR Connectivity

Application Setup

Table of Contents

Requirements

Windows

Since FeTS is Linux-only at the moment, Windows users will need to enable Windows subsystem for Linux (WSL). Here are some detailed instructions to get WSL to recognize the NVIDIA GPU:

Back To Top ↑

Set up the Environment

If you run into the following error (or something similiar, related to the cryptography package):

Command "python setup.py egg_info" failed with error code 1 in /tmp/pip-build-m0u0eez3/cryptography/

Run the following commands for the solution:

cd ${fets_root_dir}/bin/OpenFederatedLearning
./venv/bin/python3 -m pip install -U pip
make install_openfl
make install_fets
cd ../LabelFusion
./venv/bin/python3 -m pip install -U pip
./venv/bin/pip install .

Note for Ubuntu 20.04 users

We have not tested with Ubuntu 20.04 and there might be unforseen stability issues with dependencies. That being said, if there is no other way around it, there are some pointers that can be followed to get FeTS up and running on this platform:

echo "deb http://archive.ubuntu.com/ubuntu xenial main" | sudo tee /etc/apt/sources.list.d/xenial.list
sudo apt-get update
sudo update-alternatives --remove-all gcc
sudo update-alternatives --remove-all g++
sudo apt-get install gcc-5 g++-5
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-5 10
sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-5 10

Optional instructions for Federation backend

These commands are run along with the installer, but in case you receive an error during the python environment setup, please follow these instructions:

cd ${fets_root_dir}
cd bin/OpenFederatedLearning
make install_openfl 
./venv/bin/pip install opencv-python==4.2.0.34 # https://stackoverflow.com/a/63669919/1228757
make install_fets
# after this, the federated backend is ready
./venv/bin/pip install -e ./submodules/fets_ai/Algorithms/GANDLF # gandlf
cd ../LabelFusion
python3 -m venv venv
./venv/bin/pip install -e . # label fusion

Back To Top ↑

Set up the Collaborator

NOTE: We are currently working on a follow-up study, and we will be releasing new information on how to perform certificate signing soon!

Back To Top ↑


Next: Process Data