Datasets
Datasets page of the Data Browser allows users to store, organize and share data. It is organized into
- Navigation menu (Left Panel) - enables users to efficiently locate and filter data
- Datasets table (Main Section) - displays all the datasets that the user has at least read access to.
All Datasets displays all datasets that the user has at least read access to. Depending on permissions, these may include
- User's datasets
- Datasets of other lab members
- Collaborator's data sets
Public datasets are visible as well.
My Collections contains collections created by the user that fall outside of existing projects
- Users can create multiple collections to manage datasets
Project shows all the projects that the user has at least read access to.
- Datasets can be added to “Default ProjectName Collection”, which is auto-generated
- Alternatively, the user can create studies inside the project to further organize the data
Study can only exist under a project
- Datasets can be added to “Default StudyName Collection”, which auto-generated
- Alternatively, the user can create dataset collections inside the study to further organize the data
- the study may contain multiple dataset collections
- the study may contain datasets that are ungrouped under a collection
Datasets Table
The Datasets Table displays all the datasets that the user has at least read access to.
Display Name/ Dataset Name
Display Name displays user-defined experiments names. Dataset Name is the original name of the experiment as it was recorded on the spectrometer.
Display Name column
- is always visible in the Datasets Table
- is editable if the user has write access to the dataset.
Dataset Name column
- is not visible by default but can be toggled on
- is not editable
When a user downloads an experiment, it will be saved using the Dataset Name (original experiment name).
- The corresponding Display Name can be found in a CSV file located in the downloaded experiment’s folder.
How to customize the Datasets Table view
To customize the view of the Datasets Table
- Click on the "Wrench" Icon in the top-right corner of the table
- Click on the "Displayed Columns" button and select which columns you want to be visible in the Datasets Table
- Click the "Save View" button
- The saved views can be edited and deleted
- The user can create multiple views
- To switch between different views click on the "Saved Views" button
How to download experiments
To download experiments
- Navigate to the Datasets section of the Data Browser
- Locate the experiments you want to download
- Click the "Checkbox" icon to select multiple experiments.
- Alternatively, right-click on a single experiment to automatically select it
- Right-click and select "Download" option form the context menu
- Choose data organization format:
- Organized for Topspin
- If the datasets are in Bruker format you can download it structured for Topspin
- The Topspin hierarchy of the data, including all folders/subfolders, will be preserved
- Organized by experiment
- Each experiment will be in a separate folder
- Organized for Topspin
How to link datasets to a sample
There are two ways of linking datasets to a sample.
- Through editing the dataset
- Double click on the dataset that you have write access to
- In the appeared pop-up window, click on "Find & Link Sample"
- Choose the sample from the table of available samples
- Click "Save" to confirm the link
- Through Datasets Table
- Select one or more experiments you wish to link to a sample
- Right-click and choose "Link sample" option form the context menu
- Choose the sample from the table of available samples
- Click "Save" to confirm the link
Quick Filters
Quick filters are predefined views that allows users to quickly access specific datasets. The user can apply one or more filters:
- Successful Datasets Only – displays datasets classified as successful
- To classify a dataset, right-click on it and select "Classification" from the context menu
- Hide Failed Datasets – hides datasets that were classified as failed
- Non-Redundant Datasets – displays datasets marked as preferred
- To mark a dataset as preferred/redundant, right-click on it and select "Redundancy" from the context menu
- My Data – displays datasets owned by the logged-in user
- Non-public Data – displays datasets that have not been made public
- KB Datasets - display datasets that have been published in a knowledgebase
Right-clicking on a dataset opens the Context menu which provides various actions that users can perform on the selected dataset. The available options depend on the user's permissions for that dataset, options that are not allowed will appear grayed out. The options might include:
- Edit Dataset
- Change basic information about the dataset
- Mark dataset as preferred/redundant
- Reassign
- Reassign dataset to another user within the lab
- Reject misaligned data
- User has three months to reject the data
- The rejected data are automatically assigned to the facility manager of the facility in which the dataset was collected
- Download - download selected datasets
- NMRbox Integration - copy the dataset to NMRbox
- Supplemental Data - upload supplemental data
- Redundancy - mark a dataset as preferred/redundant
- Link Sample - link the dataset to the sample that has been created in the Samples section of the Data Browser
- Name of the sample and a link to its information will appear in the Sample Column of Datasets Table
- Classification - classify dateset as
- Calibration experiment
- Failed - sample related
- Failed - instrument related
- Failed - setup related
- Succesful Experiment
- Test experiment
- Tags - assign tags to categorize the dataset
- Notes - add or update dataset notes
- Unlink from Collection - if the dataset is linked to a Dataset Collection, the user can unlink it
- Make Public - make the dataset public. This is a PERMANENT option and can't be undone.
- Publish - publish dataset. The published datasets can't be edited. This is a PERMANENT option and can't be undone.
