[Bio] / KBaseTutorials / Basic_exercises / annotating_a_genome.html Repository:
ViewVC logotype

View of /KBaseTutorials/Basic_exercises/annotating_a_genome.html

Parent Directory Parent Directory | Revision Log Revision Log

Revision 1.12 - (download) (as text) (annotate)
Fri Sep 7 20:02:20 2012 UTC (7 years, 3 months ago) by nconrad
Branch: MAIN
Changes since 1.11: +1 -2 lines
removing title space

<h1>Annotating a Genome Using KBase Tools</h1>
<p><strong>Purpose: </strong>This tutorial demonstrates how to annotate a set of closely related
  genomes using KBase tools.  For example, the genus <i>Geobacter</i> can be used to study the pan-genome and construct 
metabolic models to clarify differences between strains. </p>
<p><strong>Required Prerequisite Activities: </strong><a href="/developer-zone/tutorials/getting-started/getting-started-with-the-kbase/">Getting Started with KBase</a></p>
<p><strong>Suggested Prerequesite Activities: </strong><a href="/developer-zone/tutorials/getting-started/some-basic-exercises-using-kbase/">Basic Exercises Using KBase</a></p>
<p><strong>Related Tutorials: </strong>None</p>
<h2>Select a genome</h2>

To see which <i>Geobacter</i> genomes are in the <i>Central Store (CS)</i> of KBase, use<br>
  all_entities_Genome -f scientific_name | grep Geobacter
<i>Geobacter sulfurreducens KN400</i> is a good example genome to begin with.
Its KBase id is <i>kb|g.2860</i>.  Locate it in the list of genomes.
Obtain a local copy of the contigs of that genome using the step below.

<h2>Extract a FASTA file of contigs from the CS</h2>

You can upload any desired set of contigs from a file in your
local machine to your IRIS workarea.  However, in this example, obtain the contigs from the CS.
To do that, use

  echo 'kb|g.2860' | genomes_to_contigs | contigs_to_sequences > g.2860.contigs
<h2>Create projects</h2>
Create subdirectories to contain
your separate projects.  Make a subdirectory called <i>g.2860</i> where you will
annotate kb|g.2860. (Do not use any special characters in your filenames, e.g., in this case the 'kb|' prefix was left off).

For example

  mkdir g.2860
  mv g.2860.contigs g.2860
  cd g.2860
The first command creates the subdirectory, the second moves our contigs into the subdirectory,
the third moves our "position" to the subdirectory, and the last displays the contents of the subdirectory.
We urge you to verify that it all works as described.

<h2>Create a genome object to annotate</h2>

Next, use the FASTA file of contigs to create a <i>genome object</i> using <br>

  fasta_to_genome 'Geobacter sulfurreducens KN400' Bacteria 11 < g.2860.contigs > genome

The above command creates a "genome object" in the file <i>genome</i>.  The object contains the contigs, 
the scientific name of the organism, the domain (we specified 'B' for <i>Bacteria</i>), and
the genetic code for the organism (i.e., 11, which is the code most commonly used with prokaryotic genomes).
Use  <em>ls</em> to see the file, and then click on it to see the encoded fields).
Note that we have named our project subdirectory <i>g.2860, </i>which reflects the name of the
genome whose contigs we copied.  We are going to re-annotate the contigs, generating a whole new
genome, which is what <b>fasta_to_genome</b> does; it registers a new genome ID that will not be used
by anyone else.

<h2>Annotate a genome object</h2>

Now create an initial annotation for the genome using

  annotate_genome < genome > annotated.genome


This causes an initial annotation to be generated.  It may take several minutes for large genomes.  You can issue other commands while you wait, and the completion message will display below the command when the annotation is complete.  When it completes, use <b>ls</b>
to see the generated file, and click on it to see the encoded annotations.  Alternatively, to the the features
generated and placed in the annotated genome object (stored in <i>annotated.genome</i>), try
  genomeTO_to_feature_data < annotated.genome > features.txt
which produces a tab-separated table containing 
Use <em>ls</em> to see it and explore the contents.
<h2>Build a metabolic reconstruction from an annotated genome</h2>
The term
"metabolic reconstruction" as used 
here roughly means <i>a set of <a href="http://www.theseed.org/wiki/Glossary#Subsystem" target=blank_>
subsystems</a> that are believed to be present in the genome, along with
the relevant variant codes</i>.
Obtain a metabolic reconstruction for the annotated genome using <br>
  genomeTO_to_reconstructionTO < annotated.genome > reconstruction
