| prettyplot

## Function

Displays aligned sequences, with colouring and boxing

## Description

prettyplot reads in a set of aligned DNA or protein sequences. It displays them graphically, with conserved regions highlighted in various ways.

## Usage

Here is a sample session with prettyplot

    % prettyplot -resbreak=10 -boxcol -consensus -plurality=3
    Displays aligned sequences, with colouring and boxing
    Input sequence set: ../../data/globins.msf
    Graph type [x11]: cps

    Created prettyplot.ps

Go to the input files for this example
Go to the output files for this example

Example 2

    % prettyplot ../../data/globins.msf -plurality=3 -docolour
    Displays aligned sequences, with colouring and boxing
    Graph type [x11]: cps

    Created prettyplot.ps

Go to the output files for this example

## Command line arguments

       Mandatory qualifiers (* if not always prompted):
      [-msf]               seqset     File containing a sequence alignment
    *  -graph              graph      Graph type

       Optional qualifiers:
       -residuesperline    integer    The number of residues to be displayed on
                                      each line
       -resbreak           integer    Residues before a space
       -[no]ccolours       boolean    Colour residues by their consensus value.
       -cidentity          string     Colour to display identical residues (RED)
       -csimilarity        string     Colour to display similar residues (GREEN)
       -cother             string     Colour to display other residues (BLACK)
       -docolour           boolean    Colour residues by table oily, amide etc.
       -[no]title          boolean    Do not display the title
       -shade              string     Set to BPLW for normal shading
                                      so for pair = 1.5,1.0,0.5 and shade = BPLW
                                      Residues score Colour
                                      1.5 or over....... BLACK (B)
                                      1.0 to 1.5 ....... BROWN (P)
                                      0.5 to 1.0 ....... WHEAT (L)
                                      under 0.5 ....... WHITE (W)
                                      The only four letters allowed are BPLW, in
                                      any order.
       -pair               string     Values to represent identical similar
                                      related
       -identity           integer    Only match those which are identical in all
                                      sequences.
       -[no]box            boolean    Display prettyboxes
       -boxcol             boolean    Colour the background in the boxes
       -boxcolval          string     Colour to be used for background. (GREY)
       -[no]name           boolean    Display the sequence names
       -maxnamelen         integer    Margin size for the sequence name.
       -[no]number         boolean    Display the residue number
       -[no]listoptions    boolean    Display the date and options used
       -plurality          float      Plurality check value (totweight/2)
       -consensus          boolean    Display the consensus
       -[no]collision      boolean    Allow collisions in calculating consensus
       -alternative        integer    Use alternative collisions routine
                                      0) Normal collision check. (default)
                                      1) checks identical scores with the max
                                      score found. So if any other residue matches
                                      the identical score then a collision has
                                      occurred.
                                      2) If another residue has a greater than or
                                      equal to matching score and these do not
                                      match then a collision has occurred.
                                      3) Checks all those not in the current
                                      consensus.If any of these give a top score
                                      for matching or identical scores then a
                                      collision has occured.
       -matrixfile         matrix     This is the scoring matrix file used when
                                      comparing sequences. By default it is the
                                      file 'EBLOSUM62' (for proteins) or the file
                                      'EDNAFULL' (for nucleic sequences). These
                                      files are found in the 'data' directory of
                                      the EMBOSS installation.
       -showscore          integer    Print residue scores
       -portrait           boolean    Set page to Portrait

       Advanced qualifiers:
       -data               boolean    (no help text) boolean value

       Associated qualifiers:
      "-msf" related qualifiers
       -sbegin1             integer    First base used
       -send1               integer    Last base used, def=seq length
       -sreverse1           boolean    Reverse (if DNA)
       -sask1               boolean    Ask for begin/end/reverse
       -snucleotide1        boolean    Sequence is nucleotide
       -sprotein1           boolean    Sequence is protein
       -slower1             boolean    Make lower case
       -supper1             boolean    Make upper case
       -sformat1            string     Input sequence format
       -sopenfile1          string     Input filename
       -sdbname1            string     Database name
       -sid1                string     Entryname
       -ufo1                string     UFO features
       -fformat1            string     Features format
       -fopenfile1          string     Features file name
      "-graph" related qualifiers
       -gprompt             boolean    Graph prompting
       -gtitle              string     Graph title
       -gsubtitle           string     Graph subtitle
       -gxtitle             string     Graph x axis title
       -gytitle             string     Graph y axis title
       -goutfile            string     Output file for non interactive displays
       -gdirectory          string     Output directory

       General qualifiers:
       -auto                boolean    Turn off prompts
       -stdout              boolean    Write standard output
       -filter              boolean    Read standard input, write standard output
       -options             boolean    Prompt for required and optional values
       -debug               boolean    Write debug output to program.dbg
       -acdlog              boolean    Write ACD processing log to program.acdlog
       -acdpretty           boolean    Rewrite ACD file as program.acdpretty
       -acdtable            boolean    Write HTML table of options
       -verbose             boolean    Report some/full command line options
       -help                boolean    Report command line options. More
                                      information on associated and general
                                      qualifiers can be found with -help -verbose
       -warning             boolean    Report warnings
       -error               boolean    Report errors
       -fatal               boolean    Report fatal errors
       -die                 boolean    Report deaths

