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
  • Formatting Media TSV or Excel files
  • Import media from a TSV or Excel file

Was this helpful?

  1. Working with Data
  2. Data Upload and Download Guide

Media

How to format reaction media files for KBase to use in FBA and modeling analysis.

PreviousFlux Balance Analysis (FBA) ModelNextExpression Matrix

Last updated 7 months ago

Was this helpful?

KBase offers several options for defining specific growth or culture media for metabolic modeling. Within the Narrative Interface, you can use the tool to build media based on the hundreds of conditions available in KBase or import your own custom media as a TSV or Excel file using the instructions below.

Formatting Media TSV or Excel files

If you choose to upload a custom media or use media from an external source, please ensure that it is formatted properly for use with KBase.

Media can be uploaded as a TSV (tab-separated values) or Excel file using four columns:

  • Maxflux (maximum allowed uptake/excretion of compound)

  • Minflux (minimum allowed uptake/excretion of compound)

  • Concentration (concentration of compound in mol/L)

  • Compound identifier (e.g., ModelSEED ID, KEGG ID, PubChem ID, or compound name such as “glucose”)

A list of all the biochemical compounds is available in the for a reference list of reactions and compounds or use the . From the list you can find the IDs for compounds to include in custom media.

The concentration field is not used by any of the the metabolic modeling tools in KBase. It is best to account for these values accurately so that your media files will retain their utility pending updates.

The minflux and maxflux columns connect media to a flux balance analysis (FBA) metabolic model. The values in these columns are absolute units representing the range of possible fluxes for reactions that transport the media compounds into and out of the cell. A negative flux value corresponds to excretion (transport out of the cell), and a positive flux value corresponds to uptake (transport into the cell).

The combination of maximum and minimum flux will dictate whether uptake and/or excretion of a reagent is allowed. Assigning a positive number to minflux for a particular compound essentially forces uptake of that compound. Assigning a negative number to maxflux will force excretion of the compound.

Minimum and maximum flux are measured in mmol per gram cell dry weight per hour.

Note: When creating a media Excel file, the name of the worksheet that contains your media conditions must be named “MediaCompounds” or it will not upload. By default, the first sheet of any Excel file is called “Sheet1.” To rename it, find the worksheet tabs at the bottom left of the Excel file. Double-click on the default name and type in “MediaCompounds.”

Below is an example of a media file in TSV format. In this case, the compound IDs in the first column are from the (scroll to the right to see full table):

compounds

name

formula

minflux

maxflux

concentration

cpd00149

Co2+

Co

-100

100

0.001

cpd00099

Cl-

Cl

-100

100

0.001

cpd00063

Ca2+

Ca

-100

100

0.001

cpd00007

O2

O2

-100

10

0.001

cpd00027

D-Glucose

C6H12O6

-100

5

0.001

Import media from a TSV or Excel file

For this example, you can click on either link to download a small media file onto your computer:

The “Import Media file (TSV/Excel) from Staging Area” App will be added to your Narrative.

You can change the name that will be assigned to the Media Object. Then click the green "Run" button. After the import process has completed, the Media data object will appear in your Data Panel.

Using a file on your computer, open the . Then drag & drop the media file to upload it to your Staging Area. Choose "Media" from the Import As... data type dropdown menu in your Staging Area. Click the upload icon next to the field that now says “Media.”

Edit Media
KBase ModelSEED Biochemistry Database
Biochemistry Search
KBase ModelSEED Biochemistry Database
Import tab within the Data Browser
6KB
Glucose_minimal.xls
Example Excel file
706B
Glucose_minimal.tsv
Example TSV file
Selecting Media for import from the Staging Area
Import Media file App