.. raw:: html

  <LINK rel="stylesheet" type="text/css" href="../_static/MView.css">


Manual
======

Basic usage
-----------

Getting started
^^^^^^^^^^^^^^^

Given an existing sequence alignment in a file ``data.dat`` in FASTA format,
the simplest usage might be::

  mview -in fasta data.dat

Similarly, if the input file contained a CLUSTAL alignment::

  mview -in clustal data.dat

In either case, the output would be a stacked alignment with extra columns
added to show row numbers and percent identities (with respect to the first
sequence), looking something like this, regardless of the input format:

.. raw:: html

  <PRE>
  Reference sequence (1): EGFR
  Identities normalised by aligned length.

  1 EGFR      100.0%  FKKIKVLGSGAFGTVYKGLWIPEGEK---------VKIPVAIKELREATSPK-ANKEILDEAYVMASVDNPHVCRLLGIC 
  2 DMDPR2     35.7%  ISVNKQLGTGEFGIVQQGVWSNGNE-----------RIQVAIKCLCRERMQS-NPMEFLKEAAIMHSIEHENIVRLYGVV 
  3 ITK_HUMAN  32.9%  LTFVQEIGSGQFGLVHLGYWLN--------------KDKVAIKTIREGAMS---EEDFIEEAEVMMKLSHPKLVQLYGVC 
  4 GCTK2ID    21.2%  IREVKQIGVGQFGAVVLAEMTGLS-XLPKGSMNADGVALVAVKKLKPDVSD-EVLQSFDKEIKFMSQLQHDSIVQLLAIC 
  5 CEC55C3    31.5%  VELTKKLGEGAFGEVWKGKLLKILDA-------NHQPVLVAVKTAKLESMTKEQIKEIMREARLMRNLDHINVVKFFGVA 
  </PRE>

To process the output of a BLAST run use something like::

  mview -in blast blastresults.dat

while to process the output of a FASTA run (the database search program, not
the simple FASTA/Pearson data format) use something like::

  mview -in uvfasta fastaresults.dat

The ``-in`` option isn't always necessary. If the filename extension, or the
filename itself minus any directory path begins with or contains the first few
letters of the valid ``-in`` options (e.g., ``mydata.msf`` or ``mydata.fasta``
or ``tfastx_run.dat``), MView tries to choose a sensible input format,
allowing multiple files in mixed formats to be supplied on the command
line. The ``-in`` option will always override this mechanism but requires that
all input files be of the same format.


.. _ref_rulers:

Attaching a ruler
^^^^^^^^^^^^^^^^^

Add a ruler along the top, with ``-ruler on``, for example::

  mview -in fasta -ruler on data.dat

gives:

.. raw:: html

  <PRE>
  Reference sequence (1): EGFR
  Identities normalised by aligned length.

                      1 [        .         .         .         .         :         .         .         ] 80
  1 EGFR      100.0%    FKKIKVLGSGAFGTVYKGLWIPEGEK---------VKIPVAIKELREATSPK-ANKEILDEAYVMASVDNPHVCRLLGIC   
  2 DMDPR2     35.7%    ISVNKQLGTGEFGIVQQGVWSNGNE-----------RIQVAIKCLCRERMQS-NPMEFLKEAAIMHSIEHENIVRLYGVV   
  3 ITK_HUMAN  32.9%    LTFVQEIGSGQFGLVHLGYWLN--------------KDKVAIKTIREGAMS---EEDFIEEAEVMMKLSHPKLVQLYGVC   
  4 GCTK2ID    21.2%    IREVKQIGVGQFGAVVLAEMTGLS-XLPKGSMNADGVALVAVKKLKPDVSD-EVLQSFDKEIKFMSQLQHDSIVQLLAIC   
  5 CEC55C3    31.5%    VELTKKLGEGAFGEVWKGKLLKILDA-------NHQPVLVAVKTAKLESMTKEQIKEIMREARLMRNLDHINVVKFFGVA   
  </PRE>

Only one kind of ruler is currently provided, numbering the columns of the
final alignment from M to N (incrementing) or N to M (decrementing) based on
the input sequence numbering, if any. For multiple alignments like the one
above with no numbering the ruler runs from 1 to the length of the alignment.

For database searches that translate nucleotide sequences to protein, such as
TBLASTX, the rulers differ slightly in that the native query numbering is
given in nucleotide units, but MView reports amino acid units instead (using
modulo 3 arithmetic).


.. _ref_reference_row:

Changing the reference sequence
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

One can colour and compute identities with respect to a sequence other than
the first/query sequence using the ``-reference`` option. This takes either
the sequence identifier or an integer argument corresponding to the ranking or
ordering of a sequence usually shown in the first labelling column of MView
output. For multiple alignment input formats, sequences are numbered from 1,
while for searches the hits are numbered from 1, but the query itself is 0, so
beware.


Command line options
^^^^^^^^^^^^^^^^^^^^

ALl available options can be listed using::

  mview -help

There are a lot of options, but the main ones are described in this manual.


Adding HTML
-----------

Basic HTML
^^^^^^^^^^

To add some HTML markup a few extra options are needed, for example::

        mview -in fasta -html head data.dat > data.html

produces a complete page of HTML and you can load this into your Web browser
with a URL like ``file:///full/path/to/the/folder/data.html``.

To colour all the residues using the default built-in palette for proteins::

    mview -in fasta -ruler on -html head -coloring any data.dat > data.html

produces:

.. raw:: html

  <PRE>
  Colored by: property

                      1 [        .         .         .         .         :         .         .         ] 80
  1 EGFR      100.0%    <FONT COLOR="#009900">F</FONT><FONT COLOR="#cc0000">KK</FONT><FONT COLOR="#33cc00">I</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">VLG</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#33cc00">GA</FONT><FONT COLOR="#009900">F</FONT><FONT COLOR="#33cc00">G</FONT><FONT COLOR="#0099ff">T</FONT><FONT COLOR="#33cc00">V</FONT><FONT COLOR="#009900">Y</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">GL</FONT><FONT COLOR="#009900">W</FONT><FONT COLOR="#33cc00">IP</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">G</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#666666">---------</FONT><FONT COLOR="#33cc00">V</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">IPVAI</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">A</FONT><FONT COLOR="#0099ff">TS</FONT><FONT COLOR="#33cc00">P</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#666666">-</FONT><FONT COLOR="#33cc00">A</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">IL</FONT><FONT COLOR="#0033ff">DE</FONT><FONT COLOR="#33cc00">A</FONT><FONT COLOR="#009900">Y</FONT><FONT COLOR="#33cc00">VMA</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#33cc00">V</FONT><FONT COLOR="#0033ff">D</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#33cc00">P</FONT><FONT COLOR="#009900">H</FONT><FONT COLOR="#33cc00">V</FONT><FONT COLOR="#ffff00">C</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#33cc00">LLGI</FONT><FONT COLOR="#ffff00">C</FONT>   
  2 DMDPR2     35.7%    <FONT COLOR="#33cc00">I</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#33cc00">V</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#33cc00">LG</FONT><FONT COLOR="#0099ff">T</FONT><FONT COLOR="#33cc00">G</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#009900">F</FONT><FONT COLOR="#33cc00">GIV</FONT><FONT COLOR="#6600cc">QQ</FONT><FONT COLOR="#33cc00">GV</FONT><FONT COLOR="#009900">W</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#33cc00">G</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#666666">-----------</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#33cc00">I</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#33cc00">VAI</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#ffff00">C</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#ffff00">C</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#33cc00">M</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#666666">-</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#33cc00">PM</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#009900">F</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">AAIM</FONT><FONT COLOR="#009900">H</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#33cc00">I</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#009900">H</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#33cc00">IV</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#009900">Y</FONT><FONT COLOR="#33cc00">GVV</FONT>   
  3 ITK_HUMAN  32.9%    <FONT COLOR="#33cc00">L</FONT><FONT COLOR="#0099ff">T</FONT><FONT COLOR="#009900">F</FONT><FONT COLOR="#33cc00">V</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">IG</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#33cc00">G</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#009900">F</FONT><FONT COLOR="#33cc00">GLV</FONT><FONT COLOR="#009900">H</FONT><FONT COLOR="#33cc00">LG</FONT><FONT COLOR="#009900">YW</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#666666">--------------</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#0033ff">D</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">VAI</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#0099ff">T</FONT><FONT COLOR="#33cc00">I</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">GAM</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#666666">---</FONT><FONT COLOR="#0033ff">EED</FONT><FONT COLOR="#009900">F</FONT><FONT COLOR="#33cc00">I</FONT><FONT COLOR="#0033ff">EE</FONT><FONT COLOR="#33cc00">A</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">VMM</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#009900">H</FONT><FONT COLOR="#33cc00">P</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">LV</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#009900">Y</FONT><FONT COLOR="#33cc00">GV</FONT><FONT COLOR="#ffff00">C</FONT>   
  4 GCTK2ID    21.2%    <FONT COLOR="#33cc00">I</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">V</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#33cc00">IGVG</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#009900">F</FONT><FONT COLOR="#33cc00">GAVVLA</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">M</FONT><FONT COLOR="#0099ff">T</FONT><FONT COLOR="#33cc00">GL</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#666666">-X</FONT><FONT COLOR="#33cc00">LP</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">G</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#33cc00">M</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#33cc00">A</FONT><FONT COLOR="#0033ff">D</FONT><FONT COLOR="#33cc00">GVALVAV</FONT><FONT COLOR="#cc0000">KK</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">P</FONT><FONT COLOR="#0033ff">D</FONT><FONT COLOR="#33cc00">V</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#0033ff">D</FONT><FONT COLOR="#666666">-</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">VL</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#009900">F</FONT><FONT COLOR="#0033ff">D</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">I</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#009900">F</FONT><FONT COLOR="#33cc00">M</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#009900">H</FONT><FONT COLOR="#0033ff">D</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#33cc00">IV</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#33cc00">LLAI</FONT><FONT COLOR="#ffff00">C</FONT>   
  5 CEC55C3    31.5%    <FONT COLOR="#33cc00">V</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#0099ff">T</FONT><FONT COLOR="#cc0000">KK</FONT><FONT COLOR="#33cc00">LG</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">GA</FONT><FONT COLOR="#009900">F</FONT><FONT COLOR="#33cc00">G</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">V</FONT><FONT COLOR="#009900">W</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">G</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">LL</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">IL</FONT><FONT COLOR="#0033ff">D</FONT><FONT COLOR="#33cc00">A</FONT><FONT COLOR="#666666">-------</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#009900">H</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#33cc00">PVLVAV</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#0099ff">T</FONT><FONT COLOR="#33cc00">A</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#33cc00">M</FONT><FONT COLOR="#0099ff">T</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#33cc00">I</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">IM</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">A</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#33cc00">LM</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#0033ff">D</FONT><FONT COLOR="#009900">H</FONT><FONT COLOR="#33cc00">I</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#33cc00">VV</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#009900">FF</FONT><FONT COLOR="#33cc00">GVA</FONT>   
  </PRE>

To make the letters stand out use the ``-bold`` option::

  mview -in fasta -ruler on -html head -bold -coloring any data.dat > data.html

giving:

.. raw:: html

  <PRE>
  Colored by: property

                     <STRONG> 1</STRONG> <STRONG>[        .         .         .         .         :         .         .         ]</STRONG> <STRONG>80</STRONG>
  1 EGFR      100.0% <STRONG>  </STRONG> <STRONG><FONT COLOR="#009900">F</FONT><FONT COLOR="#cc0000">KK</FONT><FONT COLOR="#33cc00">I</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">VLG</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#33cc00">GA</FONT><FONT COLOR="#009900">F</FONT><FONT COLOR="#33cc00">G</FONT><FONT COLOR="#0099ff">T</FONT><FONT COLOR="#33cc00">V</FONT><FONT COLOR="#009900">Y</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">GL</FONT><FONT COLOR="#009900">W</FONT><FONT COLOR="#33cc00">IP</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">G</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#666666">---------</FONT><FONT COLOR="#33cc00">V</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">IPVAI</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">A</FONT><FONT COLOR="#0099ff">TS</FONT><FONT COLOR="#33cc00">P</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#666666">-</FONT><FONT COLOR="#33cc00">A</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">IL</FONT><FONT COLOR="#0033ff">DE</FONT><FONT COLOR="#33cc00">A</FONT><FONT COLOR="#009900">Y</FONT><FONT COLOR="#33cc00">VMA</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#33cc00">V</FONT><FONT COLOR="#0033ff">D</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#33cc00">P</FONT><FONT COLOR="#009900">H</FONT><FONT COLOR="#33cc00">V</FONT><FONT COLOR="#ffff00">C</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#33cc00">LLGI</FONT><FONT COLOR="#ffff00">C</FONT></STRONG> <STRONG>  </STRONG>
  2 DMDPR2     35.7% <STRONG>  </STRONG> <STRONG><FONT COLOR="#33cc00">I</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#33cc00">V</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#33cc00">LG</FONT><FONT COLOR="#0099ff">T</FONT><FONT COLOR="#33cc00">G</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#009900">F</FONT><FONT COLOR="#33cc00">GIV</FONT><FONT COLOR="#6600cc">QQ</FONT><FONT COLOR="#33cc00">GV</FONT><FONT COLOR="#009900">W</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#33cc00">G</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#666666">-----------</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#33cc00">I</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#33cc00">VAI</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#ffff00">C</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#ffff00">C</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#33cc00">M</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#666666">-</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#33cc00">PM</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#009900">F</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">AAIM</FONT><FONT COLOR="#009900">H</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#33cc00">I</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#009900">H</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#33cc00">IV</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#009900">Y</FONT><FONT COLOR="#33cc00">GVV</FONT></STRONG> <STRONG>  </STRONG>
  3 ITK_HUMAN  32.9% <STRONG>  </STRONG> <STRONG><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#0099ff">T</FONT><FONT COLOR="#009900">F</FONT><FONT COLOR="#33cc00">V</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">IG</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#33cc00">G</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#009900">F</FONT><FONT COLOR="#33cc00">GLV</FONT><FONT COLOR="#009900">H</FONT><FONT COLOR="#33cc00">LG</FONT><FONT COLOR="#009900">YW</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#666666">--------------</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#0033ff">D</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">VAI</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#0099ff">T</FONT><FONT COLOR="#33cc00">I</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">GAM</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#666666">---</FONT><FONT COLOR="#0033ff">EED</FONT><FONT COLOR="#009900">F</FONT><FONT COLOR="#33cc00">I</FONT><FONT COLOR="#0033ff">EE</FONT><FONT COLOR="#33cc00">A</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">VMM</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#009900">H</FONT><FONT COLOR="#33cc00">P</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">LV</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#009900">Y</FONT><FONT COLOR="#33cc00">GV</FONT><FONT COLOR="#ffff00">C</FONT></STRONG> <STRONG>  </STRONG>
  4 GCTK2ID    21.2% <STRONG>  </STRONG> <STRONG><FONT COLOR="#33cc00">I</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">V</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#33cc00">IGVG</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#009900">F</FONT><FONT COLOR="#33cc00">GAVVLA</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">M</FONT><FONT COLOR="#0099ff">T</FONT><FONT COLOR="#33cc00">GL</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#666666">-X</FONT><FONT COLOR="#33cc00">LP</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">G</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#33cc00">M</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#33cc00">A</FONT><FONT COLOR="#0033ff">D</FONT><FONT COLOR="#33cc00">GVALVAV</FONT><FONT COLOR="#cc0000">KK</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">P</FONT><FONT COLOR="#0033ff">D</FONT><FONT COLOR="#33cc00">V</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#0033ff">D</FONT><FONT COLOR="#666666">-</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">VL</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#009900">F</FONT><FONT COLOR="#0033ff">D</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">I</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#009900">F</FONT><FONT COLOR="#33cc00">M</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#009900">H</FONT><FONT COLOR="#0033ff">D</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#33cc00">IV</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#33cc00">LLAI</FONT><FONT COLOR="#ffff00">C</FONT></STRONG> <STRONG>  </STRONG>
  5 CEC55C3    31.5% <STRONG>  </STRONG> <STRONG><FONT COLOR="#33cc00">V</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#0099ff">T</FONT><FONT COLOR="#cc0000">KK</FONT><FONT COLOR="#33cc00">LG</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">GA</FONT><FONT COLOR="#009900">F</FONT><FONT COLOR="#33cc00">G</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">V</FONT><FONT COLOR="#009900">W</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">G</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">LL</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">IL</FONT><FONT COLOR="#0033ff">D</FONT><FONT COLOR="#33cc00">A</FONT><FONT COLOR="#666666">-------</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#009900">H</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#33cc00">PVLVAV</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#0099ff">T</FONT><FONT COLOR="#33cc00">A</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#0099ff">S</FONT><FONT COLOR="#33cc00">M</FONT><FONT COLOR="#0099ff">T</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#6600cc">Q</FONT><FONT COLOR="#33cc00">I</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">IM</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#0033ff">E</FONT><FONT COLOR="#33cc00">A</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#33cc00">LM</FONT><FONT COLOR="#cc0000">R</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#33cc00">L</FONT><FONT COLOR="#0033ff">D</FONT><FONT COLOR="#009900">H</FONT><FONT COLOR="#33cc00">I</FONT><FONT COLOR="#6600cc">N</FONT><FONT COLOR="#33cc00">VV</FONT><FONT COLOR="#cc0000">K</FONT><FONT COLOR="#009900">FF</FONT><FONT COLOR="#33cc00">GVA</FONT></STRONG> <STRONG>  </STRONG>
  </PRE>