Mandatory qualifiers | Allowed values | Default
--- | --- | ---
[-msf] (Parameter 1) | File containing a sequence alignment | Readable sequences | Required
-graph | Graph type | EMBOSS has a list of known devices, including postscript, ps, hpgl, hp7470, hp7580, meta, colourps, cps, xwindows, x11, tektronics, tekt, tek4107t, tek, none, null, text, data, xterm, png | EMBOSS_GRAPHICS value, or x11
Optional qualifiers | Allowed values | Default
-residuesperline | The number of residues to be displayed on each line | Any integer value | 50
-resbreak | Residues before a space | Integer 1 or more | Same as -residuesperline to give no breaks
-[no]ccolours | Colour residues by their consensus value. | Boolean value Yes/No | Yes
-cidentity | Colour to display identical residues (RED) | Any string is accepted | RED
-csimilarity | Colour to display similar residues (GREEN) | Any string is accepted | GREEN
-cother | Colour to display other residues (BLACK) | Any string is accepted | BLACK
-docolour | Colour residues by table oily, amide etc. | Boolean value Yes/No | No
-[no]title | Do not display the title | Boolean value Yes/No | Yes
-shade | Set to BPLW for normal shading so for pair = 1.5,1.0,0.5 and shade = BPLW Residues score Colour 1.5 or over....... BLACK (B) 1.0 to 1.5 ....... BROWN (P) 0.5 to 1.0 ....... WHEAT (L) under 0.5 ....... WHITE (W) The only four letters allowed are BPLW, in any order. | Any string is accepted | An empty string is accepted
-pair | Values to represent identical similar related | Any string is accepted | 1.5,1.0,0.5
-identity | Only match those which are identical in all sequences. | Integer 0 or more | 0
-[no]box | Display prettyboxes | Boolean value Yes/No | Yes
-boxcol | Colour the background in the boxes | Boolean value Yes/No | No
-boxcolval | Colour to be used for background. (GREY) | Any string is accepted | GREY
-[no]name | Display the sequence names | Boolean value Yes/No | Yes
-maxnamelen | Margin size for the sequence name. | Any integer value | 10
-[no]number | Display the residue number | Boolean value Yes/No | Yes
-[no]listoptions | Display the date and options used | Boolean value Yes/No | Yes
-plurality | Plurality check value (totweight/2) | Any numeric value | Half the total sequence weighting
-consensus | Display the consensus | Boolean value Yes/No | No
-[no]collision | Allow collisions in calculating consensus | Boolean value Yes/No | Yes
-alternative | Use alternative collisions routine 0) Normal collision check. (default) 1) checks identical scores with the max score found. So if any other residue matches the identical score then a collision has occurred. 2) If another residue has a greater than or equal to matching score and these do not match then a collision has occurred. 3) Checks all those not in the current consensus.If any of these give a top score for matching or identical scores then a collision has occured. | Integer from 0 to 3 | 0
-matrixfile | This is the scoring matrix file used when comparing sequences. By default it is the file 'EBLOSUM62' (for proteins) or the file 'EDNAFULL' (for nucleic sequences). These files are found in the 'data' directory of the EMBOSS installation. | Comparison matrix file in EMBOSS data path | EBLOSUM62 for protein EDNAFULL for DNA
-showscore | Print residue scores | Any integer value | -1
-portrait | Set page to Portrait | Boolean value Yes/No | No
Advanced qualifiers | Allowed values | Default
-data | (no help text) boolean value | Boolean value Yes/No | No

