Skip to main content

​
Steps to get started

1

Sign in

Navigate to https://dap.cosmosid.com/ in your browser. You can log in through your Cosmos-Hub email address and password, or through SSO with your corporate or academic email address.Login Dap 1
2

Set up or join a workspace

A Workspace is a shared environment where your team can organize, manage, and collaborate on microbiome research projects, with all relevant data and bioinformatics tools centralised in one place.
Image
  • Starting fresh? Create a new workspace by clicking the + New Workspace button in the top-right corner of the Workspaces Dashboard, give it a name and invite team members to collaborate.
  • Invited to collaborate on an existing workspace? Select any workspace in the Workspaces dashboard that your organization has made available or that has been shared with you.
3

Create or join a Study to organize your research project

Studies Dashboard
  • Create a new study with the + New Study button at the top of the current workspace interface.
  • Join an existing study by selecting any of the studies available in the current workspace.
4

Import 'omics data into a Study

Omics data tables are the starting point of any microbiome analysis. Once a study is created, it’s time to import data into it. You can import data from Cosmos-Hub Pipelines or use data already available in the workspace to build a cohort.
Importdata Dap
Joined a study that already has data? Skip to step 5 and start building your Cohort and Analysis Project.
There are two routes to import sample profiles into a study or workspace:
  • Import from Hub: import any profiles previously generated by the Cosmos-Hub Bioinformatic Pipelines.
    • Select Import from Hub → Hub Folder Path → select the folder containing the profiles you want to import into your Cosmos-Hub 2.0 study.
If you already have some experience with Cosmos-Hub 1.0 (now Cosmos-Hub Pipelines), you can export data directly from Cosmos-Hub Pipelines into a Cosmos-Hub 2.0 workspace. See Exporting Data from Cosmos-Hub Pipelines.
Import From Hub
  • Use existing workspace data: if you joined a workspace that already contains data, you are ready to create your first analysis.
To learn more about data import or export, see Exporting Data from Cosmos-Hub Pipelines and Importing data into a study.
5

Create your first Analysis Project and build a Cohort with the Query Builder

Assembling that cohort manually across multiple datasets can be one of the most time-consuming parts of a microbiome project. The Query Builder is designed to simplify this step by helping you identify and select the samples that match your analysis criteria.
  1. Click any study, either one shared with you or the one you created in step 4, to open its dashboard (shown below).
Inside A Study

Inside Studies: the Study Dashboard

Meet the Query Builder (QB): an AI-powered assistant that helps you querying your team’s workspace data lake to build a cohort  through an interactive experience, so you can build the right query for the cohort you need.Query Builder Dataset Selection 1Building the Cohort with the Query Builder is a hybrid experience: you can either click on the metadata filters it suggests, or type a request in natural language through the chat bar.
  • Choose your data. Click one of the suggested datasets available in the workspace (for example, Champ Taxa 1.0).
  • Explore the metadata. Ask which attributes are available and what values they contain — for example, “which body sites are represented in my cohort?”
  • Filter the samples. Ask the QB to restrict the cohort by body site, collection country, sequencing depth, or any other attribute — for example, “keep only samples from patients over 30.”
  • Select metadata columns. Choose the columns you will need for the analysis by clicking the suggestions or by typing a request such as “include Subject ID, Bodysite, Treatment group, and collection country as metadata columns.” As your conversation with the QB moves on, keep track of which filters have been applied to your dataset so far in the Active Filters panel.
Active Filters Squared
  1. When your query is ready:
    • Click Looks good — create the analysis.
    • Select the analysis modules you would like to run on the cohort.
    • Click Confirm and Create Analysis.
    Ready To Create
Filters and requests can be made at any point in the conversation with the QB. You can undo filters, apply new ones, or change the metadata columns you selected.
Your analysis then appears in the Study Dashboard, ready to be explored through the Analysis Modules of Cosmos-Hub 2.0.
6

Analyze your cohort in the Analysis Studio

  1. Navigate to the analysis you created to open its Analysis Dashboard.
  2. Click Open Current Analysis to open the Analysis Studio for the Analysis Project you just created.
Inside Analysis 2

​
The Analysis Studio

The Analysis Studio is the no-code analysis toolbox in Cosmos-Hub 2.0. It is designed to help you explore and analyze the cohort defined in an Analysis Project and create publication-ready figures and results.
Analysis Studio
  1. Choose one of the Analysis Modules currently supported in Cosmos-Hub 2.0.
  2. Customize the analysis by adjusting its parameters in the panel on the right.
  3. Click Run and Apply to run the analysis and generate publication-ready figures and results.
Don’t worry about getting it wrong: you can run the analysis as many times as you want.See Analysis Modules for detailed guidance on how to tune the parameters of each module.
7

Export and share your analysis

​
Export your analysis

Every analysis in Cosmos-Hub 2.0 produces figures and statistical results that you can either visualize on the platform or export in the format you prefer, for example to add to a slide deck.
  • Click Export to download all the figures, the parameters used for the analysis, all the input data used to perform it, and any statistical output table generated by the module.

​
Save and share Snapshots of your Analysis Project

  • Analysis Modules can be configured in many different ways, often using several parameters. When multiple people are working on the same analysis, saving the parameter configuration makes it easier to keep track of how a specific figure or result was generated.
  • To save a Snapshot of your current Analysis Project configuration, click the floppy-disk icon and select Save. The snapshot stores the current parameters and output, and is available to other collaborators in the Workspace. They can open it, review the saved configuration, and continue the analysis from that point.