Or change the colouring to use blocked letters with ``-css on`` instead::

  mview -in fasta -ruler on -html head -css on -coloring any data.dat > data.html

giving:

.. raw:: html

  <PRE>
  Colored by: property

                      1 [        .         .         .         .         :         .         .         ] 80
  1 EGFR      100.0%    <FONT CLASS=S13>F</FONT><FONT CLASS=S17>KK</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>VLG</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>GA</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S13>Y</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>GL</FONT><FONT CLASS=S13>W</FONT><FONT CLASS=S14>IP</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">---------</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>IPVAI</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=S9>TS</FONT><FONT CLASS=S14>P</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">-</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>IL</FONT><FONT CLASS=S12>DE</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=S13>Y</FONT><FONT CLASS=S14>VMA</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S14>P</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S7>C</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S14>LLGI</FONT><FONT CLASS=S7>C</FONT>   
  2 DMDPR2     35.7%    <FONT CLASS=S14>I</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>LG</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>GIV</FONT><FONT CLASS=S8>QQ</FONT><FONT CLASS=S14>GV</FONT><FONT CLASS=S13>W</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S12>E</FONT><FONT COLOR="#666666">-----------</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>VAI</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S7>C</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S7>C</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S9>S</FONT><FONT COLOR="#666666">-</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S14>PM</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>AAIM</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S14>IV</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S13>Y</FONT><FONT CLASS=S14>GVV</FONT>   
  3 ITK_HUMAN  32.9%    <FONT CLASS=S14>L</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>IG</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>GLV</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=S14>LG</FONT><FONT CLASS=S13>YW</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S8>N</FONT><FONT COLOR="#666666">--------------</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>VAI</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>GAM</FONT><FONT CLASS=S9>S</FONT><FONT COLOR="#666666">---</FONT><FONT CLASS=S12>EED</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S12>EE</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>VMM</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=S14>P</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>LV</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S13>Y</FONT><FONT CLASS=S14>GV</FONT><FONT CLASS=S7>C</FONT>   
  4 GCTK2ID    21.2%    <FONT CLASS=S14>I</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>IGVG</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>GAVVLA</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S14>GL</FONT><FONT CLASS=S9>S</FONT><FONT COLOR="#666666">-</FONT><FONT CLASS=T19>X</FONT><FONT CLASS=S14>LP</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S14>GVALVAV</FONT><FONT CLASS=S17>KK</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>P</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S12>D</FONT><FONT COLOR="#666666">-</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>VL</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>IV</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>LLAI</FONT><FONT CLASS=S7>C</FONT>   
  5 CEC55C3    31.5%    <FONT CLASS=S14>V</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S17>KK</FONT><FONT CLASS=S14>LG</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>GA</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S13>W</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>LL</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>IL</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S14>A</FONT><FONT COLOR="#666666">-------</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>PVLVAV</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>IM</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S14>LM</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S14>VV</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S13>FF</FONT><FONT CLASS=S14>GVA</FONT>   
  </PRE>

You can combine ``-css on`` with ``-bold`` to make the blocks and letters even
more prominent.

If your data are DNA or RNA, add the option ``-moltype dna`` (or ``rna`` or
``na`` for "nucleic acid") to change to the default nucleotide colour
palette. Here's an MView run on some BLASTN data demonstrating some other
options as well::

  mview -in blast -ruler on -html head -css on -coloring identity -moltype dna -top 5 -range 250:310 blastn.dat

which (slightly edited to reduce space) produced:

.. raw:: html

  <PRE>
  HSP processing: ranked
  Query orientation: +
                                                                             250 [         .         .         .         .         3         ] 310
    EMBOSS_001                   bits E-value N qy ht 100.0%   1:521             <FONT CLASS=S9>T</FONT><FONT CLASS=S12>GAAG</FONT><FONT CLASS=S9>CCT</FONT><FONT CLASS=S12>G</FONT><FONT CLASS=S9>C</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>CTT</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>CTC</FONT><FONT CLASS=S12>AGGA</FONT><FONT CLASS=S9>CTC</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>TC</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S12>GA</FONT><FONT CLASS=S9>CT</FONT><FONT CLASS=S12>G</FONT><FONT CLASS=S9>C</FONT><FONT CLASS=S12>G</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>CC</FONT><FONT CLASS=S12>AA</FONT><FONT CLASS=S9>TTC</FONT><FONT CLASS=S12>G</FONT><FONT CLASS=S9>TCTT</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>CTC</FONT><FONT CLASS=S12>AGGA</FONT><FONT CLASS=S9>CT</FONT>    
  1 EM_EST:GT222018.2 gh1574...  1033     0.0 1  +  + 100.0%   1:521   4:524     <FONT CLASS=S9>T</FONT><FONT CLASS=S12>GAAG</FONT><FONT CLASS=S9>CCT</FONT><FONT CLASS=S12>G</FONT><FONT CLASS=S9>C</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>CTT</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>CTC</FONT><FONT CLASS=S12>AGGA</FONT><FONT CLASS=S9>CTC</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>TC</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S12>GA</FONT><FONT CLASS=S9>CT</FONT><FONT CLASS=S12>G</FONT><FONT CLASS=S9>C</FONT><FONT CLASS=S12>G</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>CC</FONT><FONT CLASS=S12>AA</FONT><FONT CLASS=S9>TTC</FONT><FONT CLASS=S12>G</FONT><FONT CLASS=S9>TCTT</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>CTC</FONT><FONT CLASS=S12>AGGA</FONT><FONT CLASS=S9>CT</FONT>    
  2 EM_EST:GT222017.1 gh1572...   186   4e-43 1  +  +  98.2% 256:372 205:318     <FONT COLOR="#666666">------</FONT><FONT CLASS=S9>CT</FONT><FONT CLASS=S12>G</FONT><FONT CLASS=S9>C</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>CTT</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>CTC</FONT><FONT CLASS=S12>AGGA</FONT><FONT CLASS=S9>CTC</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>TC</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S12>GA</FONT><FONT CLASS=S9>CT</FONT><FONT CLASS=S12>G</FONT><FONT CLASS=S9>C</FONT><FONT CLASS=S12>G</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>CC</FONT><FONT CLASS=S12>AA</FONT><FONT CLASS=S9>TTC</FONT><FONT CLASS=S12>G</FONT><FONT CLASS=S9>T</FONT><FONT COLOR="#666666">-</FONT><FONT CLASS=S9>TT</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>CTC</FONT><FONT CLASS=S12>AGGA</FONT><FONT CLASS=S9>CT</FONT>    
  3 EM_EST:GT222024.2 gh1633...   182   7e-42 1  +  +  95.9% 262:372  96:209     <FONT COLOR="#666666">------------</FONT><FONT CLASS=S9>TT</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>CTC</FONT><FONT CLASS=S12>AGGA</FONT><FONT CLASS=S9>CTC</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>TC</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S12>GA</FONT><FONT CLASS=S9>CT</FONT><FONT CLASS=S12>G</FONT><FONT CLASS=S9>C</FONT><FONT CLASS=S12>G</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>CC</FONT><FONT CLASS=S12>AA</FONT><FONT CLASS=S9>TTC</FONT><FONT CLASS=S12>G</FONT><FONT CLASS=S9>TCtt</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>CTC</FONT><FONT CLASS=S12>AGGA</FONT><FONT CLASS=S9>CT</FONT>    
  4 EM_EST:GT222023.2 gh1631...   182   7e-42 1  +  +  95.9% 262:372  96:209     <FONT COLOR="#666666">------------</FONT><FONT CLASS=S9>TT</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>CTC</FONT><FONT CLASS=S12>AGGA</FONT><FONT CLASS=S9>CTC</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>TC</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S12>GA</FONT><FONT CLASS=S9>CT</FONT><FONT CLASS=S12>G</FONT><FONT CLASS=S9>C</FONT><FONT CLASS=S12>G</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>CC</FONT><FONT CLASS=S12>AA</FONT><FONT CLASS=S9>TTC</FONT><FONT CLASS=S12>G</FONT><FONT CLASS=S9>TCtt</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>CTC</FONT><FONT CLASS=S12>AGGA</FONT><FONT CLASS=S9>CT</FONT>    
  5 EM_EST:GT222054.2 gh721 ...   178   1e-40 1  +  + 100.0% 279:372    4:97     <FONT COLOR="#666666">-----------------------------</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S12>GA</FONT><FONT CLASS=S9>CT</FONT><FONT CLASS=S12>G</FONT><FONT CLASS=S9>C</FONT><FONT CLASS=S12>G</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>CC</FONT><FONT CLASS=S12>AA</FONT><FONT CLASS=S9>TTC</FONT><FONT CLASS=S12>G</FONT><FONT CLASS=S9>TCTT</FONT><FONT CLASS=S12>A</FONT><FONT CLASS=S9>CTC</FONT><FONT CLASS=S12>AGGA</FONT><FONT CLASS=S9>CT</FONT>    
  </PRE>

showing scoring and sequence range information parsed from the BLASTN run, and
using the default nucleotide colouring scheme (purines, dark blue;
pyrimidines, light blue). Notice the lower-cased pairs of thymines near the
end of sequences 3 and 4, columns 299--300 indicating where a segment of hit
sequence has been excised to close a gap in the query (see
:ref:`ref_funny_sequences`).


Controlling the amount of HTML
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

There are several values that can be passed to the ``-html`` option: ``head``,
``body``, ``data``, ``full``, ``off``.

**Mode** ``head``

Produces a complete web page. Output includes the style sheet if ``-css on``
was given. The most common situation.

**Mode** ``body``

Produces just the ``<BODY></BODY>`` part of the web page.  Note: the style
sheet produced by ``-css on`` will be missing.

**Mode** ``data``

Produces just the alignment part of the web page. Note: any style sheet
produced by ``-css on`` will be missing.

**Mode** ``full``

Produces a complete web page with the ``MIME-type "text/html"``, suitable for
serving directly from a web server. Output includes the style sheet if ``-css
on`` was given.

**Mode** ``off``

Switches off HTML (default).


Using an external CSS style sheet
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

The option ``-listcss`` dumps the style sheet to stdout, so you can share that
across MView invocations from a web server. Each would be of the form::

  mview -css URL ...

