KBase Documentation
  • KBase Documentation
  • KBase Terms & Conditions
  • Getting Started
    • Signing Up and Signing In
      • Step-by-Step Signup Guide
      • Authentication Update
    • Supported Browsers
    • Narrative Quick Start
    • Narrative Interface User Guide
      • Access the Narrative Interface
      • Tour the Narrative Interface
      • Narrative Navigator
      • Create a Narrative
      • Explore Data
      • Add Data to Your Narrative
      • Browse KBase Analysis Tools
      • Analyze Data Using KBase Apps
      • Job Browser
      • Revise Your Narrative
      • Format Markdown Cells
      • Share Narratives
      • Linking Static Narratives to ORCID
      • Access and Copy Narratives
      • Organizations
    • FAQs
  • Manage Your Account
    • Linking Accounts
    • Linking KBase to ORCiD
  • Working with Data
    • Data Upload and Download Guide
      • Data Types
      • Importing Data
        • Bulk Import Limitations
      • Assembly
      • Genome
      • FASTQ/SRA Reads
      • Flux Balance Analysis (FBA) Model
      • Media
      • Expression Matrix
      • Phenotype Set
      • Amplicon Matrix
      • Chemical Abundance Matrix
      • SampleSet
      • Compressed/Zipped Files
      • Bulk Import Specification
      • Downloading Data
    • Searching, Adding, and Uploading Data
    • Filtering, Managing, and Viewing Data
    • Linking Metadata
      • Ontologies and Validated Terms
    • Public Data in KBase
    • Transfer Data with Globus
  • Using Apps
    • Analysis Apps in KBase
      • Assembly & Annotation
      • Comparative Genomics
      • Metabolic Modeling
      • Metagenomics & Community Exploration
      • Data Matrices - Amplicon, Stats
      • Chemical Abundance
      • Expression & Transcriptomics
    • Apps in Beta
  • Running Common Workflows
    • Assembling & Annotating Microbial Genomes
      • FAQ: Assembly and Annotation
    • Comparative Genomics & Phylogenetic Analysis
      • FAQ: Comparative Genomics
    • Metagenomic & Community Analysis
      • FAQ: Metagenomics & Community Analysis
    • Transcriptomic Analysis
      • FAQ: RNA-seq Analysis
    • Constructing Metabolic Models
      • Constructing and Analyzing Metabolic Flux Models of Microbial Communities
      • FAQ: Metabolic Modeling
  • Community Developed Workflows and Tools
    • Functional Annotation
    • Functional and Taxonomic Profiling of MAGs
    • Taxonomy
    • Viral
    • Random Walk with Restart Toolkit
  • Troubleshooting
    • Problems with the User Interface
    • Help Board
    • How to Report Issues
    • Job Errors and Their Meanings
      • Common Job Errors
        • The Job Log
      • Import Job Errors
      • Assembly App Errors
      • Annotation App Errors
      • Functional Genomics App Errors
      • Modeling App Errors
  • Developing Apps
    • The KBase SDK
    • Create a KBase Developer Account
    • KBase GitHub Repository
  • External Links
    • KBase Narrative Interface
    • KBase web site
    • KBase App Catalog
  • kbase.us
Powered by GitBook
On this page
  • What is a Narrative?
  • Step 1. Sign up for a KBase user account
  • Step 2. Sign in to KBase
  • Step 3. Create a new Narrative
  • Step 4. Find data to analyze
  • Step 5. Add data to your Narrative
  • Step 6. Choose an App
  • Step 7. Run the App
  • Step 8. Share your Narrative
  • Next steps and additional resources

Was this helpful?

  1. Getting Started

Narrative Quick Start

A fast, one-page introduction to KBase's narrative interface

PreviousSupported BrowsersNextNarrative Interface User Guide

Last updated 7 months ago

Was this helpful?

What is a Narrative?

In KBase, you can create shareable, reproducible workflows called Narratives that include data, analysis steps, results, visualizations, and commentary. This Quick Start provides an overview of how to create and use the features of Narratives.

Step 1. Sign up for a KBase user account

Step 2. Sign in to KBase

If you are a new user, your 'My Narratives' and 'Shared With Me' will likely be empty, since you haven’t created any Narratives yet.

Step 3. Create a new Narrative

Click the “+ New Narrative” button in Narratives to open a new untitled Narrative. A “Welcome to the Narrative Interface” box offers information and links to documentation for adding content to your Narrative. You can collapse or delete this box using the “…” dropdown menu in the top right corner.

Try the Narrative tour!

Select the “Narrative Tour” from the Help menu. This new feature walks you through the user interface, pointing out various useful aspects of it. We recommend taking the tour even if you’ve used KBase before, as it will help familiarize you with the current version.

Step 4. Find data to analyze

You can choose a dataset already in KBase. The Example tab, for instance, contains sample data from KBase’s reference data collection that can be used to try out the apps.

Note: Any data you upload to KBase is private unless you choose to share it.

Step 5. Add data to your Narrative

Notice that the data object now appears in the Data Panel. Once you finish adding data, exit the Data Browser by clicking either the “Close” button at the bottom left of the browser window or the arrow at the top right of the Data Panel.

Don’t forget to periodically save your Narrative by clicking the “Save” button at the top right of the interface.

Step 6. Choose an App

Once you have added data to your Narrative, you can analyze it using one or more of the KBase apps listed in the App Panel below your data.

There are options for filtering by category, name, input type, and more. You can designate apps you like as favorites using the star icon.

To add an app to your Narrative from the App Panel, click on its name or icon. You can get more information about an app by hovering over it until “…” appears and clicking on it.

Step 7. Run the App

Fill in all the required fields in your App. Note that some app fields are “smart” and can recognize which data in your Narrative are valid input for those fields. These smart fields have a pulldown list of all the data objects from your Data Panel that you can choose from as input.

When all required fields have been filled out, click the green “Run” button near the top left of the app cell to start the analysis.

Choosing the same output name for data objects will overwrite existing data objects of the same type with that name.

While the analysis is running, you will see the progress in the Job Status tab of the app box. When it finishes, the results will show up in the Result tab.

Step 8. Share your Narrative

Next steps and additional resources

To begin using KBase, you will first need to . You can now use your existing Google or Globus username and password to get a free KBase account.

After you sign in, you will be taken to your Narratives (details of which can be found ). From Narratives, you can open your existing Narratives, access others that have been shared with you, and create new Narratives. These Narratives can be accessed at .

To load data to your Narrative, click the “Add Data” button in the Data Panel, which can be found under the Analyze tab near the top left of the Narrative. The will slide out with tabs that show several data sources.

The Import tab allows you to upload your own data. KBase currently supports upload of a variety of data types. You can upload data up to 2GB using drag & drop or for larger files. Please see the for more information.

When you hover over a in the Data Browser, a blue “< Add” button will appear to its left. Click the button to add the data to your Narrative.

Please see for more details on running apps.

All Narratives that you create are private by default. You can with specific collaborators by clicking the “share” button near the top right of your Narrative.

With these basic steps, you now can begin using the Narrative Interface to create Narratives and analyze data. For a more in-depth introduction to any of the topics mentioned here, see the .

here
narrative.kbase.us
Data Browser
Globus
Data Upload/Download Guide
data object
the KBase Apps section of the Narrative Interface User Guide
make a Narrative public or share it
Narrative User Guide
Sign up for a KBase Account
Narrative Quick Start Guide
Navigating the Navigator
Welcome Cell Options