Searching / Downloading
An in depth overview of how to search, view, download, and delete samples, protocols, and data files.
Last updated
An in depth overview of how to search, view, download, and delete samples, protocols, and data files.
Last updated
This page allows you to search a single sample type, by a single attribute:value. In the example below, I am searching for all NHP where the Species attribute contains the value 'Macaca'.
The resulting table returns all samples that match the query. It displays the Assays, Contributor, and Attribute:Value that it found. All of the empty boxes underneath the headers are text filterable. To view the sample page of a specific sample, click on its hyperlinked UID.
The advanced search page allows for complex querying (AND/OR/NOT) across the entire database. Additionally, you can select if you want it to be partial/exact matches, or limit it to a specific sample type.
The resulting table is identical to the Simple Search page, with one additional feature: Send to Sample Retrieval. Following a search, you can select a subset of samples, and send them to sample retrieval.
On the top bar of every page, there exists a Search by UID box.
By entering a valid UID and pressing search, you automatically redirect to that sample page (assuming you have access and it is a valid UID). Remember, sample pages with lots of associated samples take longer to load.
On the SEEK website, you can either search all assets in the top search bar (Search here...) or head to Browse and select a specific asset type that you would like to search.
The first step of downloading via Search pages is to search for the samples you want to download.
When downloading samples, you must choose whether you want to download just the samples you are looking up or include all samples associated (parent/children).
In the pop-up window, it asks if you would like to download with Parents or not. By selecting NO, you will download the samples that have been selected. By selecting yes, you will download all associated samples (parent and child).
This is only an option on the Simple Search page. on the Advanced search page, it automatically will include parents. Be patient when downloading a large subset of samples and their parents.
Attached below is an example of a downloaded file from NExtSEEK - with parents. This data is published already and associated with: https://fairdomhub.org/studies/1134.
Sample Retrieval is a feature that allows a user to download all of the associated samples (parents and children) of the sample(s) searched.
How to Use Sample Retrieval:
Input samples into Sample Retrieval: by pasting in UIDs (delimited by newlines), or sending samples over from advanced search
Run sample retrieval
Select sample types and attributes that you want to download
Download samples
This sample retrieval shows that there are 2 other sample types (Cells and Tissues) associated with the Mice I queried. I then can filter and uncheck any of the attributes that exist for those sample types, and then download all of the metadata.
These two pages are identical (images below). They are filterable tables that allow you to search what protocol/data files are visible to you, along with links to download individual files, and an option to download files in batch.
To download a specific file, click the File URL. To batch download files, select the checkbox, and select Batch download files selected. The original file name redirects you to the SEEK page for that specific data file/protocol.
Globus is a cloud-based file transfer and storage service that allows users to move and share large amounts of data between different resources.
NExtSEEK houses metadata that describes/annotates actual data files. NExtSEEK does not have a good solution for storing and sharing data files, while Globus does. Below is an overview of how Globus and NExtSEEK are used together.
Register for a Globus account with your Institution email
Email fairdata@mit.edu with your Globus Username and Project Association
The fairdata team will reply once you have been added to the correct Globus Collections
Head to Collections > Shared with You to see the collections shared with you
There exist two collections that you will have access to: {Project_Name}-Staging and {Project_Name}-Public
Data is Uploaded to {Project_Name}-Staging and Downloaded from {Project_Name}-Public
The fairdata team will curate (move) data from Staging to Public when the relevant metadata has been uploaded to NExtSEEK. Following "curation", the Link_PrimaryData attribute of the D.SampleType on NExtSEEK, will be the corresponding Globus link.
The full Globus documentation exists here: https://docs.globus.org/
Deleting samples happens on the search pages. Similar to downloading, first, you need to search and select the samples you want to delete. You also need to ensure that no samples are children of the samples you are trying to delete.
For example, in the image below, If I am trying to delete those 5 NHPs, no samples in the database can have those 5 NHPs as their parent.
Once you've selected the samples, click delete, and assuming you are admin, type 'DELETE'. Let it run - takes around 6 seconds per sample - and again, will error out if there are downstream samples associated.
To delete a Protocol or Data File - head to the SEEK website:
Find the Protocol / Data File you want to delete, click actions, and delete.
