The new Import tab

KBase has a collection of data imported from public databases, and you can also import your own data to analyze. (Any data that you upload to KBase is kept private unless you explicitly choose to share it.)

The primary way to import your data into your KBase account is from the Data Slideout. From any Narrative, look at the Data panel (which shows the data objects in that Narrative) and click the arrow near the top right (see screenshot). This will open the Data Slideout (also known as the Data Browser), which allows you to find data to add to your Narrative so you can analyze it.

The Data Slideout has tabs for different data sources. If you have imported data into your KBase account from your computer or from a URL, you will be familiar with the tab labeled “Import.” That interface for importing data will soon be replaced by the interface that is currently labeled “Import (New)” (and will eventually just be labeled “Import”).

The new import interface allows you to drag and drop data from your computer into your Staging Area. Your Staging Area is a sort of “halfway house” for your uploaded data files. When you’re ready to add data to your Narrative, you can choose a data type from the pulldown menu next to a data file in your staging area in order to add it as an object of that type.

Getting data from your computer to your KBase Narrative with the new import tab is a three-step process:

  1. Drag and drop the data file(s) from your computer to the new Import tab to upload them to your Staging Area
  2. Choose a format for importing data from your Staging Area into your Narrative (see screenshot)
  3. Run the Import app that is created

Detailed instructions are available here.

Why are we switching to this new way of importing data?

It’s more robust, more extensible, does better error reporting, and files stay in the staging upload area for 90 days. Unlike our previous importer, the staging upload can handle large data files without timing out. Because they stay in the staging area for 90 days, various import options can be tried without re-uploading the entire file. The user interface is more intuitive: you can drag and drop one or more data files into your Staging Area, or even whole directories or zip files. Finally, the new importer is easier for our developers to extend to new data types.

We hope you find the new import interface easy to use. Please don’t hesitate to contact us if you have any questions or suggestions!