## Input file format

prettyplot reads any sequence USA.

### Input files for usage example

### File: ../../data/globins.msf

    !!AA_MULTIPLE_ALIGNMENT 1.0

      ../data/globins.msf MSF:  164 Type: P 25/06/01 CompCheck: 4278 ..

      Name: HBB_HUMAN Len: 164  Check: 6914 Weight: 0.14
      Name: HBB_HORSE Len: 164  Check: 6007 Weight: 0.15
      Name: HBA_HUMAN Len: 164  Check: 3921 Weight: 0.15
      Name: HBA_HORSE Len: 164  Check: 4770 Weight: 0.19
      Name: MYG_PHYCA Len: 164  Check: 7930 Weight: 0.23
      Name: GLB5_PETMA Len: 164  Check: 1857 Weight: 0.21
      Name: LGB2_LUPLU Len: 164  Check: 2879 Weight: 0.10

    //

               1                                               50
    HBB_HUMAN  ~~~~~~~~VHLTPEEKSAVTALWGKVN.VDEVGGEALGR.LLVVYPWTQR
    HBB_HORSE  ~~~~~~~~VQLSGEEKAAVLALWDKVN.EEEVGGEALGR.LLVVYPWTQR
    HBA_HUMAN  ~~~~~~~~~~~~~~VLSPADKTNVKAA.WGKVGAHAGEYGAEALERMFLS
    HBA_HORSE  ~~~~~~~~~~~~~~VLSAADKTNVKAA.WSKVGGHAGEYGAEALERMFLG
    MYG_PHYCA  ~~~~~~~VLSEGEWQLVLHVWAKVEAD.VAGHGQDILIR.LFKSHPETLE
    GLB5_PETMA PIVDTGSVAPLSAAEKTKIRSAWAPVYSTYETSGVDILVKFFTSTPAAQE
    LGB2_LUPLU ~~~~~~~~GALTESQAALVKSSWEEFNANIPKHTHRFFILVLEIAPAAKD

               51                                             100
    HBB_HUMAN  FFESFGDLSTPDAVMGNPKVKAHGKKVLGAFSDGLAHLDNLKGTFATLSE
    HBB_HORSE  FFDSFGDLSNPGAVMGNPKVKAHGKKVLHSFGEGVHHLDNLKGTFAALSE
    HBA_HUMAN  FPTTKTYFPHFDLSHGSAQVKGHGKKVADALTNAVAHVDDMPNALSALSD
    HBA_HORSE  FPTTKTYFPHFDLSHGSAQVKAHGKKVGDALTLAVGHLDDLPGALSNLSD
    MYG_PHYCA  KFDRFKHLKTEAEMKASEDLKKHGVTVLTALGAILKKKGHHEAELKPLAQ
    GLB5_PETMA FFPKFKGLTTADQLKKSADVRWHAERIINAVNDAVASMDDTEKMSMKLRD
    LGB2_LUPLU LFSFLKGTSEVPQNNPELQAHAGKVFKLVYEAAIQLQVTGVVVTDATLKN

               101                                            150
    HBB_HUMAN  LHCDKLH..VDPENFRLLGNVLVCVLAHHFGKEFTPPVQAAYQKVVAGVA
    HBB_HORSE  LHCDKLH..VDPENFRLLGNVLVVVLARHFGKDFTPELQASYQKVVAGVA
    HBA_HUMAN  LHAHKLR..VDPVNFKLLSHCLLVTLAAHLPAEFTPAVHASLDKFLASVS
    HBA_HORSE  LHAHKLR..VDPVNFKLLSHCLLSTLAVHLPNDFTPAVHASLDKFLSSVS
    MYG_PHYCA  SHATKHK..IPIKYLEFISEAIIHVLHSRHPGDFGADAQGAMNKALELFR
    GLB5_PETMA LSGKHAK..SFQVDPQYFKVLAAVIADTVAAGDAGFEKLMSMICILLRSA
    LGB2_LUPLU LGSVHVSKGVADAHFPVVKEAILKTIKEVVGAKWSEELNSAWTIAYDELA

               151        164
    HBB_HUMAN  NALAHKYH~~~~~~
    HBB_HORSE  NALAHKYH~~~~~~
    HBA_HUMAN  TVLTSKYR~~~~~~
    HBA_HORSE  TVLTSKYR~~~~~~
    MYG_PHYCA  KDIAAKYKELGYQG
    GLB5_PETMA Y~~~~~~~~~~~~~
    LGB2_LUPLU IVIKKEMNDAA~~~

