Bio::Graphics::Glyph::cds - The "cds" glyph

- NAME
- SYNOPSIS
- DESCRIPTION

- OPTIONS

- SUGGESTED STANZA FOR GENOME BROWSER
- BUGS
- SEE ALSO
- AUTHOR

# NAME

Bio::Graphics::Glyph::cds - The "cds" glyph

Back to Top

# SYNOPSIS

      See L<Bio::Graphics::Panel> and L<Bio::Graphics::Glyph>.

Back to Top

# DESCRIPTION

This glyph draws features that are associated with a protein coding region. At high magnifications, draws a series of boxes that are color-coded to indicate the frame in which the translation occurs. At low magnifications, draws the amino acid sequence of the resulting protein. Amino acids that are created by a splice are optionally shown in a distinctive color.

## OPTIONS

The following options are standard among all Glyphs. See the Bio::Graphics::Glyph manpage for a full explanation.

      Option      Description                      Default
      ------      -----------                      -------

      -fgcolor      Foreground color               black

      -outlinecolor Synonym for -fgcolor

      -bgcolor      Background color               turquoise

      -fillcolor    Synonym for -bgcolor

      -linewidth    Line width                     1

      -height       Height of glyph                10

      -font         Glyph font                     gdSmallFont

      -connector    Connector type                 0 (false)

      -connector_color
                    Connector color                black

      -label        Whether to draw a label        0 (false)

      -description  Whether to draw a description  0 (false)

      -strand_arrow Whether to indicate            0 (false)
                     strandedness

      -hilite       Highlight color                undef (no color)

In addition, the cds glyph recognizes the following glyph-specific options:

      Option      Description                      Default
      ------      -----------                      -------

      -frame0f    Color for first (+) frame        background color

      -frame1f    Color for second (+) frame       background color

      -frame2f    Color for third (+) frame        background color

      -frame0r    Color for first (-) frame        background color

      -frame1r    Color for second (-) frame       background color

      -frame2r    Color for third (-) frame        background color

      -gridcolor  Color for the "staff"            lightslategray

      -translation Number of lines of reading      3frame
                   frames to show. One of
                   "3frame", or "6frame".
                   For 6frame, specify a height
                   of at least 30 pixels.

      -sixframe   Draw a six-frame staff           0 (false; usually draws 3 frame)
                  This value overrides
                  -translation, which essentially
                  does the same thing.

      -require_subparts
                  Don't draw the reading frame 0   false
                  unless it is a feature
                  subpart.

      -sub_part   For objects with multiple        undef
                  subpart types, defines which
                  is the CDS part.

      -codontable   Codon table to use             1 (see Bio::Tools::CodonTable)

      -phase_style  The way phase is to be
                    interpreted. One of            "012"
                    "012" or "021"
      -ignore_empty_phase                          false
                  Only draw features that have
                  their phase defined.

      -cds_only   Only draw features of type       false
                  'CDS'

This glyph is more sensitive to the underlying data model than usual, so there are a few additional options to use to help adapt the glyph to different environments.

The -require_subparts option is suggested when rendering spliced transcripts which contain multiple CDS subparts. Otherwise, the glyph will hickup when zoomed way down onto an intron between two CDSs (a phantom reading frame will appear). For unspliced sequences, do *not* use -require_subparts.

The -phase_style controls how the value returned by the `phase()` or `frame()` methods is to be interpreted. The official interpretation is that the phase value indicates the offset into the feature at which the reading frame starts -- e.g. a phase of "2" means the reading frame starts after skipping two bases from the beginning of the feature. However, many GFF2 format feature files interpret this field to mean the position reading frame of the first base of the feature -- e.g. a phase of "2" means that the reading frame starts after skipping just one base from the beginning of the feature. Specify "012" to interpret the phase field in the correct way, and "021" to interpret the phase field in the legacy way. The default is "012."

Here is how the option names were chosen:

        * * *                  Base the reading frame starts on
        A B C A B C A B C...
        0 1 2                  PHASE REPRESENTED CORRECTLY
        0 2 1                  PHASE REPRESENTED IN THE LEGACY WAY

Set the -ignore_empty_phase option to true if you wish to skip subfeatures that do not have a defined `phase()` or frame(). This is useful if you are rendering exons that have both translated and untranslated parts, and you wish to skip the untranslated parts.

Set the -cds_only option to true if you wish to draw the glyph only for subfeatures of type 'CDS'. This is recommended.

Back to Top

# SUGGESTED STANZA FOR GENOME BROWSER

Using the "coding" aggregator, this produces a nice gbrowse display.

     [CDS]
     feature      = coding
     glyph        = cds
     frame0f      = cadetblue
     frame1f      = blue
     frame2f      = darkblue
     frame0r      = darkred
     frame1r      = red
     frame2r      = crimson
     description  = 0
     height       = 13
     label        = CDS frame
     key          = CDS
     citation     = This track shows CDS reading frames.

Back to Top

# BUGS

Please report them.

Back to Top

# SEE ALSO

the Bio::Graphics::Panel manpage, the Bio::Graphics::Glyph manpage, the Bio::Graphics::Glyph::arrow manpage, the Bio::Graphics::Glyph::cds manpage, the Bio::Graphics::Glyph::crossbox manpage, the Bio::Graphics::Glyph::diamond manpage, the Bio::Graphics::Glyph::dna manpage, the Bio::Graphics::Glyph::dot manpage, the Bio::Graphics::Glyph::ellipse manpage, the Bio::Graphics::Glyph::extending_arrow manpage, the Bio::Graphics::Glyph::generic manpage, the Bio::Graphics::Glyph::graded_segments manpage, the Bio::Graphics::Glyph::heterogeneous_segments manpage, the Bio::Graphics::Glyph::line manpage, the Bio::Graphics::Glyph::pinsertion manpage, the Bio::Graphics::Glyph::primers manpage, the Bio::Graphics::Glyph::rndrect manpage, the Bio::Graphics::Glyph::segments manpage, the Bio::Graphics::Glyph::ruler_arrow manpage, the Bio::Graphics::Glyph::toomany manpage, the Bio::Graphics::Glyph::transcript manpage, the Bio::Graphics::Glyph::transcript2 manpage, the Bio::Graphics::Glyph::translation manpage, the Bio::Graphics::Glyph::triangle manpage, the Bio::DB::GFF manpage, the Bio::SeqI manpage, the Bio::SeqFeatureI manpage, the Bio::Das manpage, GD

Back to Top

# AUTHOR

Lincoln Stein <lstein@cshl.org>

Copyright (c) 2001 Cold Spring Harbor Laboratory

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See DISCLAIMER.txt for disclaimers of warranty.

Back to Top

Bio::Graphics::Glyph::cds - The "cds" glyph