Use tags in Flywheel to annotate your data, so you can then search on and filter data based on those tags. Creating tags is a 2-step process. First create your new tags at the group level. Next, you can add those tags to containers in Flywheel.
-
Use Flywheel to add tags to: Subjects and Sessions
-
Use the Flywheel SDK to add tags to: Projects, Subjects, Sessions, Acquisitions, Analyses, and Collections
Any new tags must be created at the group level. To create new tags:
-
Sign in to Flywheel.
-
Click Groups in the left navigation menu.
-
Select a group.
-
Click the Tags tab.
-
Enter a tag name, and click Add.This tag is now available to add to other containers.
Note
-
Tag names are not case sensitive. Meaning if the tag CONTROL already exists in a group, you cannot add a control tag.
-
You can use the same tag name across multiple groups in Flywheel. When you search, all data associated with that tag name appears.
-
Editing or deleting a tag name will change it throughout Flywheel.
-
In Flywheel you can add tags to sessions and subjects. To do this:
-
Click Projects.
-
Select a project.
-
Select the Sessions tab.
-
(Optional) Click
to enable Subject View. -
Select the subject you want to tag.
-
In left panel click the Subject tab, and go to Tags.
-
Start typing a tag name. Available tag names appear in the list.
-
Continue with each subject you want to tag.
If you want to view, add, or remove tags on Projects, Acquisitions, or Analyses you must use the Flywheel SDK. Tags on these containers do not appear in the Flywheel UI.
Below is an example of interacting with session tags. See the Flywheel SDK for more information.
# See tags on a session
session = fw.get(session_id)
print(', '.join(session.tags))
# Add a tag named Control to a session
session.add_tag('Control')
# Remove a tag from a session
session.delete_tag('Analysis Required')
FAQ
-
Do tags added via the SDK appear in the UI?
Tags added to the subject and session containers appear. Tags on Projects, Acquisitions, or Analyses require the SDK to view.
- Do tags automatically get added to other containers?
Yes. Changes propagate to related projects, sessions, and acquisitions.