Guide to Carts

Basic cart usage | Saving and sharing carts | Managing multiple carts | Tutorial video


Basic cart usage

ENCODE portal carts allow you to group an arbitrary set of experiments into a container. As with search-result pages, you can easily generate a list of downloadable URLs for all files in all experiments in your cart along with experimental metadata for all files you download.

Let’s start with the most basic form of carts in which they only exist in your browser window’s memory. Later we’ll look at logging in with a user account to save carts and share them with others.

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 — non-experiment items 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 cart menu that shows the number of items in your cart appears next to the Help menu.

Viewing your cart

Choosing “View cart” from the cart menu takes you to the Cart page with the https://www.encodeproject.org/cart-view/ URL. Unlike most ENCODE portal URLs, this URL only shows your cart contents in this web browser window, and other people going to the same URL don’t see your cart but might see their own cart contents, and you don’t see these cart contents in a different browser window.

View of cart

The main portion of the Cart page displays a list of 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 selectors do not filter your list of experiments in your cart. Instead, they select the files you download based on the specified properties. Having nothing selected causes all files associated with all the experiments in your cart to download. Selecting for one or more properties, such as an assembly of "GRCh38" shown in the image above, causes only the files with the chosen properties associated with all the experiments in your cart to download. Currently, files for download can be filtered by their output type, file type, genome assembly, lab, and status. As you choose different combinations of properties, you can see the number of files selected for download above the file selectors.

A large number of experiments in your cart can cause the file selectors 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 in the dialog box, 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.

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-results page shows a cart button to the right of experiments. This button 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 individual experiment pages using a button above the summary.

Add to cart button on an experiment

Clearing your cart

Once you no longer need your cart, click the “Clear cart” button on your cart page. You get a chance to back out of this action, or to continue. Once you clear your cart, you cannot bring its contents back.

Another way to clear your cart involves clearing your browser window’s memory by reloading the browser or visiting another website while you have items in your cart. When you do this, you see a generic alert that lets you back out of clearing your browser window’s memory in case you do this by accident.


Saving and sharing carts with user accounts

Carts have more abilities when you have logged in with your user account on the ENCODE portal, including:

  • Saving your carts so they can be recalled
  • Sharing saved carts with others
  • Adding more than 4000 items to your carts, with a corresponding performance penalty on the cart page as you add more items

The following sections describe additional cart abilities when you have logged in.

Please contact our Help Desk if you need an account, or if your old account does not work.

Saving your cart

Once you have logged in with your ENCODE portal user account, carts automatically get saved to the ENCODE portal as you add and remove items — you don’t need to specifically save your cart. You can view your carts on different browsers and computers, and you don’t lose this cart by reloading the browser window or going to a different website.

Sharing your cart

You can share your cart with others through the “Share cart” item in your cart menu.

Selecting Share cart menu, including your default cart name

Selecting this item brings up a dialog box that lets you copy the unique URL to your cart. Others who visit this URL can see the contents of your cart, though they cannot modify your cart — only you can modify your own cart.

Notice this cart also has a name — “Lorem Ipsum cart” in this case for the user “Lorem Ipsum.” We’ll look at cart names in more detail below.


Managing multiple carts

Logged-in users can have up to 30 independent carts, each containing its own set of experiments that can overlap with your other carts’ sets of experiments. You set one of your carts as the “current cart,” and all of the operations described above apply to that cart until you set another of your carts as the current cart.

Each cart has a name that must be unique among all your carts. You can also optionally assign an identifier to each cart that you can use in the URL for your cart when you share it. This identifier must be unique among all carts in the system, even if they belong to other users.

Every user gets one cart initially with a name starting with that user’s name. In the example given below, user “Lorem Ipsum” has an initial cart called “Lorem Ipsum cart.”

Cart Manager

When logged in, choose the “Cart manager” option from the cart menu which brings up a page showing a list of all the carts belonging to you.

The cart manager as it appears with the initial cart

Adding a new cart

To add new carts, click the New cart button at the upper-right corner of the list. This brings up a modal that lets you specify the name and optional identifier for the new cart.

New cart dialog box

The notes below each field describe the limitations for the name and identifier. The arrow button in the middle lets you toggle automatic-transfer mode, so clicking it enables the automatic transfer of the name you enter to the identifier (the button appears with a dark background) and clicking this button again disables automatic transfer. While you have automatic transfer enabled, anything you type into the name field gets copied to the identifier field but modified to work better as a part of a URL, so spaces get converted to dashes, and anything not a standard letter or number gets converted to dashes or ignored depending on what those characters are. You can also type directly into the identifier field, with the same limitations on the kinds of characters you can enter.

Once you feel satisfied with the name and optional identifier, click the New cart button to create this cart, and you then see your new cart in your list of carts. If you had left the identifier field blank, the new cart has all the same abilities as any other cart but it gets an automatically assigned identifier.

Setting the current cart

You only work with one cart at a time, so you need to set one of your carts as the “current cart.” You do this in the cart manager by clicking the button in the Current column on the right side of the cart’s line in the list of carts, which also highlights that cart in blue. Once you do that, all cart operations — adding to the cart, viewing the cart, downloading the cart’s files, etc. — apply to that cart.

While all your carts and their contents are part of the ENCODE database, your web browser keeps track of the current cart. If you switch to a different browser or a different computer, you could see a different cart set as the current cart.

The current cart selected and reflected in the cart menu

Renaming, sharing, and deleting carts

The Actions column of the cart manager has the three operations you can perform on a cart: rename, share, and delete.

Renaming a cart brings up the same dialog box as creating a new cart and gives you the same options.

Sharing a cart brings up the same dialog box as sharing a cart from the cart menu. However, you can share any cart with the cart manager whether the current cart or other carts.

When you delete a cart and confirm that you mean to delete it, you can no longer retrieve that cart. Deleting a cart also frees its identifier if it had one — its identifier becomes available for other carts. You cannot delete the current cart; to delete a cart you have to set a different cart as the current cart first.

Auto Save carts

If you haven’t logged in and you start collecting items into a cart and then you log in, those items automatically get saved to a special cart called “Auto Save” that appears in yellow in the cart manager. This cart has no identifier, and you cannot rename it, share it from the cart manager, or set it as the current cart.

You can merge the auto-save cart’s contents into your current cart. To do this, go to the cart manager and make sure you have set the cart you want to merge the auto-save cart’s items into as the current cart. Then click the “Auto Save” cart’s link in the list to view the auto-save cart’s contents. Above the contents you find the “Add to current cart” button. When you click this button, all the contents of the auto-save cart get merged into the current cart, without duplicates.

You never have more than one auto-save cart, so if you already have one and you log in again with items in the logged-out cart, those new items get merged into your existing auto-save cart’s items.


Tutorial video