## Output file format

An image of the alignment is displayed on the specified graphics device.

### Output files for usage example

### Graphics File: prettyplot.ps

### Output files for usage example 2

### Graphics File: prettyplot.ps

## Data files

Prettyplot uses a comparison matrix file to calculate similarity to the consensus.

For protein sequences EBLOSUM62 is used for the substitution matrix. For nucleotide sequence, EDNAFULL is used.

EMBOSS data files are distributed with the application and stored in the standard EMBOSS data directory, which is defined by EMBOSS environment variable EMBOSS_DATA.

Users can provide their own data files in their own directories. Project specific files can be put in the current directory, or for tidier directory listings in a subdirectory called ".embossdata". Files for all EMBOSS runs can be put in the user's home directory, or again in a subdirectory called ".embossdata".

The directories are searched in the following order:

- . (your current directory)
- .embossdata (under your current directory)
- ~/ (your home directory)
- ~/.embossdata

## Notes

None.

## References

None.

## Warnings

None.

## Diagnostic Error Messages

None.

## Exit status

It exits with status 0 unless an error is reported.

## Known bugs

Portrait mode does not cover the whole page! This is a "feature" in plplot.

## See also

Program name | Description
--- | ---
abiview | Reads ABI file and display the trace
cirdna | Draws circular maps of DNA constructs
emma | Multiple alignment program - interface to ClustalW program
infoalign | Information on a multiple sequence alignment
lindna | Draws linear maps of DNA constructs
pepnet | Displays proteins as a helical net
pepwheel | Shows protein sequences as helices
plotcon | Plots the quality of conservation of a sequence alignment
prettyseq | Output sequence with translated ranges
remap | Display a sequence with restriction cut sites, translation etc
seealso | Finds programs sharing group names
showalign | Displays a multiple sequence alignment
showdb | Displays information on the currently available databases
showfeat | Show features of a sequence
showseq | Display a sequence with features, translation etc
sixpack | Display a DNA sequence with 6-frame translation and ORFs
textsearch | Search sequence documentation text. SRS and Entrez are faster!
tranalign | Align nucleic coding regions given the aligned proteins

## Author(s)

Ian Longden (il © sanger.ac.uk)
Sanger Institute, Wellcome Trust Genome Campus, Hinxton, Cambridge, CB10 1SA, UK.

Many features were first implemented in the EGCG program "prettyplot" by Peter Rice (pmr © ebi.ac.uk)
Informatics Division, European Bioinformatics Institute, Wellcome Trust Genome Campus, Hinxton, Cambridge CB10 1SD, UK

The original suggestions for the PrettyPlot program were from Denis Duboule and Sigfried Labeit at EMBL. Gert Vriend added the star marking. Rita Grandori suggested the -NOCOLLISION option.

## History

Completed 5th May 1999.

## Target users

This program is intended to be used by everyone and everything, from naive users to embedded scripts.

## Comments