help/html/features/annotationsFormat.html

   1 <html>\r
   2 \r
   3 <head>\r
   4 <title>The Alignment Annotations File</title>\r
   5 </head>\r
   6 \r
   7 <body>\r
   8 <p><strong>The Alignment Annotations File</strong></p>\r
   9 <p>Alignment annotations can be imported onto an alignment since\r
  10 version 2.08 of Jalview, via an annotations file. It is a simple ASCII\r
  11 text file consisting of tab delimited records similar to the <a\r
  12         href="featuresFormat.html">Sequence Features File</a>, and introduced\r
  13 primarily for use with the Jalview applet.</p>\r
  14 <p>Alignment annotations files are imported into Jalview in the\r
  15 following ways:<br>\r
  16 <ul>\r
  17         <li>from the command line<strong><pre>\r
  18  -annotations &lt;<em>Annotations filename</em>&gt;</pre></strong></li>\r
  19         <li>Dragging an annotations file onto an alignment window</li>\r
  20         <li>Via the &quot;Load Features / Annotations&quot; entry in the <strong>File</strong>\r
  21         menu of an alignment window.</li>\r
  22 </ul>\r
  23 </p>\r
  24 <p><strong>Annotations File Format</strong></p>\r
  25 <p>The File consists of lines containing an instruction followed by\r
  26 tab delimited fields, and any lines starting with &quot;#&quot; are\r
  27 ignored. The first non-commented out line of a valid Annotations file\r
  28 must begin with :<strong><pre>JALVIEW_ANNOTATION</pre></strong></p>\r
  29 <p>A row of annotation is added with a line like <strong><pre><em>GRAPH_TYPE</em>&#9;<em>Label</em>&#9;<em>Values</em></pre></strong></p>\r
  30 <p>The <em>GRAPH_TYPE</em> field, which appears first, defines the\r
  31 appearance of the annotation row when rendered by Jalview. The next field is the row label for the annotation. The final <em>Values</em> field contains a series of &quot;|&quot;\r
  32 separated value fields. Each value field is itself a comma separated list of fields of a particular type defined by the annotation row's\r
  33 GRAPH_TYPE. The allowed values of GRAPH_TYPE and the format of their respective value fields (with the trailing &quot;<strong>|</strong>&quot; symbol) are shown below:<ul>\r
  34         <li>BAR_GRAPH<br>\r
  35         Plots a histogram with labels below each bar.<br>\r
  36         <em>number</em>,<em>text character</em></li>\r
  37         <li>LINE_GRAPH<br>\r
  38         Draws a line between values on the annotation row.<br>\r
  39         <em>number</em></li>\r
  40         <li>NO_GRAPH<br>\r
  41         For a row consisting of text labels and/or secondary structure symbols.<br>\r
  42         <em>{Secondary Structure Symbol}</em>,<em>text label</em><br>\r
  43         Currently supported secondary structure structure symbols are <em>H</em> (for   helix) and <em>E</em> (for strand)</li>\r
  44 </ul>\r
  45 Any or all value fields may be left empty, as well as the BAR_GRAPH's\r
  46 text character field, and either or both of the text-label and secondary\r
  47 structure symbol fields of the NO_GRAPH type annotation rows.\r
  48 </p>\r
  49 <p>You can associate an annotation with a sequence by preceding its\r
  50 definition with the line: \r
  51 <pre>SEQUENCE_REF&#9;<em>seq_name</em>&#9;<em>[startIndex]</em></pre>\r
  52 All Annotations defined after a SEQUENCE_REF command will then be\r
  53 associated with that sequence, and the first field in the Value field\r
  54 list will (optionally) be placed at the <em>startIndex</em>'th column.</p>\r
  55 <p>Sequence associations are turned off for subsequent annotation\r
  56 definitions by: \r
  57 <pre>SEQUENCE_REF&#9;ALIGNMENT</pre>\r
  58 </p>\r
  59 <p><em>LINE_GRAPH</em> type annotations can be given a colour\r
  60 (specified as 24 bit RGB triplet in hexadecimal or comma separated\r
  61 values), combined onto the same vertical axis, and have ordinate lines\r
  62 (horizontal lines at a particular vertical axis value) using the\r
  63 following commands (respectively): \r
  64 <pre>COLOUR&#9;<em>graph_name</em>&#9;<em>colour</em>\r
  65 COMBINE&#9;<em>graph_1_name</em>&#9;<em>graph_2_name</em>\r
  66 GRAPHLINE&#9;<em>graph_name</em>&#9;<em>value</em>&#9;<em>label</em>&#9;<em>colour</em><strong><em>\r
  67 </em></strong></pre>\r
  68 <h3><font face="Arial, Helvetica, sans-serif">(Since Jalview 2.2.1) SEQUENCE_GROUP</font></h3>\r
  69 <p>Groups of sequences can be defined using the tab delimited line</p>\r
  70 <pre>SEQUENCE_GROUP     Group_Name      Group_Start     Group_End       Sequences</pre>\r
  71 <p>The sequences can be defined by alignment index and a range of sequences can \r
  72   be defined in a comma delimited field such as</p>\r
  73 <p>2-5,8-15,20,22</p>\r
  74 <p>Enter * to select all groups. </p>\r
  75 <p>If the alignment indices are not known, enter -1 then a tab delimited list \r
  76   of sequence ids. </p>\r
  77 <p>If the SEQUENCE_REF has been defined, the group_start and group_end will be \r
  78   relative to the sequence residue numbering, otherwise the group_start and group_end \r
  79   will be the alignment column indices. </p>\r
  80 <p>The group can (optionally) be assigned various visualisation properties via \r
  81   another tab delimited line thus:</p>\r
  82 <pre>PROPERTIES Group_name      tab_delimited_key_value_pairs\r
  83 </pre>\r
  84 <p>The key_value_pairs allow you to define a description and to colour the group \r
  85   in various ways. All, none or some of the following values could be used for \r
  86   a group:</p>\r
  87 <p>description=Text <br>\r
  88   colour=Helix Propensity<br>\r
  89   pidThreshold=0<br>\r
  90   consThreshold=0<br>\r
  91   outlineColour=red <br>\r
  92   displayBoxes=true<br>\r
  93   displayText=false<br>\r
  94   colourText=false<br>\r
  95   textCol1=black<br>\r
  96   textCol2=black<br>\r
  97   textColThreshold=0</p>\r
  98 <p> </p>\r
  99 <p>An example Annotation file is given below:\r
 100 <pre>#Comment lines follow the hash symbol\r
 101 JALVIEW_ANNOTATION\r
 102 SEQUENCE_REF&#9;FER1_MESCR&#9;5\r
 103 BAR_GRAPH&#9;Bar Graph 1&#9;||-100,-|-200,-|-300,-|-400,-|200,+|300,+|150,+\r
 104 LINE_GRAPH&#9;Green Values&#9;1.1|2.2|1.3|3.4|0.7|1.4|3.3|2.2|2.1|-1.1|3.2\r
 105 LINE_GRAPH&#9;Red Values&#9;2.1|3.2|1.3|-1.4|5.5|1.4|1.3|4.2|-1.1|1.1|3.2\r
 106 BAR_GRAPH&#9;Bar Graph&#9;2 1,.|2,*|3,:|4,.|5,*|4,:|3,.|2|1|1|2|3|4|5|4\r
 107 NO_GRAPH&#9;Icons &#9;||||E,Sheet1|E|E||||H,Sheet 2|H|H|H||||||\r
 108 NO_GRAPH&#9;Purple Letters&#9;m|y|p|r|o|t|e|i|n\r
 109 COLOUR&#9;Bar Graph 2&#9;blue\r
 110 COLOUR&#9;Red Values&#9;255,0,0\r
 111 COLOUR&#9;Green Values&#9;green\r
 112 COLOUR&#9;Purple Letters&#9;151,52,228\r
 113 COMBINE&#9;Green Values&#9;Red Values\r
 114 GRAPHLINE&#9;Red Values&#9;2.6&#9;threshold&#9;black\r
 115 \r
 116 SEQUENCE_GROUP Group_A 30 50 *\r
 117 SEQUENCE_GROUP Group_B 1 351 2-5\r
 118 SEQUENCE_GROUP Group_C 12 14 -1 seq1    seq2    seq3\r
 119 PROPERTIES Group_A description=This is the description colour=Helix Propensity pidThreshold=0 outlineColour=red displayBoxes=true displayText=false     colourText=false textCol1=black textCol2=black textColThreshold=0\r
 120 PROPERTIES Group_B outlineColour=red\r
 121 PROPERTIES Group_C colour=Clustal\r
 122 </pre>\r
 123 </p>\r
 124 </body>\r
 125 </html>\r