Getting Started with BrainSTEM
Table of contents
- Create or Join a Group
- Create Your First Project
- Create Your First Subject
- Create Your First Session
- Build Your Own Experiment
Create or Join a Group
Before you can start using BrainSTEM, you need to either create a new group for your lab or join an existing one. Groups in BrainSTEM help organize lab members and manage permissions for projects and resources.
Accessing Groups
- From your dashboard, locate and click the Users icon in the top right corner of the screen
- Select Groups from the dropdown menu
Managing Group Membership
Once on the Groups page, you have two options:
Option 1: Create a New Group
If your lab doesn’t have a group yet:
- Click the Add group button in the top right corner
- Fill in the required information for your new group
Option 2: Join an Existing Group
If your lab already has a group:
- Click on the group name from the list of available groups
- On the group’s detail page, click the Request membership of group button
- Wait for a group manager to approve your request
Managing Group Membership Requests
For group managers:
- Click the Users icon in the top right corner
- Select Requests & Invitations
- Navigate to the Group membership requests section
- Review and accept requests from your lab members
Labs should coordinate among their members to ensure proper group management. It’s recommended to have at least two group managers per lab.
Create Your First Project
After joining or creating a group, you can start creating projects. Projects in BrainSTEM are containers that help organize your research data, including subjects, datasets, and collections.
- Click on Projects in the left navigation menu
- Click the Add project button in the top right corner
- Fill in the required project information
For detailed information about project fields and structure, see the Project data model.
Create Your First Subject
Once you have created a project, you can start adding research subjects. Subjects in BrainSTEM represent the experimental animals in your studies.
- Click on Subjects in the left navigation menu
- Click the Add subject button in the top right corner
- Fill in the required subject information
For detailed information about subject fields and available options, see the Subject data model.
Remember to associate your subject with the correct project(s) to ensure proper access and organization of your research data.
Create Your First Session
After adding subjects, you can create sessions to record your experimental data. Sessions in BrainSTEM help organize your experiments chronologically.
- Click on Sessions in the left navigation menu
- Click the Add session button in the top right corner
- Fill in the required session information
For detailed information about session fields and options, see the Session data model.
Sessions inherit permissions from their associated projects. Make sure to select the correct project to enable proper access for your team members.
Build Your Own Experiment
BrainSTEM uses Personal Attributes and Modules to document your experimental procedures. Below is a recommended order for setting up your experiment components.
Available Components
Personal Attributes:
Modules:
Recommended Setup Order
- Create experimental setups to define your physical experiment environment
- Define behavioral paradigms for your experimental tasks
- Set up data storage locations to organize your data files
- Set up inventories to track your lab resources
- Add procedures (e.g., surgeries, implants, injections)
- Configure equipment installations in your setups
- Set up behaviors to describe subject tasks
- Define manipulations for experimental interventions
- Configure data acquisition parameters
- Begin tracking with action logs and subject logs
The exact order may vary based on your specific experimental needs. Some components can be set up in parallel or may not be needed for every experiment.
This order ensures dependent components are created first. For example, behaviors need experimental setups and behavioral paradigms to be defined first.