Skip to content



This is a draft

Introduction to brainlife.

This page highlights the most important first steps to using, including creating an account and project, interacting with datasets, launching processes, visualizing results, and creating pipelines. If you have not read the documentation regarding these topics, please visit


A. Create an account.

The first step to processing data using brainlife is to go to and create an account.

To do make an account and project, follow the following steps:

  1. Enter enter your browser web address.
  2. Once on the homepage, click the 'signup' button in the top left corner.
    • Enter the following information on the signup page:
      • username
      • email
      • password
      • full name
      • institution/university
      • biography
      • position (undergraduate student)
  3. Read the usage policy and select the 'Agree to our Acceptable Use Policy' box and hit submit

B. Create a Project.

Next we will start managing some data on the platform by creating a Project.

  1. (Go to the home page)[] and click on 'home.' This will bring you inside the platform.
  2. Click the 'Projects' tab on the left side of the screen (shield icon).
  3. Click the '+' button at the bottom right corner of the screen.
    • Enter the following information on the My Project page:
      • name
      • description
      • Public access policy
      • In 'administrators', add the following accounts (if you start typing a name the systemw ill autocomplete for you):
        • Brad Caron
        • Soichi Hayashi
        • Franco Pestilli
    • Click submit.
  4. Return to the projects page and select your newly created project.

You are now ready to copy data from another project!

C. Copy data from another project.

The next step will be to copy data into your project. For that, we will use open data from another project.

To copy data from an open project follow the steps below.

  1. Go to the main page of your project.
  2. Click on the 'Processes' tab.
  3. Once inside the Processes tab, click the '+' button at the right-hand bottom of the screen. Add a new process and name it 'temp copy data' in the projects description tab. Processes Page

  4. Select the newly created process and hit the 'Stage Data' button at the bottom right corner of the screen.

    • For from, select the 'IU LAB IN COGNITIVE AND COMPUTATIONAL NEUROSCIENCE - Demo Data' project to pull data from.
    • For subject, enter BC
    • For datatype, you will select a single anatomical file this is a T1-weighted MRI (T1w). The Datatypes is called: neuro/anat/T1w
    • For data-object, click the drop down menu and select the appropriate data. Since there's only 1 T1, the correct dataset should auto-populate.
    • Hit OK.

Import Data From Other Project

The data is now staged and ready for processing!

D. Launch a process, application (app), visualize and archive the results.

The next step is to launch an application (app) in order to process the data. For this, we will process the T1w (anatomical) image staged in C. In this tutorial, we will divide (i.e. segment/parcellate) the T1 anatomical image using Freesurfer.

First we will need to To launch a process, follow the following steps:

  1. On the 'Processes' tab, make sure the process generated in part C. is selected.
  2. Click on the 'Submit App' button at the bottom right of the screen. This will launch a page with the many applications (apps) that can be used on your staged data.
  3. In the searchbar, type 'Freesurfer' and click on the app card. This will open a page with options for choosing which project to save the results and specific input parameters that may affect the outputs of the app.
  4. For now, leave all the inputs and parameters as is. We will discuss what these options do in later tutorials.
  5. Hit OK.

Once the app is launched, a card will appear on the 'Processes' tab with a blue header. This means the app is currently running, or waiting to run. Blue-header

Once this turns green, that means the app is finished and you can view the results! Green-header

To view the results:

  1. Click the eye icon next to the output and choose 'Freeview' as your viewer.

This will automatically load important outputs generated by Freesurfer, including cortical and white matter surfaces and a standard parcellation of the cortical surface.


In order to make sure the generated data does not get deleted over time, we need to save (i.e. archive) the data. Archived data can be viewed and staged via the 'Archive' tab on the Projects page. There are two ways to archive data on one when submitting the app, and one after the app is completed.

To archive the data automatically once the app is finished running, follow the following steps:

  1. After step 4, click the box next to the option 'Archive all output datasets when finished'. This will save (i.e. archive) the data immediately following completion of processing.


To archive the data after the app is completed and you've reviewed the results, follow the following steps:

  1. In the 'Output' section, selec the file drawer icon on the far right of the screen.
  2. Hit OK'.


You've now successfully created an account and project, copied data from an open project, and launched an application and processed your first MRI data on!!!!