Now that you are familiar with ways to find and explore data in KBase, you can select or upload data to analyze. The Data Panel in a Narrative shows the data objects that are currently available in that particular Narrative. From the Data Panel, you can access the data slideout, which allows you to search for data of interest and add it to your Narrative. In the Data Panel, click the Add Data button, the red “+” button, or the right arrow at the upper right of the panel to access the data slideout (also referred to as the “data browser”).
The first four tabs of the data slideout (“My Data”, “Shared With Me”, “Public”, and “Example”) let you search data that is already in KBase. The last tab lets you import data from your computer to your Narrative so that you can analyze it in KBase. This tab was labeled “Staging (beta)” and then became “Import (New)” and soon will become simply “Import.”
If you hover your cursor over any data object under the first four tabs, options will appear allowing you to add that object to your Narrative or find out more about it.
In the previous section, we described the process of adding a genome to your Narrative from the public data in KBase. Now let’s check out the different data types available under the Example tab. The icon to the left of each data object represents its data type.
As described in the previous section, the Add button next to these icons lets you add the data object to your Narrative. You can add more more data to your Narrative from the Example tab to try out various KBase apps.
To upload data from your computer (or a Globus endpoint or URL), choose the rightmost tab of the data slideout to open the new Import tab.
You can then click the “?” button just below the drop zone to launch a short interactive tour that shows the different parts of this user interface.
Getting data from your computer to your KBase Narrative is a three-step process:
It’s more robust and extensible this way. Unlike our previous importer, the staging upload can handle large data files without timing out. 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.
Find the file(s) you want to import into your KBase account, and drag them into the drop zone (the rectangular area surrounded by a dashed line). You can select multiple files from your computer and drag them all at once. (In the example below, the user is dragging two files into the dashed area.) You can also select a folder of data files and drag the folder into the Staging Area drop zone.
If you don’t like using drag & drop, you can instead click in the upload area to open a file chooser and select a file from your computer to upload.
When the file is done uploading, you will see it appear in the list of files in your Staging Area. (If you don’t see your file, try clicking the reload icon on the left above the file list to refresh the view.) By default, these are sorted by age, with the most recently uploaded file at the top. To sort the list by other fields, such as name or size, click a column header.
Globus is a data management and file transfer system that can facilitate bulk upload of data (either large data files or a large number of files) into your KBase account.
If you want to use Globus to copy data to your KBase account, you will first need to install Globus Connect Personal and create a Globus Connect Personal Endpoint (see https://docs.globus.org/how-to/ for instructions). You can then click the link in the Import tab that says “Or upload to this staging area by using Globus Online.”
This page has more documentation on transferring data from Globus.
Below the link to Globus, another link says “Click here to use an App to upload from a public URL” (for example, a GenBank ftp URL, or a Dropbox or Google Drive URL that is publicly accessible).
Clicking this link adds the “Upload File to Staging from Web” app to your Narrative:
There are also several apps that import specific file types (single- or paired-end reads or SRA files) from a URL directly to your Narrative, bypassing your Staging Area. These are available from the Apps panel and the App Catalog.
The files in your Staging Area are ready to import into your Narrative as KBase data objects that can be used in your analyses. (You can think of a Narrative as a project or folder, which includes data that you will analyze, as well as results from those analyses.)
To import a file from your Staging Area, choose a format (data type) from the pulldown menu to the right of the file’s age. (You can find out more about KBase data types and accepted formats in the Upload/Download Guide.) Then click the “import” icon to the right of the format menu.
When you click the “import” icon, the data slideout slides shut and an Import app cell (tailored to the chosen format) is created in your Narrative, with the appropriate parameters filled in. For example, here’s an import app created by choosing “GenBank” as the import format:
If the GenBank file came from a different source, use the pulldown menu to select it. You can change the output object name, if desired, and then click the Run button to start the import. When the import is done, you should see the message “Finished with success” near the top of the app cell, and some information about the app run.
You can now use this data object as input into the relevant KBase apps. If you want to see which apps accept a particular data type as input, you can click the “…” menu in the data object cell that appears when you hover over it, and then use the “Show Apps with this as input” icon to filter the apps in the Apps Panel:
If the importer objected to something in your file, check the Data Upload/Download guide for details about the relevant format.
In some cases, the cause of an import error will not be obvious. If you can’t figure out why your import isn’t working, please contact us (via the Help Board) for help. Note, however, that no one besides you has access to your Staging Area, so we will not be able to see the files you uploaded to your Staging Area. You may need to attach your input file to your Help Board ticket in order for us to diagnose the problem.
The list of files in your Staging Area includes their name, size, and age (when they were uploaded). If you have a lot of files in your Staging Area, you may want to use the Search box to locate specific files.
Compressed or zipped files have a little double-arrow icon next to the filename. You can click that icon to unpack them. You don’t need to uncompress compressed files, as they will automatically be uncompressed during import, but if you have uploaded a zip file, you can use the button to unzip it in order to access the individual files in it.
Opening the information about a file in your Staging Area also reveals a trash can icon that allows you to remove the file from your staging area.
You will be asked to confirm that you want to delete the file. This action is not reversible.
Note that if you had already imported the file to your Narrative as a data object, that object won’t go away when you delete the file in your Staging Area. If you want to delete a data object, you can do that in your Data Panel.
Once you have added data–your own data or reference data that is already in KBase–to your Narrative, you will be ready for the exciting part: analyzing it! The next two sections describe how to choose and run an app to analyze your data.