Frequently Asked Questions about KBase.
Yes! KBase is completely free to use and is supported by the Department of Energy.
You can check the job log and refer to our troubleshooting guide. If you do not see a reason for the error there, please make a ticket on our Help Board.
Some of the Apps can produce publication-quality images that can be views by opening in a separate window. We hope to add more in the future.
Is there a better way for handling large datasets? For large files or collections of files, we recommend using Globus. We also have a guide for importing using Globus.
Yes, bulk import allows you to check multiple files in the staging area and import them all by clicking "Import Selected." More instructions on this feature are described in the Narrative Guide.
There is no limit to the number of users that can be invited to view or edit Narratives. However, it is possible for users who are accessing the Narrative simultaneously to overwrite each other's changes. For that reason, we recommend only one person edit the Narrative at a time.
The best way to organize many inputs is to create sets. There are Apps for building these sets, such as Build AssemblySet that allow you to group those outputs.
Currently we only support code cells in Python.
Provided the same data, parameters, and tool version are consistent, the results are the same. We make every attempt to use the latest versions of Apps and databases, but they do not always correspond to the most recent version.
You can view some advanced parameters depending on the app by clicking the Advanced Parameters button. For some apps there are few or no advanced parameters. In creating these Apps we aim to balance configurability and usability. As a result, for some Apps we do not make certain rarely changed parameters visible.
There are a couple venues:
1. Submit a Help Desk New Feature Request. We can't promise if or when new feature requests are added, but user input helps us plan our future development.
2. Add as a 3rd-party developer: If you are a developer of an app, you can find more information on the developer's page and you can read the documentation for our Software Development Kit . If you are not the developer, you can reach out to the developer and ask them about wrapping it for KBase.
Alternatively, a beta version of the App might already be in KBase. In the Apps panel, click on the "R" button to switch from release to beta. When a "B" appears in place of the "R", you are viewing beta Apps.
KBase does not provide pipelines per se; we try to be as flexible as possible. We do have example Narratives that replicate the paths many users follow, but we encourage everyone to plot their own course.
All user data in KBase is private by default until you share it. You can keep all your data private if you wish. We do encourage users to make data public in the interest of FAIR - Findable, Accessible, Interoperable, and Reusable - data practices.
In KBase as a whole, anything can be uploaded, the only exception being that human data is not permitted. There are connections to some bacterial, plant, and fungal species in the Public Data tab, but any user data or data found from public sources other than those integrated into KBase can be uploaded. On an app-by-app basis, some tools may work sub-optimally or not at all with certain species.
Command line is not supported for the narratives. However, you may find more flexibility with the KBase Software Development Kit (SDK).
Yes, the relevant Github repo for each App can be found by following the links in the App Catalog. You can access the version and parameters that were used during an App run by clicking on the ellipsis button and clicking "Show code."
- The existence and contents of Private organizations are only visible to members of the organization. The organization will not be findable by non-members.
- Any KBase user can see a list of all Public organizations plus a description of the organization. Non-members are given the option to request membership. Members of the organization can access more information than non-members.
Click on ‘Click for Access’ and you are automatically granted View access to the Narrative. You can then click on the linked Narrative to open.
You can log into KBase through Google, Globus, and ORCiD. It is recommended to always have at least one personal account linked to your KBase account, so that in the event you lose access to an identity supplier i.e., Google, Globus, or ORCiD because of an email provider change, then you will still have another method to login.