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.
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
Click Register for challenge
Fill out the google form for registration
Put n/a for not applicable questions such as challenge team name, research group and principal investigator
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.
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
Set the result mountpoint to
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
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
8888and click Add
Rename the job to
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
cd /mount/workspace; pip3 install synapseclient -t /mount/workspace; export PYTHONPATH=/mount/workspace;
Run the following command in the terminal updating
<api key>, and
<synapse id>with your appropriate values.
/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
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