The ENCODE portal cart allows you to group an arbitrary set of experiments into one container. As with search-result pages, you can easily generate a list of downloadable URLs for all files in all experiments in your cart, as well as experimental metadata for all files you download. For ENCODE consortium members who have logged in, your cart gets saved and you can retrieve it later as well as share it 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.
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.
Carts can contain any number of experiments (carts you create while not logged in 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.
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 https://www.encodeproject.org/cart-view/ 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.
If you have not logged in, opening this URL in a new browser tab or in another browser won’t show these cart contents. You can think of this view as the cart as it exists in your browser window’s memory.
If you have a cart while logged in, the same cart contents appear in all tabs and browsers for which you have logged in.
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 one 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.
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.
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.
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.
Sharing your cart
If you have a cart while logged in, you can share your cart with others through the Share cart item in your cart menu.
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.
Carts while not logged in
You can collect items into a cart if you haven’t logged in, but this cart does not get saved — it exists only in your browser’s memory. If you reload the browser or visit another site while you have a cart and you haven’t logged in, you receive a warning from your web browser (the actual warning message varies between browsers). You can choose to continue to reload the page and lose the contents of your cart, or you can cancel and your cart gets retained.
If you log in while you have items in a cart in your browser’s memory, that cart automatically gets saved. If you already have a saved cart when you log in while you have a cart in your browser’s memory, the two carts get merged and saved. If you don’t want your existing saved cart to get modified, clear the cart in your browser’s memory before you log in, which you can do simply by reloading the web page and confirming the warning, or by choosing the Clear cart button on the cart-view page before you log in.