Step #2: Download Data

For each dataset a user elects to use, the user is responsible for checking if the dataset license is fit for their intended purpose.

To use the 2021 dataset on Launchpad, you will need to sign up for the challenge, get the Synapse ID of the zipped training dataset and obtain a personal access token for the Synapse platform.

Signing up for the Challenge

Register for Brain Tumor Segmentation Challenge Task 1 by creating an account on the Synapse platform
Follow the instructions in Access the Training Data section of the site
1. Click Register for challenge
2. Fill out the google form for registration
  - Put n/a for not applicable questions such as challenge team name, research group and principal investigator
3. Join the BraTS Challenge Participants team on Synapse to get access to the Synapse data from the email invitation
  - Check your junk mail if it has not been receieved
You should now have access to the Synapse data here
Find the Synapse ID for the training data (syn25956772)
Go to your account settings → personal access tokens
Create and save a new access token with permission to view and download the data

Save the Synapse ID and API key in a notepad. It will be used later in this step.

Upload onto workspace

Important

This part of the lab will need to be completed using the desktop that is accessible from the left-hand navigation pane.

Log into NVIDIA NGC by visiting https://ngc.nvidia.com/signin
Expand the Base Command section by clicking the downward facing chevron and select Dashboard
Click Create Job.
Select your Accelerated Computing Environment (ACE)
Set the instance size to dgxa100.80g.1.norm
Select the Workspaces tab, select the workspace you created in step 1, and set the mount point to /mount/workspace
Set the result mountpoint to /results
Select the nv-launchpad-bc:brats-monai-lab container from the dropdown and the 1.0 tag

Enter the command below in Run Command to start up JupyterLab

Copy
Copied!

            
            jupyter lab --ip=0.0.0.0 --allow-root --no-browser --NotebookApp.token='' --notebook-dir=/ --NotebookApp.allow_origin='*'

Adding ports here exposes them and automatically maps them to a URL provided once the container starts running. To access the JupyerLab enter 8888 and click Add
Rename the job to download-brats-2021-dataset.

Note

Once you have filled in all the required fields, you can copy the command at the bottom of the Create Job page and paste it into your terminal to run the job via the NGC CLI tool.
Once your job has entered the Running state, you should see a green link in the overview section
Click the link to open the JupyterLab
Open the terminal on the Jupyter Notebook

Run the commands below in the terminal to download synapse into your workspace

Copy
Copied!

            
            cd /mount/workspace;
pip3 install synapseclient -t /mount/workspace;
export PYTHONPATH=/mount/workspace;

Run the following command in the terminal updating <username>, <api key>, and <synapse id> with your appropriate values.
Copy

Copied!
```
            
            /mount/workspace/bin/synapse -u <username> -p <apikey> get -r <synapse id>;
        
```

Run the following commands to unzip the dataset and create the dataset.json needed for integration with the MONAI dataset class

Copy
Copied!

            
            unzip RSNA_ASNR_MICCAI_BraTS2021_TrainingData_16July2021.zip -d /mount/workspace;
mv RSNA_ASNR_MICCAI_BraTS2021_TrainingData_16July2021 /mount/workspace/brats2021;
python3 /workspace/brats-monai-curated-lab/generate_dataset_json.py

Once the commands have finished running, go back to the job