Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Create your own project 

  • Explore the project dashboard

  • Add a description to your project in the wiki

  • Share your work with other Synapse users, teams, or the public

Prerequisites

Anyone can browse public content on the Synapse website, but to create content using this tutorial, you will need to register for an account using your email address. You will receive an email message for verification to complete the registration process.

To upload files to Synapse, you will need to perform the additional step of becoming a certified user. Because Synapse stores data from human subjects research, Sage Bionetworks requires that you demonstrate understanding of privacy and security issues. You can complete your certification by taking a short certification quiz on Synapse.

Creating a Project

Projects are the main “containers” where information is stored and organized in Synapse. They are online workspaces where you can collaborate and share your work with teammates. Projects can be shared with individuals, small teams, or large consortia. Projects can be private so only you and your team can see what’s inside, or they can be shared publicly for anyone to browse.

...

Synapse will automatically open your new project so you can view your project dashboard.

Exploring the Project Dashboard

Your project dashboard allows you to see the different elements of your project at once. At the top of the project page, you can click the green star next to your project name to add it to a list of favorites.

...

  • Wiki - A wiki is like a virtual notebook where you can describe your research so others can understand your goals, methods, or anything else you want to communicate about your project. See Wikis /wiki/spaces/DOCS/pages/1975746682 to learn more.

  • Files - This tab contains a directory of all of your files and folders within this project. Use this tab to see the hierarchy or structure of information as you add it. See Files and Folders for more.

  • Tables - This tab contains tabular data. You can upload data tables or create them directly from the Synapse interface. You can also use this tab to create views, which are tables of other data in Synapse. See the Tables /wiki/spaces/DOCS/pages/2011038095 and /wiki/spaces/DOCS/pages/2011070739 articles for more.

  • Discussion - Use this tab to communicate with teammates in a /wiki/spaces/DOCS/pages/1985904796.

  • Docker - Docker is a platform for creating virtual containers to bundle code and other dependancies. You can add a Docker container to a project and share it with your teammates. Learn more about /wiki/spaces/DOCS/pages/2011037752.

Adding a Project Wiki

A wiki is a virtual document that can be edited by multiple people on the web. Wikis are powerful tools to add information about your project, and Synapse offers over a dozen widgets to customize your wiki pages. Use wikis to provide descriptions of your project goals, methods, and data.

...

  1. Click on the Wiki tab and use the Wiki Tools menu.

  2. Choose Edit Wiki to add or edit wiki content.

  3. From the editing window, click Preview to check your work. Click Save when you are finished.

Read more about wikis /wiki/spaces/DOCS/pages/1975746682 for more information on how to organize and customize your wiki content.

Sharing and Teams

By default, your project and anything inside it are private, so only you can see it. However, you can share an entire project with specific users, teams, or make it public so anyone can browse your content. If you’d like to share your project with others, see the article on sharing and accessing data /wiki/spaces/DOCS/pages/2014904611 to understand how Synapse can help you control access to your data.

...

Anything inside your project will automatically inherit the same sharing settings as the project itself. In other words, if your project is public, then all of the contents within the project will also be public. If needed, you can change these settings so that certain files or folders are only shared with specific groups of users. For more details, read about Sharing settings/wiki/spaces/DOCS/pages/2024276030 and /wiki/spaces/DOCS/pages/2030502408.

Continue learning about Synapse with Quick Start: Files and Folders /wiki/spaces/DOCS/pages/2058846522.

For information on using Synapse programmatically, see the documentation for the Python clientcommand line client, and R client

...