Guide to Carts

The ENCODE portal cart allows you to group an arbitrary set of experiments into one container. As with search result pages, you can additionally save a file that lists downloadable URLs for all files in all experiments in your cart and includes a link to generate a file containing experimental metadata for all files you download.

Adding many experiments to your cart

The search results page has a convenient way to add many experiments to your cart at once.

Select experiment search results with the Search item under the Data menu
Selecting experiment search results

Any experiments in your search results displays a cart button to its right. Carts cannot include other types of items — items that aren’t experiments do not have a cart button to their right.

View of experiment search results with cart button highlighted

Carts can contain up to 4000 experiments, but a large number of experiments in your cart can cause certain operations to take a long time to complete. Filtering your experiments down to as small a set as possible helps keep the performance of cart operations high. The following example has the “eCLIP” filter selected which reduces the number of search results to 469 experiments.

After adding multiple experiments to a cart

With these 469 experiments selected, clicking the “Add all items to cart” button adds them to your cart, and a new menu appears to the right of the Help menu, showing the number of items in your cart. Clicking this menu brings up an option to view your cart.

Viewing your cart

Choosing “View cart” takes you to the Cart page with the URL. Unlike most ENCODE portal URLs, this URL only shows your cart contents in this web browser view, and other people going to the same URL won’t see your cart but might see their own cart contents. Opening this URL in a new browser tab or in another browser also won’t show these cart contents. You can think of this view as the cart as it exists in your browser window’s memory.

View of cart

The main portion of the Cart page displays a list of all the experiments in your cart. You only see 25 experiments at a time, and the experiment pager lets you move between the pages of 25 experiments.

Unlike the similarly appearing search result pages, the file-type selector does not filter your list of experiments in your cart. It instead selects the types of files you download. Having no file types selected causes all files associated with all the experiments in your cart to download. Selecting or more file types causes only the selected types of files associated with all the experiments in your cart to download. As you choose different combinations of file types, you can see the number of files selected for download above the file-type selector.

A large number of experiments in your cart can cause the file-type facet to take a long time to appear.

Downloading files

The Download button, much like the Download button on search-result pages, pops up a dialog box that gives you information about downloading all the selected files in all the experiments in your cart.

File download dialog

Once you click the Download button, a file called “files.txt” gets downloaded that contains the URLs of all the selected files, as well as a line to generate and download a “metadata.tsv” file that contains a listing of the same files along with their experimental metadata.

If you have more than 500 experiments in your cart, you also see the warning in red. Clicking the Download button when you have a large number of experiments in your cart can result in a long delay before the “files.txt” file begins downloading. During this delay, you can still use the portal, but buttons that modify your cart appear dimmed until “files.txt” has finished downloading.

As with the Download button on search pages, using the command line documented in the dialog results in downloading a “metadata.tsv” file containing experimental metadata for each downloaded file, as well as every file in this list downloaded to your local computer.

Adding and removing individual experiments

In addition to adding multiple experiments to your cart and clearing your cart, you can also add and remove individual experiments.

As mentioned before, the search page shows a cart button to the right of experiments. This appears filled in for experiments currently in your cart, and as an outline for experiments not in your cart. Clicking the cart button of an experiment in your cart removes it from the cart, and the button appears as an outline. Clicking the cart button of an experiment not in your cart adds it to your cart, and the button appears filled in.

You can also add and remove experiments on experiment pages using a button on experiment pages above the summary.

Add to cart button on an experiment

Clearing your cart

Once you no longer have a need for your cart, click the Clear cart button on your cart page. You receive a chance to back out of this action, or to continue. Once you clear your cart, you cannot get it back.

Reloading your web page also clears your cart, though you receive a warning from your web browser if you attempt to reload your browser window while you have items in your cart, and you can then choose not to reload the page which keeps your cart in memory.