To see the roles that were found, use 
  reconstructionTO_to_roles < reconstruction > roles
To see the subsystems (along with the variant codes that seemed appropriate), use
  reconstructionTO_to_subsystems < reconstruction > subsystems

<h2>Get roles that might impact metabolic models</h2>

How good are the annotations for your newly-annotated genome?
One way to assess this is to focus on the <i>Roles </i> that might impact metabolic models.
We can look at the ones that were found and then compare them against those that exist in
a similar, manually-curated genome. Begin by getting the subset of the Roles that
might impact the metabolic models:<br>
  all_roles_used_in_models > all.roles
  a_and_b roles all.roles > roles.for.models

<h2>Get roles that might have been missed</h2>

Now, compare this set of Roles against the set found in
<i>Geobacter metallireducens GS-15</i> (<i>kb|g.9032</i> in the CS).  Obtain the roles for
that genome using
  echo 'kb|g.9032' | genomes_to_fids CDS | fids_to_roles 2> /dev/null | <br />  cut -f 3 > roles.in.g.9032
Note that the command <b>fids_to_roles</b> writes error messages when it cannot match
a fid to any Roles.
Now use
  a_and_b roles.in.g.9032 all.roles > roles.for.models.g.9032
  a_not_b roles.for.models roles.for.models.g.9032 > roles.to.search.for

to create a file of Roles in <i>kb|g.9032</i> that are not yet found in the annotations we
got back for our new version of <i>g.2860</i>.

<h2>Create an initial metabolic model</h2>

Now that we have an annotated genome, create an initial metabolic model using
  genome_to_fbamodel < annotated.genome > initial.model

<p>After a minute or two, a metabolic model object is stored in <i>initial.model</i>.
<h2>View the model</h2>

We can convert this model into readable HTML to see what it contains:

  fbamodel_to_html < initial.model > initial.model.html

<p>After that command completes, use <em>ls</em> and click on the generated html. </p>

<h2>Run flux balance analysis on the metabolic model</h2>

Flux balance analysis (FBA) is a mathematical approach in which our model is used to simulate
various cellular activities, typically the production of biomass or metabolites from
transportable nutrients. Now that we have a model, apply flux balance analysis to
determine whether our model can grow, and to discover which pathways are utilized during growth.

  runfba < initial.model > solution.html

<p>The results from the FBA are printed in HTML in the output solution file. Simply run the <em>ls</em> command and click on the HTML file to view the solution. At the top of this file
is a table of the parameters used to run the FBA. Directly below this table is another 
table showing the objective function and value. In all likelihood, your model did not grow
at all. This is because the model is missing pathways needed for biomass production. When 
a model fails to grow, the FBA command attempst to diagnose the problem by identifying
biomass components that cannot be produced. This is done by maximizing the production of 
each individual biomass component, one at a time. You can see these analysis results in your
solution HTML file (see the metabolite production table). Note that some of your biomass components
have no numbers in this table. These are the components that cannot be produced. Now try
to fix the model by adding reactions to enable production of these components. </p>

<h2>Gapfill the model</h2>

We can run a gapfilling command on our model to automatically add reactions as needed to
enable the production of all biomass components:

  gapfill_fbamodel < initial.model > gapfilled.model

<p>Depending on the size and state of the genome, this could take minutes to hours, but 
when the analysis is complete, your model will have additional reactions in it, reflecting
the ideal solution identified by the gapfilling algorithm to enable growth. Then 
rerun the flux balance analysis to determine the biomass production pathways of the organism.

<h2>Run flux balance analysis on the gapfilled model</h2>

Now that the model has been gapfilled, it should be possible to simulate biomass production
using flux balance analysis. Use the <i>runfba</i> command again:

  runfba < gapfilled.model > solution.html

<p>Once this command completes, use <em>ls</em> and click on the HTML produced by the FBA 
command. Your FBA solution should now include a nonzero objective value as well as numerous 
compound and reaction fluxes.</p>

<h2>Export the model to external tools</h2>

Many other tools now exist that enable the analysis of genome-scale metabolic models (e.g., 
the Cobra toolbox). Most of these tools read models printed in SBML format. Print
the gapfilled model in SBML format so the model can be used with these tools:

  fbamodel_to_sbml < gapfilled.model > gapfilled.model.sbml

<p>After the command completes, use <i>ls</i> and select the SBML file for download.</p>

MCS Webmaster
ViewVC Help
Powered by ViewVC 1.0.3