where the URL specifies the location of the style sheet as seen by the web
server (i.e., ``file:///some/path`` or ``http://server/path``).

If you build a new colour palette you can load it into MView and save the new
CSS file. Suppose you have a new palette in ``palette.dat``::

  mview -colorfile palette.dat -listcss

will dump the new style sheet for use as before.


.. _ref_consensus_sequences:

Consensus sequences
-------------------

Clustal conservation line
^^^^^^^^^^^^^^^^^^^^^^^^^

A Clustal-style conservation line of ``*:.`` symbols can be added to any
alignment (not just one from CLUSTAL itself) using ``-conservation on``, like
this:

.. raw:: html

  <PRE>
                           1 [        .         .         .         .         :         .         .         ] 80
  1 DMD401_1-640   100.0%    LQLDTVLGEGEFGQVLKGFATEIAG---------LPGITTVAVKMLKKGSNSV------------EYMALLSEFQLLQEV   
  2 CER09D1_11-435  22.2%    DTFNRKLGKGKFGIINKGLLTLRICKTNE------VVQVNVAVKKMVDPTDEK------------QDKLIYDEIKLMEYN   
  3 EGFR            26.7%    FKKIKVLGSGAFGTVYKGLWIPEGEK----------VKIPVAIKELREATSPK------------ANKEILDEAYVMASV   
  4 DMDPR2_1-384    25.4%    ISVNKQLGTGEFGIVQQGVWSNGNE------------RIQVAIKCLCRERMQS------------NPMEFLKEAAIMHSI   
  5 ITK_HUMAN-620   22.0%    LTFVQEIGSGQFGLVHLGYWLN---------------KDKVAIKTIREGAMS--------------EEDFIEEAEVMMKL   
    clustal                        :* * ** :  *                      **:* :                       :  *  ::      
  </PRE>

The symbols are ``*`` for full column identity, and ``:`` or ``.`` for strong
and weak amino acid grouping, respectively, as defined in CLUSTAL.

For DNA or RNA sequences, if the molecule type was set to nucleic acid with
``-moltype na`` or ``dna`` or ``rna``, then the clustal conservation line will
show only the column identities.

Note: these conservation lines can be generated for any subset of rows
extracted using the various row filtering options (see
:ref:`ref_filtering_rows`).


Consensus lines
^^^^^^^^^^^^^^^

Consensus lines can be added beneath the alignment using ``-consensus on``. By
default, this adds four extra lines of consensus sequences computed at various
thresholds of percentage composition of the columns.

There are default consensus patterns for protein and nucleotide (either DNA or
RNA) sequences. MView starts up with the default protein consensus pattern,
for example::

  mview ... -consensus on ...

gives:

.. raw:: html

  <PRE>
                           1 [        .         .         .         .         :         .         .         ] 80
  1 EGFR           100.0%    FKKIKVLGSGAFGTVYKGLWIPEGEK---------VKIPVAIKELREATSPK-ANKEILDEAYVMASVDNPHVCRLLGIC   
  2 DMDPR2          35.7%    ISVNKQLGTGEFGIVQQGVWSNGNE-----------RIQVAIKCLCRERMQS-NPMEFLKEAAIMHSIEHENIVRLYGVV   
  3 ITK_HUMAN       32.9%    LTFVQEIGSGQFGLVHLGYWLN--------------KDKVAIKTIREGAMS---EEDFIEEAEVMMKLSHPKLVQLYGVC   
  4 GCTK2ID         21.2%    IREVKQIGVGQFGAVVLAEMTGLS-XLPKGSMNADGVALVAVKKLKPDVSD-EVLQSFDKEIKFMSQLQHDSIVQLLAIC   
  5 CEC55C3         31.5%    VELTKKLGEGAFGEVWKGKLLKILDA-------NHQPVLVAVKTAKLESMTKEQIKEIMREARLMRNLDHINVVKFFGVA   
    consensus/100%           hp..p.lG.GtFG.V..u.h...................VAlKphp.t........ph.cEh.hM.plpp.plsphhuls   
    consensus/90%            hp..p.lG.GtFG.V..u.h...................VAlKphp.t........ph.cEh.hM.plpp.plsphhuls   
    consensus/80%            lphsKplGsGtFGhVhhGhhhs..............hh.VAlKpl+.ts.s....p-hhcEAtlMtplpH.plVpLhGls   
    consensus/70%            lphsKplGsGtFGhVhhGhhhs..............hh.VAlKpl+.ts.s....p-hhcEAtlMtplpH.plVpLhGls   
  </PRE>


Changing consensus thresholds
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

The default consensus mechanism displays consensus lines calculated at four
levels of identity (100%, 90%, 80%, 70%). This can be changed to show as many
or as few consensus lines at any level of percent identity between 50 and 100%
using the ``-con_threshold`` option and a comma-separated list of identities::

  mview ... -consensus on -con_threshold 80 ...

would give a single consensus line calculated at 80% identity, while::

  mview ... -consensus on -con_threshold 80,65 ...

would produce two lines at 80% and 65% identity.


Consensus pattern definitions
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Consensus patterns are based on equivalence classes, that is, sets of residues
that share some predefined property. These classes are not mutually exclusive
and the consensus mechanism will choose the most specific class that
summarizes a given column at the desired percent identity.

The default for protein alignments is called ``P1`` and is defined by
physicochemical property as follows:

.. raw:: html

  <PRE>
  <FONT COLOR="#000000">[P1]</FONT>
  <FONT COLOR="#aa6666">#Protein consensus: conserved physicochemical classes, derived from
  #the Venn diagrams of: Taylor W. R. (1986). The classification of amino acid
  #conservation. J. Theor. Biol. 119:205-218.
  #description =>  symbol  members</FONT>
  *            =>  .     
  A            =>  A       { A }
  C            =>  C       { C }
  D            =>  D       { D }
  E            =>  E       { E }
  F            =>  F       { F }
  G            =>  G       { G }
  H            =>  H       { H }
  I            =>  I       { I }
  K            =>  K       { K }
  L            =>  L       { L }
  M            =>  M       { M }
  N            =>  N       { N }
  P            =>  P       { P }
  Q            =>  Q       { Q }
  R            =>  R       { R }
  S            =>  S       { S }
  T            =>  T       { T }
  V            =>  V       { V }
  W            =>  W       { W }
  Y            =>  Y       { Y }
  alcohol      =>  o       { S, T }
  aliphatic    =>  l       { I, L, V }
  aromatic     =>  a       { F, H, W, Y }
  charged      =>  c       { D, E, H, K, R }
  hydrophobic  =>  h       { A, C, F, G, H, I, K, L, M, R, T, V, W, Y }
  negative     =>  -       { D, E }
  polar        =>  p       { C, D, E, H, K, N, Q, R, S, T }
  positive     =>  +       { H, K, R }
  small        =>  s       { A, C, D, G, N, P, S, T, V }
  tiny         =>  u       { A, G, S }
  turnlike     =>  t       { A, C, D, E, G, H, K, N, Q, R, S, T }
  </PRE>

The default nucleotide consensus pattern is ``D1`` grouping bases by ring type
(purine, pyrimidine). It is selected when any of the nucleotide molecule types
is set ``-moltype na`` (for "nucleic acid"; also ``dna`` or ``rna``), for
example::

  mview ... -consensus on -moltype dna ...

and has the following definition:

.. raw:: html

  <PRE>
  <FONT COLOR="#000000">[D1]</FONT>
  <FONT COLOR="#aa6666">#DNA consensus: conserved ring types
  #Ambiguous base R is A or G
  #Ambiguous base Y is C or T or U
  #description =>  symbol  members</FONT>
  *            =>  .     
  A            =>  A       { A }
  C            =>  C       { C }
  G            =>  G       { G }
  T            =>  T       { T }
  U            =>  U       { U }
  purine       =>  r       { A, G, R }
  pyrimidine   =>  y       { C, T, U, Y }
  </PRE>


.. _ref_changeing_consensus_patterns:

Changing consensus patterns
^^^^^^^^^^^^^^^^^^^^^^^^^^^

The available list of built-in patterns can be seen with ``-listgroups``.

Alternative equivalence classes can be selected using ``-con_groupmap``. For
example, to select the ``CYS`` built-in consensus pattern to show only
conserved cysteines you would use an invocation like::

  mview ... -consensus on -con_groupmap CYS ...

New groups can be defined in the same format and read in from a file using
the ``-groupfile`` option.


.. _ref_conserved_symbols or conserved classes:

Showing conserved symbols or conserved classes
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Two options ``-con_ignore`` and ``-con_gaps`` can be used to tune the
consensus lines. Consider the following alignment:

.. raw:: html

  <PRE>
                          1 [        .         .         .         .         :         .         .         ] 80
  1 EGFR          100.0%    FKKIKVLGSGAFGTVYKGLWIPEGEK---------VKIPVAIKELREATSPK-ANKEILDEAYVMASVDNPHVCRLLGIC   
  2 DMDPR2         35.7%    ISVNKQLGTGEFGIVQQGVWSNGNE-----------RIQVAIKCLCRERMQS-NPMEFLKEAAIMHSIEHENIVRLYGVV   
  3 ITK_HUMAN      32.9%    LTFVQEIGSGQFGLVHLGYWLN--------------KDKVAIKTIREGAMS---EEDFIEEAEVMMKLSHPKLVQLYGVC   
  4 GCTK2ID        21.2%    IREVKQIGVGQFGAVVLAEMTGLS-XLPKGSMNADGVALVAVKKLKPDVSD-EVLQSFDKEIKFMSQLQHDSIVQLLAIC   
  5 CEC55C3        31.5%    VELTKKLGEGAFGEVWKGKLLKILDA-------NHQPVLVAVKTAKLESMTKEQIKEIMREARLMRNLDHINVVKFFGVA   
  </PRE>

The default consensus pattern for proteins, with these options::

  mview ... -consensus on -con_threshold 80 ...

would add this consensus line:

.. raw:: html

  <PRE>
    consensus/80%           lphsKplGsGtFGhVhhGhhhs..............hh.VAlKpl+.ts.s....p-hhcEAtlMtplpH.plVpLhGls   
  </PRE>

comprising a mixture of conserved residue classes and residues, whichever is
more specific.

If you just want to see the conserved physicochemical classes, use ``-con_ignore singleton``:

.. raw:: html

  <PRE>
    consensus/80%           lphs+plusutauhlhhuhhhs..............hh.lul+pl+.ts.s....p-hhc-utlhtplp+.pllplhuls   
  </PRE>

Alternatively, to see just the conserved residues, use ``-con_ignore class``:

.. raw:: html

  <PRE>
    consensus/80%           ....K..G.G.FG.V..G.....................VA.K.................EA..M....H...V.L.G..   
  </PRE>

Lastly, the default consensus computation counts gap characters in each
column, so that gapped regions are diluted and may not show up in the
consensus. Building on the last example, setting ``-con_gaps off`` prevents
this:

.. raw:: html

  <PRE>
    consensus/80%           ....K..G.G.FG.V..G........LPKGSMN......VA.K.........E.......EA..M....H...V.L.G..   
  </PRE>

The consensus sequence now runs the full length of the alignment because the
insert in sequence 4 spanning the gap has been added to the consensus. This is
a little contrived in this case, but is sometimes useful when you want to
preserve as much of the alignment as possible.

These options work similarly with nucleotide alignments and with any other
consensus pattern you choose.

Note: it is possible to colour the consensus sequences independently of the
alignment (see :ref:`ref_consensus_colouring`).


Colouring modes
---------------


.. _ref_alignment_colouring:

Alignment colouring
^^^^^^^^^^^^^^^^^^^

There are several basic ways to colour the alignment using the ``-coloring``
option which takes four modes: ``any``, ``identity``, ``consensus``,
``group``.


**Mode** ``any``

The simplest is to colour every residue according to the currently selected
palette::

  mview ... -coloring any ...

gives:

.. raw:: html

  <PRE>
  1 EGFR      100.0%  <FONT CLASS=S13>F</FONT><FONT CLASS=S17>KK</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>VLG</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>GA</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S13>Y</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>GL</FONT><FONT CLASS=S13>W</FONT><FONT CLASS=S14>IP</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">---------</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>IPVAI</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=S9>TS</FONT><FONT CLASS=S14>P</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">-</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>IL</FONT><FONT CLASS=S12>DE</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=S13>Y</FONT><FONT CLASS=S14>VMA</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S14>P</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S7>C</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S14>LLGI</FONT><FONT CLASS=S7>C</FONT> 
  2 DMDPR2     35.7%  <FONT CLASS=S14>I</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>LG</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>GIV</FONT><FONT CLASS=S8>QQ</FONT><FONT CLASS=S14>GV</FONT><FONT CLASS=S13>W</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S12>E</FONT><FONT COLOR="#666666">-----------</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>VAI</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S7>C</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S7>C</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S9>S</FONT><FONT COLOR="#666666">-</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S14>PM</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>AAIM</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S14>IV</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S13>Y</FONT><FONT CLASS=S14>GVV</FONT> 
  3 ITK_HUMAN  32.9%  <FONT CLASS=S14>L</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>IG</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>GLV</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=S14>LG</FONT><FONT CLASS=S13>YW</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S8>N</FONT><FONT COLOR="#666666">--------------</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>VAI</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>GAM</FONT><FONT CLASS=S9>S</FONT><FONT COLOR="#666666">---</FONT><FONT CLASS=S12>EED</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S12>EE</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>VMM</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=S14>P</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>LV</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S13>Y</FONT><FONT CLASS=S14>GV</FONT><FONT CLASS=S7>C</FONT> 
  4 GCTK2ID    21.2%  <FONT CLASS=S14>I</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>IGVG</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>GAVVLA</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S14>GL</FONT><FONT CLASS=S9>S</FONT><FONT COLOR="#666666">-</FONT><FONT CLASS=T19>X</FONT><FONT CLASS=S14>LP</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S14>GVALVAV</FONT><FONT CLASS=S17>KK</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>P</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S12>D</FONT><FONT COLOR="#666666">-</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>VL</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>IV</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>LLAI</FONT><FONT CLASS=S7>C</FONT> 
  5 CEC55C3    31.5%  <FONT CLASS=S14>V</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S17>KK</FONT><FONT CLASS=S14>LG</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>GA</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S13>W</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>LL</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>IL</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S14>A</FONT><FONT COLOR="#666666">-------</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>PVLVAV</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>IM</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S14>LM</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S14>VV</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S13>FF</FONT><FONT CLASS=S14>GVA</FONT> 
  </PRE>


**Mode** ``identity``

You can colour only those residues that are identical to some reference
sequence (usually the query or first row) with::

  mview ... -coloring identity ...

to produce:

.. raw:: html

  <PRE>
  1 EGFR      100.0%  <FONT CLASS=S13>F</FONT><FONT CLASS=S17>KK</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>VLG</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>GA</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S13>Y</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>GL</FONT><FONT CLASS=S13>W</FONT><FONT CLASS=S14>IP</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">---------</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>IPVAI</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=S9>TS</FONT><FONT CLASS=S14>P</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">-</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>IL</FONT><FONT CLASS=S12>DE</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=S13>Y</FONT><FONT CLASS=S14>VMA</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S14>P</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S7>C</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S14>LLGI</FONT><FONT CLASS=S7>C</FONT> 
  2 DMDPR2     35.7%  <FONT CLASS=T19>ISVN</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T19>Q</FONT><FONT CLASS=S14>LG</FONT><FONT CLASS=T19>T</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>E</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>I</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=T19>QQ</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>V</FONT><FONT CLASS=S13>W</FONT><FONT CLASS=T19>SNGN</FONT><FONT CLASS=S12>E</FONT><FONT COLOR="#666666">-----------</FONT><FONT CLASS=T19>R</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=T19>Q</FONT><FONT CLASS=S14>VAI</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T19>C</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=T19>CRERMQS</FONT><FONT COLOR="#666666">-</FONT><FONT CLASS=T19>NPM</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=T19>F</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=T19>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=T19>AI</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=T19>H</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=T19>IEHENIV</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=T19>Y</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>VV</FONT> 
  3 ITK_HUMAN  32.9%  <FONT CLASS=T19>LTFVQEI</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>Q</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>L</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=T19>HL</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>Y</FONT><FONT CLASS=S13>W</FONT><FONT CLASS=T19>LN</FONT><FONT COLOR="#666666">--------------</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T19>DK</FONT><FONT CLASS=S14>VAI</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T19>TI</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=T19>GAMS</FONT><FONT COLOR="#666666">---</FONT><FONT CLASS=T19>EEDFIE</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=T19>E</FONT><FONT CLASS=S14>VM</FONT><FONT CLASS=T19>MKLSH</FONT><FONT CLASS=S14>P</FONT><FONT CLASS=T19>KLVQ</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=T19>Y</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>V</FONT><FONT CLASS=S7>C</FONT> 
  4 GCTK2ID    21.2%  <FONT CLASS=T19>IREV</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T19>QI</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>V</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>Q</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>A</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=T19>VLAEMTGLS</FONT><FONT COLOR="#666666">-</FONT><FONT CLASS=T19>XLPKGSMNADGVAL</FONT><FONT CLASS=S14>VA</FONT><FONT CLASS=T19>V</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T19>K</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=T19>KPDV</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=T19>D</FONT><FONT COLOR="#666666">-</FONT><FONT CLASS=T19>EVLQSFDK</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=T19>IKF</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=T19>SQLQHDSIVQ</FONT><FONT CLASS=S14>LL</FONT><FONT CLASS=T19>A</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S7>C</FONT> 
  5 CEC55C3    31.5%  <FONT CLASS=T19>VELT</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T19>K</FONT><FONT CLASS=S14>LG</FONT><FONT CLASS=T19>E</FONT><FONT CLASS=S14>GA</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>E</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=T19>W</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>KLLKILDA</FONT><FONT COLOR="#666666">-------</FONT><FONT CLASS=T19>NHQPVL</FONT><FONT CLASS=S14>VA</FONT><FONT CLASS=T19>V</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T19>TAKLESMT</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T19>EQI</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=T19>MR</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=T19>RL</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=T19>RNL</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=T19>HIN</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=T19>VKFF</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>VA</FONT> 
  </PRE>

or with respect to another row (let's use row 4)::

  mview ... -coloring identity -ref 4 ...

giving:

.. raw:: html

  <PRE>
  1 EGFR       21.2%  <FONT CLASS=T19>FKKI</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T19>VL</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>S</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>A</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>T</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=T19>YKGLWIPEGEK</FONT><FONT COLOR="#666666">---------</FONT><FONT CLASS=T19>VKIP</FONT><FONT CLASS=S14>VA</FONT><FONT CLASS=T19>I</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T19>E</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=T19>REAT</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=T19>PK</FONT><FONT COLOR="#666666">-</FONT><FONT CLASS=T19>ANKEILD</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=T19>AYV</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=T19>ASVDNPHVCR</FONT><FONT CLASS=S14>LL</FONT><FONT CLASS=T19>G</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S7>C</FONT> 
  2 DMDPR2     25.0%  <FONT CLASS=S14>I</FONT><FONT CLASS=T19>SVN</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=T19>L</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>T</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>E</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>I</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=T19>QQGVWSNGNE</FONT><FONT COLOR="#666666">-----------</FONT><FONT CLASS=T19>RIQ</FONT><FONT CLASS=S14>VA</FONT><FONT CLASS=T19>I</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T19>C</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=T19>CRERMQS</FONT><FONT COLOR="#666666">-</FONT><FONT CLASS=T19>NPME</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=T19>L</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=T19>AAI</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=T19>HSIE</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=T19>EN</FONT><FONT CLASS=S14>IV</FONT><FONT CLASS=T19>R</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=T19>YGVV</FONT> 
  3 ITK_HUMAN  26.9%  <FONT CLASS=T19>LTF</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=T19>QE</FONT><FONT CLASS=S14>IG</FONT><FONT CLASS=T19>S</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>L</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=T19>H</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=T19>GYWLN</FONT><FONT COLOR="#666666">--------------</FONT><FONT CLASS=T19>KDK</FONT><FONT CLASS=S14>VA</FONT><FONT CLASS=T19>I</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T19>TIREGAMS</FONT><FONT COLOR="#666666">---</FONT><FONT CLASS=T19>EED</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=T19>IE</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=T19>AEV</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=T19>MK</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=T19>S</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=T19>PKL</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=T19>YGV</FONT><FONT CLASS=S7>C</FONT> 
  4 GCTK2ID   100.0%  <FONT CLASS=S14>I</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>IGVG</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>GAVVLA</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S14>GL</FONT><FONT CLASS=S9>S</FONT><FONT COLOR="#666666">-</FONT><FONT CLASS=T19>X</FONT><FONT CLASS=S14>LP</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S14>GVALVAV</FONT><FONT CLASS=S17>KK</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>P</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S12>D</FONT><FONT COLOR="#666666">-</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>VL</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>IV</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>LLAI</FONT><FONT CLASS=S7>C</FONT> 
  5 CEC55C3    22.5%  <FONT CLASS=T19>VELT</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T19>KL</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>E</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>A</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T19>E</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=T19>WKGKLLKILDA</FONT><FONT COLOR="#666666">-------</FONT><FONT CLASS=T19>NHQPV</FONT><FONT CLASS=S14>LVAV</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T19>TA</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T19>LESMTK</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=T19>QIKEIMR</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=T19>ARL</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=T19>RN</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=T19>D</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=T19>INV</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=T19>KFFGVA</FONT> 
  </PRE>

in which also you see that the percent identity calculations have been
recomputed with respect to the new row of interest.


**Mode** ``consensus``

This mode uses the currently selected alignment palette to colour only those
residues assigned to a consensus class for each column (see
:ref:`ref_consensus_sequences`). The consensus threshold defaults to 70% and
and may be set to another value with the ``-threshold`` option. In the
following example we add a single consensus line and set the same threshold
for both consensus calculations (they are independent) to 90%::

  mview ... -coloring consensus -threshold 90 ... -consensus on -con_threshold 90 ...

gives:

.. raw:: html

  <PRE>
  1 EGFR          100.0%  <FONT CLASS=S13>F</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">KI</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">V</FONT><FONT CLASS=S14>LG</FONT><FONT COLOR="#666666">S</FONT><FONT CLASS=S14>GA</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">T</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">YK</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">L</FONT><FONT CLASS=S13>W</FONT><FONT COLOR="#666666">IPEGEK---------VKIP</FONT><FONT CLASS=S14>VAI</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S17>R</FONT><FONT COLOR="#666666">E</FONT><FONT CLASS=S14>A</FONT><FONT COLOR="#666666">TSPK-ANK</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>I</FONT><FONT COLOR="#666666">L</FONT><FONT CLASS=S12>DE</FONT><FONT CLASS=S14>A</FONT><FONT COLOR="#666666">Y</FONT><FONT CLASS=S14>VM</FONT><FONT COLOR="#666666">A</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S8>N</FONT><FONT COLOR="#666666">P</FONT><FONT CLASS=S13>H</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=S7>C</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S14>LLGI</FONT><FONT CLASS=S7>C</FONT> 
  2 DMDPR2         35.7%  <FONT CLASS=S14>I</FONT><FONT CLASS=S9>S</FONT><FONT COLOR="#666666">VN</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">Q</FONT><FONT CLASS=S14>LG</FONT><FONT COLOR="#666666">T</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">I</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">QQ</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">V</FONT><FONT CLASS=S13>W</FONT><FONT COLOR="#666666">SNGNE-----------RIQ</FONT><FONT CLASS=S14>VAI</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S7>C</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S7>C</FONT><FONT COLOR="#666666">R</FONT><FONT CLASS=S12>E</FONT><FONT COLOR="#666666">RMQS-NPM</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S13>F</FONT><FONT COLOR="#666666">L</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>A</FONT><FONT COLOR="#666666">A</FONT><FONT CLASS=S14>IM</FONT><FONT COLOR="#666666">H</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S13>H</FONT><FONT COLOR="#666666">E</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S14>IV</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S13>Y</FONT><FONT CLASS=S14>GVV</FONT> 
  3 ITK_HUMAN      32.9%  <FONT CLASS=S14>L</FONT><FONT CLASS=S9>T</FONT><FONT COLOR="#666666">FV</FONT><FONT CLASS=S8>Q</FONT><FONT COLOR="#666666">E</FONT><FONT CLASS=S14>IG</FONT><FONT COLOR="#666666">S</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">L</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">HL</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">Y</FONT><FONT CLASS=S13>W</FONT><FONT COLOR="#666666">LN--------------KDK</FONT><FONT CLASS=S14>VAI</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S14>I</FONT><FONT CLASS=S17>R</FONT><FONT COLOR="#666666">E</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">AMS---EE</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S13>F</FONT><FONT COLOR="#666666">I</FONT><FONT CLASS=S12>EE</FONT><FONT CLASS=S14>A</FONT><FONT COLOR="#666666">E</FONT><FONT CLASS=S14>VM</FONT><FONT COLOR="#666666">M</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S13>H</FONT><FONT COLOR="#666666">P</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S14>LV</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S13>Y</FONT><FONT CLASS=S14>GV</FONT><FONT CLASS=S7>C</FONT> 
  4 GCTK2ID        21.2%  <FONT CLASS=S14>I</FONT><FONT CLASS=S17>R</FONT><FONT COLOR="#666666">EV</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">Q</FONT><FONT CLASS=S14>IG</FONT><FONT COLOR="#666666">V</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">A</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">VL</FONT><FONT CLASS=S14>A</FONT><FONT COLOR="#666666">E</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#666666">TGLS-XLPKGSMNADGVAL</FONT><FONT CLASS=S14>VAV</FONT><FONT CLASS=S17>KK</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">P</FONT><FONT CLASS=S12>D</FONT><FONT COLOR="#666666">VSD-EVLQ</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S13>F</FONT><FONT COLOR="#666666">D</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>I</FONT><FONT COLOR="#666666">K</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#666666">S</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S13>H</FONT><FONT COLOR="#666666">D</FONT><FONT CLASS=S9>S</FONT><FONT CLASS=S14>IV</FONT><FONT CLASS=S8>Q</FONT><FONT CLASS=S14>LLAI</FONT><FONT CLASS=S7>C</FONT> 
  5 CEC55C3        31.5%  <FONT CLASS=S14>V</FONT><FONT CLASS=S12>E</FONT><FONT COLOR="#666666">LT</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">K</FONT><FONT CLASS=S14>LG</FONT><FONT COLOR="#666666">E</FONT><FONT CLASS=S14>GA</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">E</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">WK</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">K</FONT><FONT CLASS=S14>L</FONT><FONT COLOR="#666666">LKILDA-------NHQPVL</FONT><FONT CLASS=S14>VAV</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S9>T</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">L</FONT><FONT CLASS=S12>E</FONT><FONT COLOR="#666666">SMTKEQIK</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>I</FONT><FONT COLOR="#666666">M</FONT><FONT CLASS=S17>R</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>A</FONT><FONT COLOR="#666666">R</FONT><FONT CLASS=S14>LM</FONT><FONT COLOR="#666666">R</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=S12>D</FONT><FONT CLASS=S13>H</FONT><FONT COLOR="#666666">I</FONT><FONT CLASS=S8>N</FONT><FONT CLASS=S14>VV</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=S13>FF</FONT><FONT CLASS=S14>GVA</FONT> 
    consensus/90%         hp..p.lG.GtFG.V..u.h...................VAlKphp.t........ph.cEh.hM.plpp.plsphhuls 
  </PRE>

Notice that the coloured columns correspond to the consensus features (i.e.,
not wildcards or gaps). In each column, the residues that contribute to that
consensus class have been coloured using the prevailing alignment colouring
palette (see :ref:`ref_alignment_colouring`), which is the default one used in
the other examples in this section.


**Mode** ``group``

The last mode works like the consensus colouring mode, but gives the residues
in a column a uniform colour defined for that consensus class (see
:ref:`ref_consensus_colouring`)::

  mview ... -coloring group -threshold 90 ... -consensus on -con_threshold 90 ...

yields:

.. raw:: html

  <PRE>
  1 EGFR          100.0%  <FONT CLASS=T14>F</FONT><FONT CLASS=T9>K</FONT><FONT COLOR="#666666">KI</FONT><FONT CLASS=T9>K</FONT><FONT COLOR="#666666">V</FONT><FONT CLASS=T14>L</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">S</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T14>A</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">T</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">YK</FONT><FONT CLASS=T14>G</FONT><FONT COLOR="#666666">L</FONT><FONT CLASS=T14>W</FONT><FONT COLOR="#666666">IPEGEK---------VKIP</FONT><FONT CLASS=S14>VA</FONT><FONT CLASS=T14>I</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T9>E</FONT><FONT CLASS=T14>L</FONT><FONT CLASS=T9>R</FONT><FONT COLOR="#666666">E</FONT><FONT CLASS=T14>A</FONT><FONT COLOR="#666666">TSPK-ANK</FONT><FONT CLASS=T9>E</FONT><FONT CLASS=T14>I</FONT><FONT COLOR="#666666">L</FONT><FONT CLASS=T8>D</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=T14>A</FONT><FONT COLOR="#666666">Y</FONT><FONT CLASS=T14>V</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#666666">A</FONT><FONT CLASS=T9>S</FONT><FONT CLASS=T14>V</FONT><FONT CLASS=T9>DN</FONT><FONT COLOR="#666666">P</FONT><FONT CLASS=T9>H</FONT><FONT CLASS=T14>VC</FONT><FONT CLASS=T9>R</FONT><FONT CLASS=T14>LLGIC</FONT> 
  2 DMDPR2         35.7%  <FONT CLASS=T14>I</FONT><FONT CLASS=T9>S</FONT><FONT COLOR="#666666">VN</FONT><FONT CLASS=T9>K</FONT><FONT COLOR="#666666">Q</FONT><FONT CLASS=T14>L</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">T</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T14>E</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">I</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">QQ</FONT><FONT CLASS=T14>G</FONT><FONT COLOR="#666666">V</FONT><FONT CLASS=T14>W</FONT><FONT COLOR="#666666">SNGNE-----------RIQ</FONT><FONT CLASS=S14>VA</FONT><FONT CLASS=T14>I</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T9>C</FONT><FONT CLASS=T14>L</FONT><FONT CLASS=T9>C</FONT><FONT COLOR="#666666">R</FONT><FONT CLASS=T14>E</FONT><FONT COLOR="#666666">RMQS-NPM</FONT><FONT CLASS=T9>E</FONT><FONT CLASS=T14>F</FONT><FONT COLOR="#666666">L</FONT><FONT CLASS=T8>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=T14>A</FONT><FONT COLOR="#666666">A</FONT><FONT CLASS=T14>I</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#666666">H</FONT><FONT CLASS=T9>S</FONT><FONT CLASS=T14>I</FONT><FONT CLASS=T9>EH</FONT><FONT COLOR="#666666">E</FONT><FONT CLASS=T9>N</FONT><FONT CLASS=T14>IV</FONT><FONT CLASS=T9>R</FONT><FONT CLASS=T14>LYGVV</FONT> 
  3 ITK_HUMAN      32.9%  <FONT CLASS=T14>L</FONT><FONT CLASS=T9>T</FONT><FONT COLOR="#666666">FV</FONT><FONT CLASS=T9>Q</FONT><FONT COLOR="#666666">E</FONT><FONT CLASS=T14>I</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">S</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T14>Q</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">L</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">HL</FONT><FONT CLASS=T14>G</FONT><FONT COLOR="#666666">Y</FONT><FONT CLASS=T14>W</FONT><FONT COLOR="#666666">LN--------------KDK</FONT><FONT CLASS=S14>VA</FONT><FONT CLASS=T14>I</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T9>T</FONT><FONT CLASS=T14>I</FONT><FONT CLASS=T9>R</FONT><FONT COLOR="#666666">E</FONT><FONT CLASS=T14>G</FONT><FONT COLOR="#666666">AMS---EE</FONT><FONT CLASS=T9>D</FONT><FONT CLASS=T14>F</FONT><FONT COLOR="#666666">I</FONT><FONT CLASS=T8>E</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=T14>A</FONT><FONT COLOR="#666666">E</FONT><FONT CLASS=T14>V</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#666666">M</FONT><FONT CLASS=T9>K</FONT><FONT CLASS=T14>L</FONT><FONT CLASS=T9>SH</FONT><FONT COLOR="#666666">P</FONT><FONT CLASS=T9>K</FONT><FONT CLASS=T14>LV</FONT><FONT CLASS=T9>Q</FONT><FONT CLASS=T14>LYGVC</FONT> 
  4 GCTK2ID        21.2%  <FONT CLASS=T14>I</FONT><FONT CLASS=T9>R</FONT><FONT COLOR="#666666">EV</FONT><FONT CLASS=T9>K</FONT><FONT COLOR="#666666">Q</FONT><FONT CLASS=T14>I</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">V</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T14>Q</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">A</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">VL</FONT><FONT CLASS=T14>A</FONT><FONT COLOR="#666666">E</FONT><FONT CLASS=T14>M</FONT><FONT COLOR="#666666">TGLS-XLPKGSMNADGVAL</FONT><FONT CLASS=S14>VA</FONT><FONT CLASS=T14>V</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T9>K</FONT><FONT CLASS=T14>L</FONT><FONT CLASS=T9>K</FONT><FONT COLOR="#666666">P</FONT><FONT CLASS=T14>D</FONT><FONT COLOR="#666666">VSD-EVLQ</FONT><FONT CLASS=T9>S</FONT><FONT CLASS=T14>F</FONT><FONT COLOR="#666666">D</FONT><FONT CLASS=T8>K</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=T14>I</FONT><FONT COLOR="#666666">K</FONT><FONT CLASS=T14>F</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#666666">S</FONT><FONT CLASS=T9>Q</FONT><FONT CLASS=T14>L</FONT><FONT CLASS=T9>QH</FONT><FONT COLOR="#666666">D</FONT><FONT CLASS=T9>S</FONT><FONT CLASS=T14>IV</FONT><FONT CLASS=T9>Q</FONT><FONT CLASS=T14>LLAIC</FONT> 
  5 CEC55C3        31.5%  <FONT CLASS=T14>V</FONT><FONT CLASS=T9>E</FONT><FONT COLOR="#666666">LT</FONT><FONT CLASS=T9>K</FONT><FONT COLOR="#666666">K</FONT><FONT CLASS=T14>L</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">E</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T14>A</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">E</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">WK</FONT><FONT CLASS=T14>G</FONT><FONT COLOR="#666666">K</FONT><FONT CLASS=T14>L</FONT><FONT COLOR="#666666">LKILDA-------NHQPVL</FONT><FONT CLASS=S14>VA</FONT><FONT CLASS=T14>V</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T9>T</FONT><FONT CLASS=T14>A</FONT><FONT CLASS=T9>K</FONT><FONT COLOR="#666666">L</FONT><FONT CLASS=T14>E</FONT><FONT COLOR="#666666">SMTKEQIK</FONT><FONT CLASS=T9>E</FONT><FONT CLASS=T14>I</FONT><FONT COLOR="#666666">M</FONT><FONT CLASS=T8>R</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=T14>A</FONT><FONT COLOR="#666666">R</FONT><FONT CLASS=T14>L</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#666666">R</FONT><FONT CLASS=T9>N</FONT><FONT CLASS=T14>L</FONT><FONT CLASS=T9>DH</FONT><FONT COLOR="#666666">I</FONT><FONT CLASS=T9>N</FONT><FONT CLASS=T14>VV</FONT><FONT CLASS=T9>K</FONT><FONT CLASS=T14>FFGVA</FONT> 
    consensus/90%         hp..p.lG.GtFG.V..u.h...................VAlKphp.t........ph.cEh.hM.plpp.plsphhuls 
  </PRE>

As in the last example, the coloured columns correspond to the consensus
features (i.e., not wildcards or gaps). In each column, the residues that
contribute to that consensus class have been coloured using a single colour
defined for that consensus class (see :ref:`ref_consensus_colouring`), and
conserved residues (at least 90% of a column) are given a solid coloured
background for emphasis.

The choice of consensus classes may be changed using the ``-groupmap name``
option, where ``name`` is the name of a consensus pattern. These can be listed
using the ``-listgroups`` option (see :ref:`ref_changeing_consensus_patterns`).

Note: it is also possible to colour the consensus sequences themselves
independently of the alignment (see :ref:`ref_consensus_colouring`).


Colouring only conserved residues
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

The colouring of an alignment under the ``consensus`` or ``group`` colouring
modes (see :ref:`ref_alignment_colouring`) can be tuned to ignore the
consensus classes with ``-ignore class`` for the purposes of colouring::

  mview ... -coloring group -threshold 90 ... -consensus on -con_threshold 90 ... -ignore class

gives:

.. raw:: html

  <PRE>
  1 EGFR          100.0%  <FONT COLOR="#666666">FKKIKVL</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">S</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">A</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">T</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">YKGLWIPEGEK---------VKIP</FONT><FONT CLASS=S14>VA</FONT><FONT COLOR="#666666">I</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">ELREATSPK-ANKEILD</FONT><FONT CLASS=S12>E</FONT><FONT COLOR="#666666">AYV</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#666666">ASVDNPHVCRLLGIC</FONT> 
  2 DMDPR2         35.7%  <FONT COLOR="#666666">ISVNKQL</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">T</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">E</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">I</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">QQGVWSNGNE-----------RIQ</FONT><FONT CLASS=S14>VA</FONT><FONT COLOR="#666666">I</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">CLCRERMQS-NPMEFLK</FONT><FONT CLASS=S12>E</FONT><FONT COLOR="#666666">AAI</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#666666">HSIEHENIVRLYGVV</FONT> 
  3 ITK_HUMAN      32.9%  <FONT COLOR="#666666">LTFVQEI</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">S</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">Q</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">L</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">HLGYWLN--------------KDK</FONT><FONT CLASS=S14>VA</FONT><FONT COLOR="#666666">I</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">TIREGAMS---EEDFIE</FONT><FONT CLASS=S12>E</FONT><FONT COLOR="#666666">AEV</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#666666">MKLSHPKLVQLYGVC</FONT> 
  4 GCTK2ID        21.2%  <FONT COLOR="#666666">IREVKQI</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">V</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">Q</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">A</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">VLAEMTGLS-XLPKGSMNADGVAL</FONT><FONT CLASS=S14>VA</FONT><FONT COLOR="#666666">V</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">KLKPDVSD-EVLQSFDK</FONT><FONT CLASS=S12>E</FONT><FONT COLOR="#666666">IKF</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#666666">SQLQHDSIVQLLAIC</FONT> 
  5 CEC55C3        31.5%  <FONT COLOR="#666666">VELTKKL</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">E</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">A</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">E</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">WKGKLLKILDA-------NHQPVL</FONT><FONT CLASS=S14>VA</FONT><FONT COLOR="#666666">V</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">TAKLESMTKEQIKEIMR</FONT><FONT CLASS=S12>E</FONT><FONT COLOR="#666666">ARL</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#666666">RNLDHINVVKFFGVA</FONT> 
    consensus/90%         hp..p.lG.GtFG.V..u.h...................VAlKphp.t........ph.cEh.hM.plpp.plsphhuls 
  </PRE>

which highlights the conserved residues (at least 90% of a column) in the
alignment by applying the default consensus group colouring scheme to them.


.. _ref_consensus_colouring:

Consensus colouring
^^^^^^^^^^^^^^^^^^^

The consensus lines may be coloured independently of the alignment using the
``-con_coloring`` option which takes two modes: ``any``, ``identity``.

Consider the following alignment:

.. raw:: html

  <PRE>
                          1 [        .         .         .         .         :         .         .         ] 80
  1 EGFR          100.0%    FKKIKVLGSGAFGTVYKGLWIPEGEK---------VKIPVAIKELREATSPK-ANKEILDEAYVMASVDNPHVCRLLGIC   
  2 DMDPR2         35.7%    ISVNKQLGTGEFGIVQQGVWSNGNE-----------RIQVAIKCLCRERMQS-NPMEFLKEAAIMHSIEHENIVRLYGVV   
  3 ITK_HUMAN      32.9%    LTFVQEIGSGQFGLVHLGYWLN--------------KDKVAIKTIREGAMS---EEDFIEEAEVMMKLSHPKLVQLYGVC   
  4 GCTK2ID        21.2%    IREVKQIGVGQFGAVVLAEMTGLS-XLPKGSMNADGVALVAVKKLKPDVSD-EVLQSFDKEIKFMSQLQHDSIVQLLAIC   
  5 CEC55C3        31.5%    VELTKKLGEGAFGEVWKGKLLKILDA-------NHQPVLVAVKTAKLESMTKEQIKEIMREARLMRNLDHINVVKFFGVA   
  </PRE>


**Mode** ``any``

The simplest is to colour every consensus symbol according to the currently
selected consensus colouring palette::

  mview ... -consensus on -con_coloring any ...

gives:

.. raw:: html

  <PRE>
    consensus/100%         <FONT CLASS=T14>h</FONT><FONT CLASS=T9>p</FONT><FONT COLOR="#666666">..</FONT><FONT CLASS=T9>p</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=T14>l</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T14>t</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">..</FONT><FONT CLASS=T14>u</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=T14>h</FONT><FONT COLOR="#666666">...................</FONT><FONT CLASS=S14>VA</FONT><FONT CLASS=T14>l</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T14>h</FONT><FONT CLASS=T9>p</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=T14>t</FONT><FONT COLOR="#666666">........</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T14>h</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=T8>c</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=T14>h</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=T14>h</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T14>l</FONT><FONT CLASS=T9>pp</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T14>ls</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T14>hhuls</FONT>   
    consensus/90%          <FONT CLASS=T14>h</FONT><FONT CLASS=T9>p</FONT><FONT COLOR="#666666">..</FONT><FONT CLASS=T9>p</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=T14>l</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T14>t</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">..</FONT><FONT CLASS=T14>u</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=T14>h</FONT><FONT COLOR="#666666">...................</FONT><FONT CLASS=S14>VA</FONT><FONT CLASS=T14>l</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T14>h</FONT><FONT CLASS=T9>p</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=T14>t</FONT><FONT COLOR="#666666">........</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T14>h</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=T8>c</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=T14>h</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=T14>h</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T14>l</FONT><FONT CLASS=T9>pp</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T14>ls</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T14>hhuls</FONT>   
    consensus/80%          <FONT CLASS=T14>l</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T14>hs</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T14>l</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T14>s</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T14>t</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T14>h</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=T14>hh</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T14>hhhs</FONT><FONT COLOR="#666666">..............</FONT><FONT CLASS=T14>hh</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>VA</FONT><FONT CLASS=T14>l</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T14>l</FONT><FONT CLASS=T17>+</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=T14>ts</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=T14>s</FONT><FONT COLOR="#666666">....</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T12>-</FONT><FONT CLASS=T14>hh</FONT><FONT CLASS=T8>c</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=T14>tl</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=T14>t</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T14>l</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=S13>H</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T14>l</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=T14>h</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T14>ls</FONT>   
    consensus/70%          <FONT CLASS=T14>l</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T14>hs</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T14>l</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T14>s</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T14>t</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T14>h</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=T14>hh</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T14>hhhs</FONT><FONT COLOR="#666666">..............</FONT><FONT CLASS=T14>hh</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>VA</FONT><FONT CLASS=T14>l</FONT><FONT CLASS=S17>K</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T14>l</FONT><FONT CLASS=T17>+</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=T14>ts</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=T14>s</FONT><FONT COLOR="#666666">....</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T12>-</FONT><FONT CLASS=T14>hh</FONT><FONT CLASS=T8>c</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>A</FONT><FONT CLASS=T14>tl</FONT><FONT CLASS=S14>M</FONT><FONT CLASS=T14>t</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T14>l</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=S13>H</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=T14>l</FONT><FONT CLASS=S14>V</FONT><FONT CLASS=T9>p</FONT><FONT CLASS=S14>L</FONT><FONT CLASS=T14>h</FONT><FONT CLASS=S14>G</FONT><FONT CLASS=T14>ls</FONT>   
  </PRE>


**Mode** ``identity``

You can colour only those consensus symbols that are identical to some
reference sequence (usually the query or first row) with::

  mview ... -consensus on -con_coloring identity ...

to produce:

.. raw:: html

  <PRE>
    consensus/100%         <FONT COLOR="#000000">hp</FONT><FONT COLOR="#666666">..</FONT><FONT COLOR="#000000">p</FONT><FONT COLOR="#666666">.</FONT><FONT COLOR="#000000">l</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#000000">t</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">..</FONT><FONT COLOR="#000000">u</FONT><FONT COLOR="#666666">.</FONT><FONT COLOR="#000000">h</FONT><FONT COLOR="#666666">...................</FONT><FONT CLASS=S14>VA</FONT><FONT COLOR="#000000">l</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#000000">php</FONT><FONT COLOR="#666666">.</FONT><FONT COLOR="#000000">t</FONT><FONT COLOR="#666666">........</FONT><FONT COLOR="#000000">ph</FONT><FONT COLOR="#666666">.</FONT><FONT COLOR="#000000">c</FONT><FONT CLASS=S12>E</FONT><FONT COLOR="#000000">h</FONT><FONT COLOR="#666666">.</FONT><FONT COLOR="#000000">h</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#666666">.</FONT><FONT COLOR="#000000">plpp</FONT><FONT COLOR="#666666">.</FONT><FONT COLOR="#000000">plsphhuls</FONT>   
    consensus/90%          <FONT COLOR="#000000">hp</FONT><FONT COLOR="#666666">..</FONT><FONT COLOR="#000000">p</FONT><FONT COLOR="#666666">.</FONT><FONT COLOR="#000000">l</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#000000">t</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">..</FONT><FONT COLOR="#000000">u</FONT><FONT COLOR="#666666">.</FONT><FONT COLOR="#000000">h</FONT><FONT COLOR="#666666">...................</FONT><FONT CLASS=S14>VA</FONT><FONT COLOR="#000000">l</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#000000">php</FONT><FONT COLOR="#666666">.</FONT><FONT COLOR="#000000">t</FONT><FONT COLOR="#666666">........</FONT><FONT COLOR="#000000">ph</FONT><FONT COLOR="#666666">.</FONT><FONT COLOR="#000000">c</FONT><FONT CLASS=S12>E</FONT><FONT COLOR="#000000">h</FONT><FONT COLOR="#666666">.</FONT><FONT COLOR="#000000">h</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#666666">.</FONT><FONT COLOR="#000000">plpp</FONT><FONT COLOR="#666666">.</FONT><FONT COLOR="#000000">plsphhuls</FONT>   
    consensus/80%          <FONT COLOR="#000000">lphs</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#000000">pl</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#000000">s</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#000000">t</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#000000">h</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#000000">hh</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#000000">hhhs</FONT><FONT COLOR="#666666">..............</FONT><FONT COLOR="#000000">hh</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>VA</FONT><FONT COLOR="#000000">l</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#000000">pl+</FONT><FONT COLOR="#666666">.</FONT><FONT COLOR="#000000">ts</FONT><FONT COLOR="#666666">.</FONT><FONT COLOR="#000000">s</FONT><FONT COLOR="#666666">....</FONT><FONT COLOR="#000000">p-hhc</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>A</FONT><FONT COLOR="#000000">tl</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#000000">tplp</FONT><FONT CLASS=S13>H</FONT><FONT COLOR="#666666">.</FONT><FONT COLOR="#000000">pl</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#000000">p</FONT><FONT CLASS=S14>L</FONT><FONT COLOR="#000000">h</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#000000">ls</FONT>   
    consensus/70%          <FONT COLOR="#000000">lphs</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#000000">pl</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#000000">s</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#000000">t</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#000000">h</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#000000">hh</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#000000">hhhs</FONT><FONT COLOR="#666666">..............</FONT><FONT COLOR="#000000">hh</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>VA</FONT><FONT COLOR="#000000">l</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#000000">pl+</FONT><FONT COLOR="#666666">.</FONT><FONT COLOR="#000000">ts</FONT><FONT COLOR="#666666">.</FONT><FONT COLOR="#000000">s</FONT><FONT COLOR="#666666">....</FONT><FONT COLOR="#000000">p-hhc</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>A</FONT><FONT COLOR="#000000">tl</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#000000">tplp</FONT><FONT CLASS=S13>H</FONT><FONT COLOR="#666666">.</FONT><FONT COLOR="#000000">pl</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#000000">p</FONT><FONT CLASS=S14>L</FONT><FONT COLOR="#000000">h</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#000000">ls</FONT>   
  </PRE>


**Tuning**

These modes work with the ``-con_ignore`` and ``-con_gaps`` options to tune
the consensus symbols displayed (see :ref:`ref_conserved_symbols or conserved
classes`). For example, the consensus symbols can be switched off, to leave
only conserved residues::

  mview ... -consensus on -con_coloring identity -con_ignore class ...

to produce:

.. raw:: html

  <PRE>
    consensus/100%         <FONT COLOR="#666666">.......</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">........................</FONT><FONT CLASS=S14>VA</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">.................</FONT><FONT CLASS=S12>E</FONT><FONT COLOR="#666666">...</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#666666">...............</FONT>   
    consensus/90%          <FONT COLOR="#666666">.......</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">........................</FONT><FONT CLASS=S14>VA</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">.................</FONT><FONT CLASS=S12>E</FONT><FONT COLOR="#666666">...</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#666666">...............</FONT>   
    consensus/80%          <FONT COLOR="#666666">....</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">..</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">..</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.....................</FONT><FONT CLASS=S14>VA</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">.................</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>A</FONT><FONT COLOR="#666666">..</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#666666">....</FONT><FONT CLASS=S13>H</FONT><FONT COLOR="#666666">...</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>L</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">..</FONT>   
    consensus/70%          <FONT COLOR="#666666">....</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">..</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S13>F</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">..</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">.....................</FONT><FONT CLASS=S14>VA</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S17>K</FONT><FONT COLOR="#666666">.................</FONT><FONT CLASS=S12>E</FONT><FONT CLASS=S14>A</FONT><FONT COLOR="#666666">..</FONT><FONT CLASS=S14>M</FONT><FONT COLOR="#666666">....</FONT><FONT CLASS=S13>H</FONT><FONT COLOR="#666666">...</FONT><FONT CLASS=S14>V</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>L</FONT><FONT COLOR="#666666">.</FONT><FONT CLASS=S14>G</FONT><FONT COLOR="#666666">..</FONT>   
  </PRE>


Finding and colouring patterns and motifs
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Occurrences of a string or pattern defined by a regular expression can be
coloured using the ``-find 'pattern'`` option. This will cause all instances
of the pattern to be highlighted using the user selected colourmap. Patterns
are case-insensitive.

\1. Patterns may be exact strings::

  mview ... -html head -css on -find VAIK

.. raw:: html

  <PRE>
  1 EGFR      100.0%  <FONT COLOR="#666666">FKKIKVLGSGAFGTVYKGLWIPEGEK---------VKIP</FONT><FONT CLASS=S93>VAIK</FONT><FONT COLOR="#666666">ELREATSPK-ANKEILDEAYVMASVDNPHVCRLLGIC</FONT> 
  2 DMDPR2     35.7%  <FONT COLOR="#666666">ISVNKQLGTGEFGIVQQGVWSNGNE-----------RIQ</FONT><FONT CLASS=S93>VAIK</FONT><FONT COLOR="#666666">CLCRERMQS-NPMEFLKEAAIMHSIEHENIVRLYGVV</FONT> 
  3 ITK_HUMAN  32.9%  <FONT COLOR="#666666">LTFVQEIGSGQFGLVHLGYWLN--------------KDK</FONT><FONT CLASS=S93>VAIK</FONT><FONT COLOR="#666666">TIREGAMS---EEDFIEEAEVMMKLSHPKLVQLYGVC</FONT> 
  4 GCTK2ID    21.2%  <FONT COLOR="#666666">IREVKQIGVGQFGAVVLAEMTGLS-XLPKGSMNADGVALVAVKKLKPDVSD-EVLQSFDKEIKFMSQLQHDSIVQLLAIC</FONT> 
  5 CEC55C3    31.5%  <FONT COLOR="#666666">VELTKKLGEGAFGEVWKGKLLKILDA-------NHQPVLVAVKTAKLESMTKEQIKEIMREARLMRNLDHINVVKFFGVA</FONT> 
  </PRE>

\2. Patterns may be regular expressions enclosed in quotes::

   mview ... -find 'VA[IV]K'

.. raw:: html

  <PRE>
  1 EGFR      100.0%  <FONT COLOR="#666666">FKKIKVLGSGAFGTVYKGLWIPEGEK---------VKIP</FONT><FONT CLASS=S93>VAIK</FONT><FONT COLOR="#666666">ELREATSPK-ANKEILDEAYVMASVDNPHVCRLLGIC</FONT> 
  2 DMDPR2     35.7%  <FONT COLOR="#666666">ISVNKQLGTGEFGIVQQGVWSNGNE-----------RIQ</FONT><FONT CLASS=S93>VAIK</FONT><FONT COLOR="#666666">CLCRERMQS-NPMEFLKEAAIMHSIEHENIVRLYGVV</FONT> 
  3 ITK_HUMAN  32.9%  <FONT COLOR="#666666">LTFVQEIGSGQFGLVHLGYWLN--------------KDK</FONT><FONT CLASS=S93>VAIK</FONT><FONT COLOR="#666666">TIREGAMS---EEDFIEEAEVMMKLSHPKLVQLYGVC</FONT> 
  4 GCTK2ID    21.2%  <FONT COLOR="#666666">IREVKQIGVGQFGAVVLAEMTGLS-XLPKGSMNADGVAL</FONT><FONT CLASS=S93>VAVK</FONT><FONT COLOR="#666666">KLKPDVSD-EVLQSFDKEIKFMSQLQHDSIVQLLAIC</FONT> 
  5 CEC55C3    31.5%  <FONT COLOR="#666666">VELTKKLGEGAFGEVWKGKLLKILDA-------NHQPVL</FONT><FONT CLASS=S93>VAVK</FONT><FONT COLOR="#666666">TAKLESMTKEQIKEIMREARLMRNLDHINVVKFFGVA</FONT> 
  </PRE>

\3. Patterns are unaffected by gaps in the sequence::

  mview ... -find '.{4}VA[IV]K'

.. raw:: html

  <PRE>
  1 EGFR      100.0%  <FONT COLOR="#666666">FKKIKVLGSGAFGTVYKGLWIPEGEK---------</FONT><FONT CLASS=S93>VKIPVAIK</FONT><FONT COLOR="#666666">ELREATSPK-ANKEILDEAYVMASVDNPHVCRLLGIC</FONT> 
  2 DMDPR2     35.7%  <FONT COLOR="#666666">ISVNKQLGTGEFGIVQQGVWSNGN</FONT><FONT CLASS=S93>E</FONT><FONT COLOR="#666666">-----------</FONT><FONT CLASS=S93>RIQVAIK</FONT><FONT COLOR="#666666">CLCRERMQS-NPMEFLKEAAIMHSIEHENIVRLYGVV</FONT> 
  3 ITK_HUMAN  32.9%  <FONT COLOR="#666666">LTFVQEIGSGQFGLVHLGYWL</FONT><FONT CLASS=S93>N</FONT><FONT COLOR="#666666">--------------</FONT><FONT CLASS=S93>KDKVAIK</FONT><FONT COLOR="#666666">TIREGAMS---EEDFIEEAEVMMKLSHPKLVQLYGVC</FONT> 
  4 GCTK2ID    21.2%  <FONT COLOR="#666666">IREVKQIGVGQFGAVVLAEMTGLS-XLPKGSMNAD</FONT><FONT CLASS=S93>GVALVAVK</FONT><FONT COLOR="#666666">KLKPDVSD-EVLQSFDKEIKFMSQLQHDSIVQLLAIC</FONT> 
  5 CEC55C3    31.5%  <FONT COLOR="#666666">VELTKKLGEGAFGEVWKGKLLKILDA-------NH</FONT><FONT CLASS=S93>QPVLVAVK</FONT><FONT COLOR="#666666">TAKLESMTKEQIKEIMREARLMRNLDHINVVKFFGVA</FONT> 
  </PRE>

where you can see that the pattern (any 4 residues followed by V A [I or V] K)
has been found even though it spans a gap in two rows.

\4. Patterns will find all possible matches including overlapping matches::

   mview ... -find '.V.'

.. raw:: html

  <PRE>
  1 EGFR      100.0%  <FONT COLOR="#666666">FKKI</FONT><FONT CLASS=S93>KVL</FONT><FONT COLOR="#666666">GSGAFG</FONT><FONT CLASS=S93>TVY</FONT><FONT COLOR="#666666">KGLWIPEGE</FONT><FONT CLASS=S93>K</FONT><FONT COLOR="#666666">---------</FONT><FONT CLASS=S93>VK</FONT><FONT COLOR="#666666">I</FONT><FONT CLASS=S93>PVA</FONT><FONT COLOR="#666666">IKELREATSPK-ANKEILDEA</FONT><FONT CLASS=S93>YVM</FONT><FONT COLOR="#666666">A</FONT><FONT CLASS=S93>SVD</FONT><FONT COLOR="#666666">NP</FONT><FONT CLASS=S93>HVC</FONT><FONT COLOR="#666666">RLLGIC</FONT> 
  2 DMDPR2     35.7%  <FONT COLOR="#666666">I</FONT><FONT CLASS=S93>SVN</FONT><FONT COLOR="#666666">KQLGTGEFG</FONT><FONT CLASS=S93>IVQ</FONT><FONT COLOR="#666666">Q</FONT><FONT CLASS=S93>GVW</FONT><FONT COLOR="#666666">SNGNE-----------RI</FONT><FONT CLASS=S93>QVA</FONT><FONT COLOR="#666666">IKCLCRERMQS-NPMEFLKEAAIMHSIEHEN</FONT><FONT CLASS=S93>IVR</FONT><FONT COLOR="#666666">LY</FONT><FONT CLASS=S93>GVV</FONT> 
  3 ITK_HUMAN  32.9%  <FONT COLOR="#666666">LT</FONT><FONT CLASS=S93>FVQ</FONT><FONT COLOR="#666666">EIGSGQFG</FONT><FONT CLASS=S93>LVH</FONT><FONT COLOR="#666666">LGYWLN--------------KD</FONT><FONT CLASS=S93>KVA</FONT><FONT COLOR="#666666">IKTIREGAMS---EEDFIEEA</FONT><FONT CLASS=S93>EVM</FONT><FONT COLOR="#666666">MKLSHPK</FONT><FONT CLASS=S93>LVQ</FONT><FONT COLOR="#666666">LY</FONT><FONT CLASS=S93>GVC</FONT> 
  4 GCTK2ID    21.2%  <FONT COLOR="#666666">IR</FONT><FONT CLASS=S93>EVK</FONT><FONT COLOR="#666666">QI</FONT><FONT CLASS=S93>GVG</FONT><FONT COLOR="#666666">QFG</FONT><FONT CLASS=S93>AVVL</FONT><FONT COLOR="#666666">AEMTGLS-XLPKGSMNAD</FONT><FONT CLASS=S93>GVALVAVK</FONT><FONT COLOR="#666666">KLKP</FONT><FONT CLASS=S93>DVS</FONT><FONT COLOR="#666666">D-</FONT><FONT CLASS=S93>EVL</FONT><FONT COLOR="#666666">QSFDKEIKFMSQLQHDS</FONT><FONT CLASS=S93>IVQ</FONT><FONT COLOR="#666666">LLAIC</FONT> 
  5 CEC55C3    31.5%  <FONT COLOR="#666666">VELTKKLGEGAFG</FONT><FONT CLASS=S93>EVW</FONT><FONT COLOR="#666666">KGKLLKILDA-------NHQ</FONT><FONT CLASS=S93>PVLVAVK</FONT><FONT COLOR="#666666">TAKLESMTKEQIKEIMREARLMRNLDHI</FONT><FONT CLASS=S93>NVVK</FONT><FONT COLOR="#666666">FF</FONT><FONT CLASS=S93>GVA</FONT> 
  </PRE>

where overlapping instances of the pattern merge together.

\5. Multiple alternative patterns are allowed, separated by ``|`` characters::

   mview ... -find 'VAIK|VAVK|[LI]G.G|[DKER]E[AI]..M|[VIL]V[QR]L'

.. raw:: html

  <PRE>
  1 EGFR      100.0%  <FONT COLOR="#666666">FKKIKV</FONT><FONT CLASS=S93>LGSG</FONT><FONT COLOR="#666666">AFGTVYKGLWIPEGEK---------VKIP</FONT><FONT CLASS=S93>VAIK</FONT><FONT COLOR="#666666">ELREATSPK-ANKEIL</FONT><FONT CLASS=S93>DEAYVM</FONT><FONT COLOR="#666666">ASVDNPHVCRLLGIC</FONT> 
  2 DMDPR2     35.7%  <FONT COLOR="#666666">ISVNKQ</FONT><FONT CLASS=S93>LGTG</FONT><FONT COLOR="#666666">EFGIVQQGVWSNGNE-----------RIQ</FONT><FONT CLASS=S93>VAIK</FONT><FONT COLOR="#666666">CLCRERMQS-NPMEFL</FONT><FONT CLASS=S93>KEAAIM</FONT><FONT COLOR="#666666">HSIEHEN</FONT><FONT CLASS=S93>IVRL</FONT><FONT COLOR="#666666">YGVV</FONT> 
  3 ITK_HUMAN  32.9%  <FONT COLOR="#666666">LTFVQE</FONT><FONT CLASS=S93>IGSG</FONT><FONT COLOR="#666666">QFGLVHLGYWLN--------------KDK</FONT><FONT CLASS=S93>VAIK</FONT><FONT COLOR="#666666">TIREGAMS---EEDFI</FONT><FONT CLASS=S93>EEAEVM</FONT><FONT COLOR="#666666">MKLSHPK</FONT><FONT CLASS=S93>LVQL</FONT><FONT COLOR="#666666">YGVC</FONT> 
  4 GCTK2ID    21.2%  <FONT COLOR="#666666">IREVKQ</FONT><FONT CLASS=S93>IGVG</FONT><FONT COLOR="#666666">QFGAVVLAEMTGLS-XLPKGSMNADGVAL</FONT><FONT CLASS=S93>VAVK</FONT><FONT COLOR="#666666">KLKPDVSD-EVLQSFD</FONT><FONT CLASS=S93>KEIKFM</FONT><FONT COLOR="#666666">SQLQHDS</FONT><FONT CLASS=S93>IVQL</FONT><FONT COLOR="#666666">LAIC</FONT> 
  5 CEC55C3    31.5%  <FONT COLOR="#666666">VELTKK</FONT><FONT CLASS=S93>LGEG</FONT><FONT COLOR="#666666">AFGEVWKGKLLKILDA-------NHQPVL</FONT><FONT CLASS=S93>VAVK</FONT><FONT COLOR="#666666">TAKLESMTKEQIKEIM</FONT><FONT CLASS=S93>REARLM</FONT><FONT COLOR="#666666">RNLDHINVVKFFGVA</FONT> 
  </PRE>

\6. Alternative patterns can be given different colours by changing the
delimiter from a ``|`` to a ``:`` character::

   mview ... -find 'VAIK:VAVK:[LI]G.G:[DKER]E[AI]..M:[VIL]V[QR]L'

.. raw:: html

  <PRE>
  1 EGFR      100.0%  <FONT COLOR="#666666">FKKIKV</FONT><FONT CLASS=S95>LGSG</FONT><FONT COLOR="#666666">AFGTVYKGLWIPEGEK---------VKIP</FONT><FONT CLASS=S93>VAIK</FONT><FONT COLOR="#666666">ELREATSPK-ANKEIL</FONT><FONT CLASS=S96>DEAYVM</FONT><FONT COLOR="#666666">ASVDNPHVCRLLGIC</FONT> 
  2 DMDPR2     35.7%  <FONT COLOR="#666666">ISVNKQ</FONT><FONT CLASS=S95>LGTG</FONT><FONT COLOR="#666666">EFGIVQQGVWSNGNE-----------RIQ</FONT><FONT CLASS=S93>VAIK</FONT><FONT COLOR="#666666">CLCRERMQS-NPMEFL</FONT><FONT CLASS=S96>KEAAIM</FONT><FONT COLOR="#666666">HSIEHEN</FONT><FONT CLASS=S97>IVRL</FONT><FONT COLOR="#666666">YGVV</FONT> 
  3 ITK_HUMAN  32.9%  <FONT COLOR="#666666">LTFVQE</FONT><FONT CLASS=S95>IGSG</FONT><FONT COLOR="#666666">QFGLVHLGYWLN--------------KDK</FONT><FONT CLASS=S93>VAIK</FONT><FONT COLOR="#666666">TIREGAMS---EEDFI</FONT><FONT CLASS=S96>EEAEVM</FONT><FONT COLOR="#666666">MKLSHPK</FONT><FONT CLASS=S97>LVQL</FONT><FONT COLOR="#666666">YGVC</FONT> 
  4 GCTK2ID    21.2%  <FONT COLOR="#666666">IREVKQ</FONT><FONT CLASS=S95>IGVG</FONT><FONT COLOR="#666666">QFGAVVLAEMTGLS-XLPKGSMNADGVAL</FONT><FONT CLASS=S94>VAVK</FONT><FONT COLOR="#666666">KLKPDVSD-EVLQSFD</FONT><FONT CLASS=S96>KEIKFM</FONT><FONT COLOR="#666666">SQLQHDS</FONT><FONT CLASS=S97>IVQL</FONT><FONT COLOR="#666666">LAIC</FONT> 
  5 CEC55C3    31.5%  <FONT COLOR="#666666">VELTKK</FONT><FONT CLASS=S95>LGEG</FONT><FONT COLOR="#666666">AFGEVWKGKLLKILDA-------NHQPVL</FONT><FONT CLASS=S94>VAVK</FONT><FONT COLOR="#666666">TAKLESMTKEQIKEIM</FONT><FONT CLASS=S96>REARLM</FONT><FONT COLOR="#666666">RNLDHINVVKFFGVA</FONT> 
  </PRE>

and ``|`` and ``:`` delimiters may be combined so that patterns joined by ``|``
still form a single discrete pattern and will have one colour.

If you specify more patterns than the number of colours available
(currently 20) the colours are simply cycled.

.. _ref_palettes:

Colours
-------

Colour palettes
^^^^^^^^^^^^^^^

There are default colour palettes for protein and nucleotide (either DNA or
RNA) alignments and consensus lines. MView starts up with the default protein
palettes selected, as if you had specified a molecule type with ``-moltype aa``
(for "amino acid").

**Alignments**

Palettes have names, e.g., the default protein alignment palette is called
``P1`` and the default nucleotide palette is ``D1``. Alternative alignment
colouring palettes are explicitly selected using the ``-colormap`` option. For
example, another built-in colouring scheme can be specified with ``-colormap
CLUSTAL``.

Here is the default palette for proteins:

.. raw:: html

  <PRE>
  <FONT COLOR="#000000">[P1]</FONT>
  <FONT COLOR="#aa6666">#Protein: highlight amino acid physicochemical properties
  #symbols =>  color                #comment</FONT>
  <FONT COLOR="#666666">*      </FONT>  ->  <FONT COLOR="#666666">dark-gray           </FONT> <FONT COLOR="#aa6666">#mismatch</FONT>
  <FONT COLOR="#999999">?      </FONT>  ->  <FONT COLOR="#999999">light-gray          </FONT> <FONT COLOR="#aa6666">#unknown</FONT>
  <FONT COLOR="#33cc00">Aa     </FONT>  =>  <FONT COLOR="#33cc00">bright-green        </FONT> <FONT COLOR="#aa6666">#hydrophobic</FONT>
  <FONT COLOR="#666666">Bb     </FONT>  =>  <FONT COLOR="#666666">dark-gray           </FONT> <FONT COLOR="#aa6666">#D or N</FONT>
  <FONT COLOR="#ffff00">Cc     </FONT>  =>  <FONT COLOR="#ffff00">yellow              </FONT> <FONT COLOR="#aa6666">#cysteine</FONT>
  <FONT COLOR="#0033ff">Dd     </FONT>  =>  <FONT COLOR="#0033ff">bright-blue         </FONT> <FONT COLOR="#aa6666">#negative charge</FONT>
  <FONT COLOR="#0033ff">Ee     </FONT>  =>  <FONT COLOR="#0033ff">bright-blue         </FONT> <FONT COLOR="#aa6666">#negative charge</FONT>
  <FONT COLOR="#009900">Ff     </FONT>  =>  <FONT COLOR="#009900">dark-green          </FONT> <FONT COLOR="#aa6666">#large hydrophobic</FONT>
  <FONT COLOR="#33cc00">Gg     </FONT>  =>  <FONT COLOR="#33cc00">bright-green        </FONT> <FONT COLOR="#aa6666">#hydrophobic</FONT>
  <FONT COLOR="#009900">Hh     </FONT>  =>  <FONT COLOR="#009900">dark-green          </FONT> <FONT COLOR="#aa6666">#large hydrophobic</FONT>
  <FONT COLOR="#33cc00">Ii     </FONT>  =>  <FONT COLOR="#33cc00">bright-green        </FONT> <FONT COLOR="#aa6666">#hydrophobic</FONT>
  <FONT COLOR="#cc0000">Kk     </FONT>  =>  <FONT COLOR="#cc0000">bright-red          </FONT> <FONT COLOR="#aa6666">#positive charge</FONT>
  <FONT COLOR="#33cc00">Ll     </FONT>  =>  <FONT COLOR="#33cc00">bright-green        </FONT> <FONT COLOR="#aa6666">#hydrophobic</FONT>
  <FONT COLOR="#33cc00">Mm     </FONT>  =>  <FONT COLOR="#33cc00">bright-green        </FONT> <FONT COLOR="#aa6666">#hydrophobic</FONT>
  <FONT COLOR="#6600cc">Nn     </FONT>  =>  <FONT COLOR="#6600cc">purple              </FONT> <FONT COLOR="#aa6666">#polar</FONT>
  <FONT COLOR="#33cc00">Pp     </FONT>  =>  <FONT COLOR="#33cc00">bright-green        </FONT> <FONT COLOR="#aa6666">#hydrophobic</FONT>
  <FONT COLOR="#6600cc">Qq     </FONT>  =>  <FONT COLOR="#6600cc">purple              </FONT> <FONT COLOR="#aa6666">#polar</FONT>
  <FONT COLOR="#cc0000">Rr     </FONT>  =>  <FONT COLOR="#cc0000">bright-red          </FONT> <FONT COLOR="#aa6666">#positive charge</FONT>
  <FONT COLOR="#0099ff">Ss     </FONT>  =>  <FONT COLOR="#0099ff">dull-blue           </FONT> <FONT COLOR="#aa6666">#small alcohol</FONT>
  <FONT COLOR="#0099ff">Tt     </FONT>  =>  <FONT COLOR="#0099ff">dull-blue           </FONT> <FONT COLOR="#aa6666">#small alcohol</FONT>
  <FONT COLOR="#33cc00">Vv     </FONT>  =>  <FONT COLOR="#33cc00">bright-green        </FONT> <FONT COLOR="#aa6666">#hydrophobic</FONT>
  <FONT COLOR="#009900">Ww     </FONT>  =>  <FONT COLOR="#009900">dark-green          </FONT> <FONT COLOR="#aa6666">#large hydrophobic</FONT>
  <FONT COLOR="#666666">Xx     </FONT>  ->  <FONT COLOR="#666666">dark-gray           </FONT> <FONT COLOR="#aa6666">#any</FONT>
  <FONT COLOR="#009900">Yy     </FONT>  =>  <FONT COLOR="#009900">dark-green          </FONT> <FONT COLOR="#aa6666">#large hydrophobic</FONT>
  <FONT COLOR="#666666">Zz     </FONT>  =>  <FONT COLOR="#666666">dark-gray           </FONT> <FONT COLOR="#aa6666">#E or Q</FONT>
  </PRE>

The default alignment palette for nucleotide sequences can be selected using
the ``-moltype na`` (or ``dna`` or ``rna``) option::

  mview ... -moltype na ...

or by specifying::

  mview ... -colormap D1 ...

and is defined as:

.. raw:: html

  <PRE>
  <FONT COLOR="#000000">[D1]</FONT>
  <FONT COLOR="#aa6666">#DNA: highlight nucleotide types
  #symbols =>  color                #comment</FONT>
  <FONT COLOR="#666666">*      </FONT>  ->  <FONT COLOR="#666666">dark-gray           </FONT> <FONT COLOR="#aa6666">#mismatch</FONT>
  <FONT COLOR="#999999">?      </FONT>  ->  <FONT COLOR="#999999">light-gray          </FONT> <FONT COLOR="#aa6666">#unknown</FONT>
  <FONT COLOR="#0033ff">Aa     </FONT>  =>  <FONT COLOR="#0033ff">bright-blue         </FONT> <FONT COLOR="#aa6666">#purine</FONT>
  <FONT COLOR="#666666">Bb     </FONT>  =>  <FONT COLOR="#666666">dark-gray           </FONT> <FONT COLOR="#aa6666">#C or G or T; not A</FONT>
  <FONT COLOR="#0099ff">Cc     </FONT>  =>  <FONT COLOR="#0099ff">dull-blue           </FONT> <FONT COLOR="#aa6666">#pyrimidine</FONT>
  <FONT COLOR="#666666">Dd     </FONT>  =>  <FONT COLOR="#666666">dark-gray           </FONT> <FONT COLOR="#aa6666">#A or G or T; not C</FONT>
  <FONT COLOR="#0033ff">Gg     </FONT>  =>  <FONT COLOR="#0033ff">bright-blue         </FONT> <FONT COLOR="#aa6666">#purine</FONT>
  <FONT COLOR="#666666">Hh     </FONT>  =>  <FONT COLOR="#666666">dark-gray           </FONT> <FONT COLOR="#aa6666">#A or C or T; not G</FONT>
  <FONT COLOR="#666666">Kk     </FONT>  =>  <FONT COLOR="#666666">dark-gray           </FONT> <FONT COLOR="#aa6666">#G or T</FONT>
  <FONT COLOR="#666666">Mm     </FONT>  =>  <FONT COLOR="#666666">dark-gray           </FONT> <FONT COLOR="#aa6666">#A or C</FONT>
  <FONT COLOR="#666666">Nn     </FONT>  =>  <FONT COLOR="#666666">dark-gray           </FONT> <FONT COLOR="#aa6666">#A or C or G or T</FONT>
  <FONT COLOR="#666666">Rr     </FONT>  =>  <FONT COLOR="#666666">dark-gray           </FONT> <FONT COLOR="#aa6666">#A or G</FONT>
  <FONT COLOR="#666666">Ss     </FONT>  =>  <FONT COLOR="#666666">dark-gray           </FONT> <FONT COLOR="#aa6666">#C or G</FONT>
  <FONT COLOR="#0099ff">Tt     </FONT>  =>  <FONT COLOR="#0099ff">dull-blue           </FONT> <FONT COLOR="#aa6666">#pyrimidine</FONT>
  <FONT COLOR="#0099ff">Uu     </FONT>  =>  <FONT COLOR="#0099ff">dull-blue           </FONT> <FONT COLOR="#aa6666">#pyrimidine</FONT>
  <FONT COLOR="#666666">Vv     </FONT>  =>  <FONT COLOR="#666666">dark-gray           </FONT> <FONT COLOR="#aa6666">#A or C or G; not T</FONT>
  <FONT COLOR="#666666">Ww     </FONT>  =>  <FONT COLOR="#666666">dark-gray           </FONT> <FONT COLOR="#aa6666">#A or T</FONT>
  <FONT COLOR="#666666">Xx     </FONT>  ->  <FONT COLOR="#666666">dark-gray           </FONT> <FONT COLOR="#aa6666">#any</FONT>
  <FONT COLOR="#666666">Yy     </FONT>  =>  <FONT COLOR="#666666">dark-gray           </FONT> <FONT COLOR="#aa6666">#C or T</FONT>
  </PRE>


**Consensus lines**

In addition, the consensus lines optionally displayed below an alignment can
be coloured, and they have their own consensus palettes; the default for
proteins is ``PC1`` and for nucleotides it is ``DC1``. Alternative consensus
colouring palettes are explicitly selected using the ``-con_colormap`` option.

Here is the default consensus palette for proteins:

.. raw:: html

  <PRE>
  <FONT COLOR="#000000">[PC1]</FONT>
  <FONT COLOR="#aa6666">#Protein consensus: highlight equivalence class
  #symbols =>  color                #comment</FONT>
  <FONT COLOR="#666666">*      </FONT>  ->  <FONT COLOR="#666666">dark-gray           </FONT> <FONT COLOR="#aa6666">#mismatch</FONT>
  <FONT COLOR="#cc0000">+      </FONT>  ->  <FONT COLOR="#cc0000">bright-red          </FONT> <FONT COLOR="#aa6666">#positive charge</FONT>
  <FONT COLOR="#0033ff">-      </FONT>  ->  <FONT COLOR="#0033ff">bright-blue         </FONT> <FONT COLOR="#aa6666">#negative charge</FONT>
  <FONT COLOR="#009900">a      </FONT>  ->  <FONT COLOR="#009900">dark-green          </FONT> <FONT COLOR="#aa6666">#aromatic</FONT>
  <FONT COLOR="#6600cc">c      </FONT>  ->  <FONT COLOR="#6600cc">purple              </FONT> <FONT COLOR="#aa6666">#charged</FONT>
  <FONT COLOR="#33cc00">h      </FONT>  ->  <FONT COLOR="#33cc00">bright-green        </FONT> <FONT COLOR="#aa6666">#hydrophobic</FONT>
  <FONT COLOR="#33cc00">l      </FONT>  ->  <FONT COLOR="#33cc00">bright-green        </FONT> <FONT COLOR="#aa6666">#aliphatic</FONT>
  <FONT COLOR="#0099ff">o      </FONT>  ->  <FONT COLOR="#0099ff">dull-blue           </FONT> <FONT COLOR="#aa6666">#alcohol</FONT>
  <FONT COLOR="#0099ff">p      </FONT>  ->  <FONT COLOR="#0099ff">dull-blue           </FONT> <FONT COLOR="#aa6666">#polar</FONT>
  <FONT COLOR="#33cc00">s      </FONT>  ->  <FONT COLOR="#33cc00">bright-green        </FONT> <FONT COLOR="#aa6666">#small</FONT>
  <FONT COLOR="#33cc00">t      </FONT>  ->  <FONT COLOR="#33cc00">bright-green        </FONT> <FONT COLOR="#aa6666">#turnlike</FONT>
  <FONT COLOR="#33cc00">u      </FONT>  ->  <FONT COLOR="#33cc00">bright-green        </FONT> <FONT COLOR="#aa6666">#tiny</FONT>
  </PRE>

The default consensus palette for nucleotide sequences can be selected using
the ``-moltype na`` (or ``dna`` or ``rna``) option::

  mview ... -moltype na ...

or by specifying::

  mview ... -con_colormap DC1 ...

and is defined as:

.. raw:: html

  <PRE>
  <FONT COLOR="#000000">[DC1]</FONT>
  <FONT COLOR="#aa6666">#DNA consensus: highlight ring type
  #symbols =>  color                #comment</FONT>
  <FONT COLOR="#666666">*      </FONT>  ->  <FONT COLOR="#666666">dark-gray           </FONT> <FONT COLOR="#aa6666">#mismatch</FONT>
  <FONT COLOR="#6600cc">r      </FONT>  ->  <FONT COLOR="#6600cc">purple              </FONT> <FONT COLOR="#aa6666">#purine</FONT>
  <FONT COLOR="#ff3333">y      </FONT>  ->  <FONT COLOR="#ff3333">orange              </FONT> <FONT COLOR="#aa6666">#pyrimidine</FONT>
  </PRE>


Creating new palettes
^^^^^^^^^^^^^^^^^^^^^

The built-in palettes can be listed from the command line with
``-listcolors``, and new colour schemes can be loaded from a file using the
``-colorfile`` option.

Predefined colours are defined as in the following short segment of the built
in palette obtained with ``-listcolors -html head`` to wrap the output in
HTML and display the actual colours:

.. raw:: html

  <PRE>
  <FONT COLOR="#aa6666">#color                     : #RGB</FONT> 
  color <FONT COLOR="#000000">black               </FONT> : #000000
  color <FONT COLOR="#ffffff">white               </FONT> : #ffffff
  color <FONT COLOR="#ff0000">red                 </FONT> : #ff0000
  color <FONT COLOR="#00ff00">green               </FONT> : #00ff00
  color <FONT COLOR="#0000ff">blue                </FONT> : #0000ff
  color <FONT COLOR="#00ffff">cyan                </FONT> : #00ffff
  color <FONT COLOR="#ff00ff">magenta             </FONT> : #ff00ff
  color <FONT COLOR="#ffff00">yellow              </FONT> : #ffff00    
  ...
  </PRE>

Here's an example of a short protein colouring scheme using the built-in
palette, which is used to explain the syntax:

.. raw:: html

  <PRE>
  <FONT COLOR="#000000">[CYS]</FONT>
  <FONT COLOR="#aa6666">#Protein: highlight cysteines
  #symbols =>  color                #comment</FONT>
  <FONT COLOR="#666666">*      </FONT>  ->  <FONT COLOR="#666666">dark-gray           </FONT> <FONT COLOR="#aa6666">#mismatch</FONT>
  <FONT COLOR="#999999">?      </FONT>  ->  <FONT COLOR="#999999">light-gray          </FONT> <FONT COLOR="#aa6666">#unknown</FONT>
  <FONT COLOR="#ffff00">Cc     </FONT>  =>  <FONT COLOR="#ffff00">yellow              </FONT> <FONT COLOR="#aa6666">#cysteine</FONT>
  <FONT COLOR="#666666">Xx     </FONT>  ->  <FONT COLOR="#666666">dark-gray           </FONT> <FONT COLOR="#aa6666">#any</FONT>
  </PRE>

When writing a new protein/nucleotide colouring scheme, scheme names
introduced in square brackets (``[CYS]``, above) are case-insensitive.

Any line or part of a line beginning with a ``#`` character is a comment.

Symbols to be coloured are case-sensitive and may be given as a single
character or as a character pair in each definition. In the example, ``*`` and
``?`` will be displayed in some shade of grey. Either ``X`` or ``x`` will be
painted a grey, and ``C`` or ``c`` will be painted yellow.

A symbol to name mapping can use a predefined colour name (as above) or an
explicit hexadecimal RGB code like those in the colour palette.

The arrow separating the symbol(s) from the colour code can be double ``=>``
or single ``->`` arrows selecting background or foreground colouring:

* If style sheets are not being used, the choice of arrow is unimportant: the
  supplied colour is used for the foreground, i.e., the output symbol.

* If style sheets are in use with ``-css on``, then ``=>`` means that the
  colour should be applied to the background of the symbol, while ``->`` means
  it should be aplied to the foreground, i.e., the symbol itself.

So, in the ``CYS`` example, the symbols ``*``, ``?``, ``X``, ``x`` will be
coloured in the foreground (i.e., the symbols themselves), and ``C`` or ``c``
will be displayed as coloured symbols unless ``-css on`` is set, in which case
they will appear as coloured bocks.


Layout and filtering
--------------------


Pagination
^^^^^^^^^^

The default layout is a single unbroken horizontal band of alignment - fine if
scrolling inside Firefox. However, you may prefer to break the alignment into
vertically stacked panes. For panes, for example, 80 columns wide, set
``-width 80``. Widths refer to the alignment, not to the whole displayed
output.


Column ranges
^^^^^^^^^^^^^

It is possible to narrow (or expand) the displayed range of columns of the
alignment, for example, ``-range 10:78`` would select only that column range
using the numbering scheme reported when ``-ruler on`` is set (see
:ref:`ref_rulers`). Note: the range setting is not related to the sequence
position labelling for blast/fasta database search input; it's just the
position along the ruler.

The order of the numbers is unimportant making it simpler to state interest in
a region of the alignment that might actually be reversed in the output (e.g.,
a BLASTN search hit matching the reverse complement of the query strand).


.. _ref_filtering_rows:

Filtering rows
^^^^^^^^^^^^^^

**Showing only the top N rows**

Usually, specifying a limited number of hits to view from a long search
alignment speeds things up a lot as there's less parsing and less formatting
to be generated, so to get the best 10 hits, use the option ``-top 10``.

**Filtering by percent identity**

You also can squeeze more out of a deep alignment and get a less biased view
if a threshold on the pairwise sequence identity is set using ``-maxident N``,
where N is some value between 0 and 100.

Similarly, ``-minident N`` will report only those hits above some threshold
percent identity; useful for looking for close matches to the query or some
reference sequence.

**Showing and hiding sets of rows**

Rows can be dropped explicitly using the ``-hide`` option. This can be
supplied a comma-separated list of row identifiers, rank numbers, rank number
ranges (1,2,3, 1..3, 1:3 are all equivalent), regular expressions (case
insensitive, enclosed between // characters) to match against row identifiers,
or the ``*`` symbol meaning all rows.

Likewise, the ``-show`` option specifies a list of rows to keep in the
alignment. The ``-show`` option overrides ``-hide`` whenever a row is common
to both.

For example, the options::

  -hide all  -show '2,3,6..10,/^pdb/'

or even::

  -hide '/.*/'  -show '2,3,6:10,/^pdb/'

would hide everything except rows 2, 3, 6 through 10 inclusive, and any hits
beginning with the string 'pdb'.

Note: the currently set reference row is still used for percent identity and
colouring operations, even though the row may have been dropped from display
by the ``-hide`` list (see :ref:`ref_reference_row`).

**Data format specific filters**
 
Other filters specific to BLASTP, FASTA, etc., input formats allow cutoffs on
scores or p-values, etc. In particular, it is possible to apply some control
over the selection of HSPs used in building the MView alignment using the
``-hsp`` filtering option.

Some search programs produce DNA strand-directional output (e.g., BLASTN) and
you can extract or output the results separately. For example, to see just the
plus strand matches::

  mview -in blast -strand p blastn_results.dat 

The choices are ``p``, ``m``, ``both``.

Of interest to anyone using PSI-BLAST, you can display alignments for any/all
iterations of a PSI-BLAST run using, say::

  mview -in blast -cycle 1,last psiblast_results.dat 

to get just those two iterations. The default is to display only the last
iteration. If you want all output, use ``-cycle all``.

**Keeping rows, but ignoring them in calculations**

Another control option can be used to prevent MView from using rows for
colouring or for calculation of percent identities although these rows will
still be displayed. Use ``-nop`` to specify a list (comma-separated as usual)
of identifiers or row numbers to flag for "NO Processing". This is useful for
displaying non-alignment data (e.g., secondary structure predictions)
alongside the alignment.


Labels and annotations
^^^^^^^^^^^^^^^^^^^^^^

The labelling information at the left of the alignment can be too wide, so you
can switch some of them off. Labels are in blocks numbered from zero
(perverse, but the original reasoning was that the input data starts with the
sequence identifiers in column 1 and MView tacks on a rank number in front, so
make that column 0).

 ======   ==================================================
 Column   Description
 ======   ==================================================
 0        rank
 1        identifier
 2        description
 3        score block (may contain many score columns)
 4        percent identities
 5        query sequence positions (blast or fasta searches)
 6        hit sequence positions (blast or fasta searches)
 ======   ==================================================

Any of the of the label types can be switched off with an option like
``-label2`` to remove the descriptions label at column 2, and so on.


Data formats
------------


Input formats
^^^^^^^^^^^^^

MView supports a variety of input formats covering common sequence database
seach and multiple alignment formats. Alternatively, if you can convert some
strange alignment to one of the simpler input formats (FASTA, PIR, MSF, plain)
you can then read it into MView. See `input_formats`_.

.. _input_formats: formats_in.html


Output formats
^^^^^^^^^^^^^^

The default output is plain text showing the alignment together with some
header information. HTML markup will be added if any of the HTML-specific or
colouring options are set.

However, a number of alternative output formats allow format conversions
(e.g., convert a BLAST search to FASTA sequence format) for subsequent
processing. See `output_formats`_.

.. _output_formats: formats_out.html


Linking identifiers to external resources
-----------------------------------------

If HTML markup is produced it is possible to embed links to sequence databases
in sequence identifiers if they conform to patterns such as::

        database|accession|identifier 
        database:identifier

as produced by some BLAST and FASTA servers. Such links will typically be to
EBI and NCBI servers and will only be constructed if the patterns are listed
in the SRS.pm library with this software. This library can be modified for
your site if you know some Perl syntax and can work out the structure of the
URLs needed to access the remote databases.


Memory usage
------------

Use of memory by MView can be very great, particularly if you try to process
complete sets of PSI-BLAST cycles each containing 1000s of hits all at
once. Use of most filtering options should reduce memory requirements by
cutting down the number of internal data structures created. Likewise,
processing each alignment separately will save memory or you can use the
option ``-register off`` to cause each alignment to be output when ready (by
default all alignments are saved until the end so they can be printed with
fields in register). Finally, the choice of malloc library compiled into your
perl may affect memory use.


.. END
